grthtrhthjhtyjytjytkergtrhtrjytjerhrfh4:24 29/09/2026a Bjj@s`ddlmZmZddlZddlmZmZmZmZm Z m Z m Z m Z ddl mZmZddlmZGdddeZGdd d eZGd d d eZGd d d eZGdddeZeZGdddeZGdddeZddZddZddZddZd7ddZ dd Z!d!d"Z"d#d$Z#d%d&Z$d'd(Z%d)d*Z&d+d,Z'd-d.Z(d/d0Z)d1d2Z*d3d4Z+d5d6Z,dS)8)divisionprint_functionN)rle_lenrle_append_modifyrle_join_modify rle_product calc_width calc_text_posapply_target_encodingtrim_text_attr_cs) trim_line LayoutSegment)bytesc@sxeZdZdZiZiZiZdZdZdZ ddZ e e Z ddZ e e Z ddZ e e Z d d Ze eZd d Ze eZd S) CanvasCachea` Cache for rendered canvases. Automatically populated and accessed by Widget render() MetaClass magic, cleared by Widget._invalidate(). Stores weakrefs to the canvas objects, so an external class must maintain a reference for this cache to be effective. At present the Screen classes store the last topmost canvas after redrawing the screen, keeping the canvases from being garbage collected. _widgets[widget] = {(wcls, size, focus): weakref.ref(canvas), ...} _refs[weakref.ref(canvas)] = (widget, wcls, size, focus) _deps[widget} = [dependent_widget, ...] rc s|js dS|j\}}}fddt|dd}|durHt|drH|}|r|D]}||jvrPdSqP|D]}|j|g|qjt ||j }||||f|j |<||j|i|||f<dS)z Store a weakref to canvas in the cache. wcls -- widget class that contains render() function canvas -- rendered canvas with widget_info (widget, size, focus) NcsLg}|jD]<\}}}}|jr.||jdq t|dr ||q |S)za Collect all child widgets for determining who we depend on. rchildren)r widget_infoappendhasattrextend)canvZdependsxycpos walk_depends2/usr/lib64/python3.9/site-packages/urwid/canvas.pyrBs z'CanvasCache.store..walk_depends depends_onr) cacheablergetattrr_widgets_deps setdefaultrweakrefrefcleanup_refs) clswclsZcanvaswidgetsizefocusrwr%rrrstore6s     zCanvasCache.storecCsZ|jd7_|j|d}|s$dS||||fd}|s>dS|}|rV|jd7_|S)z Return the cached canvas or None. widget -- widget object requested wcls -- widget class that contains render() function size, focus -- render() parameters N)fetchesr!gethits)r(r*r)r+r,sizesr%rrrrfetchaszCanvasCache.fetchc Csz@|j|D]$}z |j|=Wqty2Yq0q|j|=WntyRYn0||jvrbdS|j|g}z |j|=WntyYn0|D]}||qdS)z8 Remove all canvases cached for widget. N)r!valuesr'KeyErrorr"r1 invalidate)r(r*r%Z dependantsr-rrrr7ws$       zCanvasCache.invalidatecCs|jd7_|j|d}|j|=|s,dS|\}}}}|j|d}|sNdSz||||f=WntypYn0|sz|j|=|j|=WntyYn0dSNr/)cleanupsr'r1r!r6r")r(r%r-r*r)r+r,r3rrrr&s&    zCanvasCache.cleanupcCsi|_i|_i|_dS)z" Empty the cache. N)r!r'r")r(rrrclearszCanvasCache.clearN)__name__ __module__ __qualname____doc__r!r'r"r2r0r9r. classmethodr4r7r&r:rrrrrs")rc@s eZdZdS) CanvasErrorNr;r<r=rrrrr@sr@c@seZdZdZdZedZedZedZd$ddZ d d Z d d Z e e Z d%d dZddZe eeZe eeZe eeZd&ddZddZddZddZddZddZe eeZddZd d!Zd"d#ZdS)'Canvasz! base class for canvases TzdThis canvas has been finalized. Use CompositeCanvas to wrap this canvas if you need to make changes.zcThe old Canvas class is now called TextCanvas. Canvas is now the base class for all canvas classes.zThe internal representation of canvases is no longer stored as .text, .attr, and .cs lists, please see the TextCanvas class for the new representation of canvas content.NcCs$|dur|jd|_i|_i|_dS)z value1, value2, value3 -- if not None, raise a helpful error: the old Canvas class is now called TextCanvas. N)_renamed_error _widget_infocoords shortcuts)selfZvalue1Zvalue2Zvalue3rrr__init__s zCanvas.__init__cCs|jr |j|||f|_dS)a Mark this canvas as finalized (should not be any future changes to its content). This is required before caching the canvas. This happens automatically after a widget's 'render call returns the canvas thanks to some metaclass magic. widget -- widget that rendered this canvas size -- size parameter passed to widget's render method focus -- focus parameter passed to widget's render method N)r_finalized_errorrD)rGr*r+r,rrrfinalizes zCanvas.finalizecCs|jSN)rDrGrrr_get_widget_infoszCanvas._get_widget_infocCs |jdSrK)_old_repr_error)rGvalrrr_raise_old_repr_errorszCanvas._raise_old_repr_errorcCsdd|DS)zg Return the text content of the canvas as a list of strings, one for each row. cSs"g|]}tdd|DqS)cSsg|]\}}}|qSrr).0attrcstextrrr z3Canvas._text_content...)rjoin)rQrowrrrrUsz(Canvas._text_content..)contentrLrrr _text_contentszCanvas._text_contentrcCs tdSrKNotImplementedError)rG trim_lefttrim_topcolsrowsrRrrrrYszCanvas.contentcCs tdSrKr[rLrrrr_sz Canvas.colscCs tdSrKr[rLrrrr`sz Canvas.rowscCs tdSrKr[rLrrr content_deltaszCanvas.content_deltacCs"|jdd}|sdS|ddS)NcursorrEr1rGrrrr get_cursorszCanvas.get_cursorcCsP|jr|jr|j|dur>z |jd=Wnty8Yn0dS|d|jd<dS)NrbrK)rrrIrEr6rerrr set_cursors   zCanvas.set_cursorcCs|jdd}|sdS|S)Npop uprdrerrr get_pop_upszCanvas.get_pop_upcCs,|jr|jr|j|||||ff|jd<dS)a This method adds pop-up information to the canvas. This information is intercepted by a PopUpTarget widget higher in the chain to display a pop-up at the given (left, top) position relative to the current canvas. :param w: widget to use for the pop-up :type w: widget :param left: x position for left edge of pop-up >= 0 :type left: int :param top: y position for top edge of pop-up >= 0 :type top: int :param overlay_width: width of overlay in screen columns > 0 :type overlay_width: int :param overlay_height: height of overlay in screen rows > 0 :type overlay_height: int rhN)rrrIrE)rGr-lefttopZ overlay_widthZoverlay_heightrrr set_pop_ups  zCanvas.set_pop_upcCs8i}|jD]$\}\}}}|||||f||<q|S)z4 Return coords shifted by (dx, dy). )rEitems)rGdxdydnamerrdatarrrtranslate_coords.szCanvas.translate_coords)NNN)N)rrNNN)r;r<r=r>rr@rIrCrNrHrJrMpropertyrrPrZrTrRrSrYr_r`rarfrgrbrirlrsrrrrrBs4       rBc@sDeZdZdZdddZddZdd Zd d Zdd dZddZ dS) TextCanvasz8 class for storing rendered text and attributes NTc Cst||dkrg}|rZg}|D]4}t|tkr@tdt||t|dt|q"n|gt|}|dur|r~t |}nd}|dkrddt t|D}|dkrddt t|D}t t|D]} || } | |krtd|||f| |kr|| t || || <t|| t || } | dkrPtd|| || f| rht || d| ft|| t || } | dkrtd || || f| rt || d| fq||_||_||_||_||_dS) a[ text -- list of strings, one for each line attr -- list of run length encoded attributes for text cs -- list of run length encoded character set for text cursor -- (x,y) of cursor or None maxcol -- screen columns taken by this canvas check_width -- check and fix width of all lines in text NzBCanvas text must be plain strings encoded in the screen's encodingrcSsg|]}gqSrrrQrrrrrU]rVz'TextCanvas.__init__..cSsg|]}gqSrrrvrrrrU_rVz8Canvas text is wider than the maxcol specified %r %r %rz$Attribute extends beyond text %r %rz(Character Set extends beyond text %r %r)rBrHtyperr@reprrrlenmaxrangerjustrr_attr_csrb_text_maxcol) rGrTrRrSrbmaxcolZ check_widthZwidthstir-Za_gapZcs_gaprrrrH=sN      zTextCanvas.__init__cCst|j}|S)z)Return the number of rows in this canvas.)ryr)rGr`rrrr`zs zTextCanvas.rowscCs|jS)z.Return the screen column width of this canvas.)rrLrrrr_szTextCanvas.colscCs$|jr |j\}}||||fSdS)zb Return cursor coords shifted by (dx, dy), or None if there is no cursor. N)rb)rGrnrorrrrrtranslated_coordss zTextCanvas.translated_coordsrc cs||}}|s||}|s*||}|s6||krnt|j||||j||||j|||}nt|j|j|j}|D]\} } } |s||jkrt| | | |||\} } } t| | } d} g}| D]D\\}}}|r||vr||}| ||| | | |f| |7} q|VqdS)z Return the canvas content as a list of rows where each row is a list of (attr, cs, text) tuples. trim_left, trim_top, cols, rows may be set by CompositeCanvas when rendering a partially obscured canvas. rN) r_r`ziprr}r~rr rr)rGr]r^r_r`attr_maprmaxrowZ text_attr_csrTZa_rowZcs_rowZattr_csrrXarSrunrrrrYs6      zTextCanvas.contentcCs"||ur|g|S|S)z Return the differences between other and this canvas. If other is the same object as self this will return no differences, otherwise this is the same as calling content(). r_r`rYrGotherrrrraszTextCanvas.content_delta)NNNNNT)rrNNN) r;r<r=r>rHr`r_rrYrarrrrru9s =  -ruc@s8eZdZdZddZddZddZdd Zd d Zd S) BlankCanvaszv a canvas with nothing on it, only works as part of a composite canvas since it doesn't know its own size cCst|ddSrK)rBrHrLrrrrHszBlankCanvas.__init__c csDd}|rd|vr|d}|dt|fg}t|D] }|Vq4dS)zH return (cols, rows) of spaces with default attributes. N)rr|r{ rGr]r^r_r`rRZdef_attrlinerrrrrYs   zBlankCanvas.contentcCs tddSNz&BlankCanvas doesn't know its own size!r[rLrrrr_szBlankCanvas.colscCs tddSrr[rLrrrr`szBlankCanvas.rowscCs tddSrr[rLrrrraszBlankCanvas.content_deltaN) r;r<r=r>rHrYr_r`rarrrrrs  rc@s:eZdZdZddZddZddZdd d Zd d Zd S) SolidCanvasz= A canvas filled completely with a single character. cCsXt|t|dt|d\}}t|d|\|_}|dd|_||f|_d|_dSNrr/) rBrHr ryr rr~r+rb)rGZ fill_charr_r`endcolrSrrrrHs   zSolidCanvas.__init__cCs |jdS)Nrr+rLrrrr_szSolidCanvas.colscCs |jdSr8rrLrrrr`szSolidCanvas.rowsrNc csh|dur|jd}|dur$|jd}d}|rrHr_r`rYrarrrrrs  rc@s|eZdZdZdddZddZddZd d Zd d Zdd dZ ddZ ddZ ddZ ddZ ddZddZddZdS)CompositeCanvasz5 class for storing a combination of canvases NcCst||dur g|_g|_nnt|dr4|j|_n&|dd||d|fgfg|_dd|dfg|_|j|j|j D]}d|j |<q~dS)z canv -- a Canvas object to wrap this CompositeCanvas around. if canv is a CompositeCanvas, make a copy of its contents Nshardsrwrap) rBrHrrrr`r_rEupdaterF)rGrshortcutrrrrHs     zCompositeCanvas.__init__c CsJ|jD]*\}}zWqty.t||Yq0qtdd|jD}|S)NcSsg|] \}}|qSrrrQrcvrrrrU@rVz(CompositeCanvas.rows..)rAssertionErrorsum)rGrrr`rrrr`:s zCompositeCanvas.rowscCs*|js dStdd|jddD}|S)NrcSsg|] }|dqS)rcr)rQrrrrrUGrVz(CompositeCanvas.cols..r/)rr)rGr_rrrr_DszCompositeCanvas.colsccsDg}|jD]4\}}t||}t|D]}t|Vq$t||}q dS)zz Return the canvas content as a list of rows where each row is a list of (attr, cs, text) tuples. N)r shard_bodyr{shard_body_rowshard_body_tail)rG shard_tailnum_rowscviewssbodyrrrrrYLs    zCompositeCanvas.contentccst|ds"|D] }|VqdSg}t|j|jD]X\}}t||}g}t|D].}t|dksrt|dtkrzt |}|VqRt ||}q4dS)rrNr/r) rrY shards_deltarrr{ryrwintrr)rGrrXrrrrrrrrra_s     zCompositeCanvas.content_deltacCsX|jr |j|rt|j||_|dkr.g|_n|durDt|j||_|d| |_dS)zTrim lines from the top and/or bottom of canvas. top -- number of lines to remove from top count -- number of lines to keep, or None for all the rest rN)rrIshards_trim_toprshards_trim_rowsrsrE)rGrkcountrrrtrim{s zCompositeCanvas.trimcCs&|jr |jt|j|||_dS)ziTrim lines from the bottom of the canvas. end -- number of lines to remove from the end N)rrIrrr`)rGrrrrtrim_endszCompositeCanvas.trim_endc Cs|jr |j|j}|dks"|dkrRtd| }||td| }t|||}|}|dksj|dkr|d\}}|dkrdd||dtfg|} n |dd} |dkr| dd||dtf|| fg|dd}| |d|_ ||_dS)z Pad or trim this canvas on the left and right values > 0 indicate screen columns to pad values < 0 indicate screen columns to trim rNr/) rrIrrzr_shards_trim_sidesr` blank_canvasrrsrE) rGrjrightrr]r_r`Ztop_rowsZ top_cviewsZnew_top_cviewsrrrpad_trim_left_rights.    z#CompositeCanvas.pad_trim_left_rightc Cs|jr |j|j}|dks"|dkrRtd| }||td| }||||}|dkr|dd||dtfgfg|j|_|d||_ |dkr||jur|jdd|_|j |dd||dtfgfdS)z@ Pad or trim this canvas on the top and bottom. rN) rrIrrzr`rr_rrsrEr)rGrkbottomZ orig_shardsr^r`r_rrrpad_trim_top_bottoms*   z#CompositeCanvas.pad_trim_top_bottomcCs|jr |j|}|}|||}|||}|j}g} |j} g} |rht||} t||} |rt| |} t| |} g} g} |dkrt| d|g} |dkrt| td|||g} |sg}n$|s|rt | |jg| }n|j}| || |_|j | ||dS)zOverlay other onto this canvas.rN) rrIr_r`rrrrrz shards_joinrErrs)rGrrjrkwidthZheightrrrZ top_shardsZ side_shardsZ bottom_shardsZ left_shardsZ right_shardsZ middle_shardsrrroverlaysF    zCompositeCanvas.overlaycCs|d|idS)z Apply attribute a to all areas of this canvas with default attribute currently set to None, leaving other attributes intact.N)fill_attr_apply)rGrrrr fill_attr szCompositeCanvas.fill_attrcs|jr |jg}|jD]\}}g}|D]}|ddur\||ddf|ddq&t}|fdd|dD||dd|f|ddq&|||fq||_dS)z Apply an attribute-mapping dictionary to the canvas. mapping -- dictionary of original-attribute:new-attribute items Ncs g|]\}}|||fqSr)r1)rQkvmappingrrrU$sz3CompositeCanvas.fill_attr_apply..)rrIrrdictrrm)rGrrrZoriginal_cviews new_cviewsrZcombinedrrrrs.    zCompositeCanvas.fill_attr_applycCs|jr |j||_dS)z Explicitly specify the list of widgets that this canvas depends on. If any of these widgets change this canvas will have to be updated. N)rrIr)rGZ widget_listrrr set_depends+szCompositeCanvas.set_depends)N)N)r;r<r=r>rHr`r_rYrarrrrrrrrrrrrrs "  "-rcCsdg}|D]V\}}}|r&|t|q|rPt|dtkrP|d|d|d<q||dq|S)zx Return one row, advancing the iterators in sbody. ** MODIFIES sbody by calling next() on its iterators ** rc)rnextrwrr)rrX done_rows content_itercviewrrrr7src Cs`g}d}d}|D]J\}}}|dd\}}||7}||krD||7}q|||||fd}q|S)z? Return a new shard tail that follows this shard body. rrcr)r) rrrcol_gaprrrr_r`rrrrKsrc cst|}d}}d}}|D]z\}}|dur8t|\}}||krV||7}t|\}}q8||krr||fV||7}q|t||fV||7}d}||7}qdS)zX Yield shards1 with cviews that are the same as shards2 having canv = None. Nr)iterrshard_cviews_delta) rZ other_shardsZother_shards_iterZother_num_rows other_cviewsZdoneZ other_donerrrrrr]s"   rccst|}d}d}}|D]}|dur,t|}||krJ||d7}t|}q,||krf|V||d7}q|d|dur|dd|ddkr|ddd|ddVn|V||d7}d}||d7}qdS)z NrrcrrK)rr)rrZother_cviews_iterZother_cvr_Z other_colsrrrrrus&   (  rTc Csd}g}t|}|D]\}}} } |rz t|} WntyFYqYn0| dd\} } }}}}||7}||8}|dkrtd|r|r|| | |||}n|}|d|| fq ||| | fq|D]P} | dd\} } }}}}|r|r|| | |||}n|}|d|| fq|S)a^ Return a list of (done_rows, content_iter, cview) tuples for this shard and shard tail. If a canvas in cviews is None (eg. when unchanged from shard_cviews_delta()) or if create_iter is False then no iterator is created for content_iter. iter_default is the value used for content_iter when no iterator is created. rNrz#cviews overflow gaps in shard_tail!)rr StopIterationr@rYr)rrZ create_iterZ iter_defaultrbodyZ cviews_iterrrrZ tail_cviewrr]r^r_r`rrZnew_iterrrrrs@        rc Cst|}g}|D]2\}}||kr$qLt||d}t||}||8}qtdt||d}t||}g}|D]$\}} } |d| t| ||fqj|}||dd|Dfg} | || S)z. Return shards with top rows removed. Fz%tried to trim shards out of existencercSsg|]\}}}|qSrr)rQrrrrrrrUrVz#shards_trim_top..)rrrr@rcview_trim_topr) rrkZ shard_iterrrrrZ new_sbodyrrr new_shardsrrrrs,         rcCsg}d}|D]\}}||kr qg}|D]4}|d||krR|t|||q(||q(|||kr~||||fn|||f||7}q |S)z8 Return the topmost keep_rows rows from shards. r)rcview_trim_rows)rZ keep_rowsrrrrrrrrrrs"    rcCsg}g}||}|D]\}}t||d}t||}g} d} |D]r\} } } | d}| |}| sl||ksl| |krr|} q>| |krt| || } |} ||krt| || } | | |} q>| s|d\}}|||f|d<q||| fq|S)zL Return shards with starting from column left and cols total width. Frrcr)rrcview_trim_leftcview_trim_colsr)rrjr_rrrrrrrrrrrZcv_colsZnext_colZ prev_num_rowsZ prev_cviewsrrrrs4     rc Csdd|D}dd|D}g}g}tdd|D}g}|D](\}}|rT|||||dfq>|}|||fz8tt|D]&} || ddkrqt|| || <qWq tyYqYq 0q |S)zx Return the result of joining shard lists horizontally. All shards lists must have the same number of rows. cSsg|] }t|qSr)r)rQslrrrrU#rVzshards_join..cSsg|] }t|qSr)r)rQrrrrrU$rVcSsg|] \}}|qSrrrrrrrU)rVNr)minrrr{ryrr) shard_listsZ shards_itersZshards_currentrrrZ shards_nextr`rrrrrrs(    rcCs|dd|f|ddS)Nrrr)rr`rrrr?srcCs0|d||d|d|d|f|ddS)Nrr/rcrrrrrrrrrBsrcCs*|d||d|d|f|ddS)Nrr/rcrrrrrrrEsrcCs|dd|f|ddS)Nrcrr)rr_rrrrHsrc Csdd|D}t}g}g}d}d}d}|D]r\}} } | r>|}|d||| f||j|j|d||jD]} | |j| <qz|| 7}|d7}q,|r||g|d|||dd}||_||_ |S)a|Stack canvases in l vertically and return resulting canvas. :param l: list of (canvas, position, focus) tuples: position a value that widget.set_focus will accept or None if not allowed focus True if this canvas is the one that would be in focus if the whole widget is in focus cSs g|]\}}}t|||fqSr)r)rQrpfrrrrUZrVz!CanvasCombine..rr/N) rrrrrErrsrFkeysr`r) lZclistZcombined_canvasrrrXZ focus_indexnrrr,rrrr CanvasCombineNs0     rcCsTt|}|||||||dfdd|dfg|_i|_|jD]}d|j|<q@|S)zE Overlay canvas top_c onto bottom_c at position (left, top). NrZfg)rrrrFr)Ztop_cZbottom_crjrkZoverlayed_canvasrrrr CanvasOverlayvs   rcCsPg}d}d}d}|D]N\}}}}|} ||} |r<|}| |krH| }|||| | f|d7}qg} g} t} d}|D]\}}} } t|}| r|d| | |kr|d|| | j||d|j D]}|| j |<q| |j | |d||f||7}qz|r<| |g| d|| |dd} t | | _ | | _ | S)aG Join canvases in l horizontally. Return result. :param l: list of (canvas, position, focus, cols) tuples: position value that widget.set_focus will accept or None if not allowed focus True if this canvas is the one that would be in focus if the whole widget is in focus cols is the number of screen columns that this widget will require, if larger than the actual canvas.cols() value then this widget will be padded on the right. rr/N)r`r_rrrrrErrsrFrrrr)rl2Z focus_itemrrrrr,r_r`Z pad_rightrrZ joined_canvasrrrrr CanvasJoinsH      rcsg}g}g}Gddd}|d_d_fdd|D]\}t|d|}g} gg} fdd} |D]} t| } | jrt| j| j\}}| || | j| jt|t | |qp| j rt| j \}}| || | j| jt |t | |qp| jr>| j rr| t | j | | j| j| j qp| t | j d| j f| d| j fqp|t | ||| q.AttrWalkNrArrrrAttrWalksrrcs|jkrd_d_g}j|krtjkrN|d|t|jfqj\}}j||krjd7_j|7_q|j|kr|||t|jfq||j|t|jfjd7_j|7_q|S)z9Return an attribute list for the range of text specified.rNr/)offrryrrz) start_offsend_offsoatr)rRawrraranges(   z!apply_text_layout..arangec s||kr*||\\}}t||fdS|||kr\||D]\}}t||fq@dS|}||D]j\}}|||krt||fdS|||}t|\}}t|}t||f||7}||8}qjdS)zi Add attributes based on attributes between start_offs and end_offs. N)rr r) rrZdestwrrrtsegrSZsegw)rlinearTrr attrranges&   z$apply_text_layout..attrrange)r)rrr r rr ZoffsrrrrTryZscrr|rWru)rTrRZlsrrrrrZ line_layoutrZlinecrsegsrrSr)rrRrrrTrapply_text_layoutsN        r)TN)-Z __future__rrr$Z urwid.utilrrrrrr r r Zurwid.text_layoutr r Z urwid.compatrobjectr Exceptionr@rBrurrrrrrrrrrrrrrrrrrrrrrrrrsD( ,% /#!!(9