jj' ddlmZddlZddlZddlmZddlmZmZddl m Z ddl m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZddlmZmZdd lmZdd lm Z dd l!m"Z"m#Z#m$Z$ejJrdd lm&Z&m'Z'dd l(m)Z)ejTdZ+ejTdZ,Gdde#Z-Gdde$Z.ddZ/Gddej`Z1Gdde"eeejde+e,fZ3y)) annotationsN)MutableSequence) CanvasOverlayCompositeCanvas)remove_defaults) RELATIVE_100AlignSizingVAlign WHSettingsWrapModenormalize_alignnormalize_heightnormalize_valignnormalize_widthsimplify_alignsimplify_heightsimplify_valignsimplify_width) WidgetContainerListContentsMixinWidgetContainerMixin)calculate_top_bottom_filler)calculate_left_right_padding)Widget WidgetError WidgetWarning)IteratorSequence)Literal TopWidget BottomWidgetceZdZdZy) OverlayErrorzOverlay specific errors.N__name__ __module__ __qualname____doc__]/home/ubuntu/.cache/pipx/cdb5059130eadca/lib/python3.12/site-packages/urwid/widget/overlay.pyr$r$)s"r+r$ceZdZdZy)OverlayWarningzOverlay specific warnings.Nr%r*r+r,r.r.-s$r+r.ct|tsO|jjd|jj}t j |dtdyy)N.z is not subclass of Widget stacklevel) isinstancer __class__r'r&warningswarnDeprecationWarning)widgetobj_class_paths r,_check_widget_subclassr;1sY ff %",,778&:J:J:S:S9TU 8 9   &r+ceZdZUded<ded<ded<ded<ded<d ed <d ed <d ed <ded<ded<ded<ded<d ed<d ed<y)OverlayOptionsz$Align | Literal[WHSettings.RELATIVE]align int | None align_amountr width_type width_amount min_widthintleftrightz%VAlign | Literal[WHSettings.RELATIVE] valign_type valign_amount height_type height_amount min_heighttopbottomN)r&r'r(__annotations__r*r+r,r=r=;sR // I J66 H Kr+r=cDeZdZdZdZeejdejdddde jdejddddZ d! d"fd Z d#dZ d$ d%fd Zd&d'd Zd(fd Zd)d Zed*d Ze d+dZed,dZe d-dZe d! d.dZ d! d/dZd0dZ d1dZed2dZed3dZej>d4dZed5dZ e j>d6dZ d7dZ! d8dZ" d9dZ# d:dZ$ d;dZ%d&dOverlayzOverlay contains two widgets and renders one on top of the other. Top widget can be Box, Flow or Fixed. Bottom widget should be Box. TNdr)r>r@rArBrCrErFrGrHrIrJrKrLrMc t |||_||_|j ||||||| | | | t |t |y)a :param top_w: a flow, box or fixed widget to overlay "on top". :type top_w: Widget :param bottom_w: a box widget to appear "below" previous widget. :type bottom_w: Widget :param align: alignment, one of ``'left'``, ``'center'``, ``'right'`` or (``'relative'``, *percentage* 0=left 100=right) :type align: Literal["left", "center", "right"] | tuple[Literal["relative"], int] :param width: width type, one of: ``'pack'`` if *top_w* is a fixed widget *given width* integer number of columns wide (``'relative'``, *percentage of total width*) make *top_w* width related to container width :type width: Literal["pack"] | int | tuple[Literal["relative"], int] :param valign: alignment mode, one of ``'top'``, ``'middle'``, ``'bottom'`` or (``'relative'``, *percentage* 0=top 100=bottom) :type valign: Literal["top", "middle", "bottom"] | tuple[Literal["relative"], int] :param height: one of: ``'pack'`` if *top_w* is a flow or fixed widget *given height* integer number of rows high (``'relative'``, *percentage of total height*) make *top_w* height related to container height :type height: Literal["pack"] | int | tuple[Literal["relative"], int] :param min_width: the minimum number of columns for *top_w* when width is not fixed. :type min_width: int :param min_height: minimum number of rows for *top_w* when height is not fixed. :type min_height: int :param left: a fixed number of columns to add on the left. :type left: int :param right: a fixed number of columns to add on the right. :type right: int :param top: a fixed number of rows to add on the top. :type top: int :param bottom: a fixed number of rows to add on the bottom. :type bottom: int Overlay widgets behave similarly to :class:`Padding` and :class:`Filler` widgets when determining the size and position of *top_w*. *bottom_w* is always rendered the full size available "below" *top_w*. N)super__init__top_wbottom_wset_overlay_parametersr;)selfrUrVr>widthvalignheightrCrKrErFrLrMr5s r,rTzOverlay.__init__fsSF     ##E5&&)ZY]_dfikqru%x(r+c tjh}|jj}|jt j k(rtj|vr*|jtjt)|Stjd|jdtjjdt j jtdt)|S|jt j k(rtj|vr|jtj|jr|jt j k(s |j"r|jtjt)|Stjd|jdtjjd|jjtdt)|S|j$r|jt j k(s |j&rtj|vr~|jtj|jr|jt j k(s |j"r|jtjt)|Stjd|jdtjjd|jjtdt)|S)a"Actual widget sizing. :returns: Sizing information depends on the top widget sizing and sizing parameters. :rtype: frozenset[Sizing] Rules: * BOX sizing is always supported provided by the bottom widget * FLOW sizing is supported if top widget has: * * PACK height type and FLOW supported by the TOP widget * * BOX supported by TOP widget AND height amount AND height type GIVEN of min_height * FIXED sizing is supported if top widget has: * * PACK width type and FIXED supported by the TOP widget * * width amount and GIVEN width or min_width AND: * * * FLOW supported by the TOP widget AND PACK height type * * * BOX supported by the TOP widget AND height_amount and GIVEN height or min height z Top widget z should support sizing z for width type r1r2z for height type )r BOXrUsizingrAr PACKFIXEDaddr6r7upperr.rIFLOWrBGIVENrCrJrK frozenset)rXr^ top_sizings r,r^zOverlay.sizingsq"**ZZ&&( ??joo -||z) 6<<(H  E !$**-DV\\EWEWEYDZ[&&0oo&;&;&=%>@" D  7   0{{j( 6;;'$$$//Z=M=M*MQUQ_Q_JJv||,,  ) !$**-DV[[EVEVEXDYZ''+'7'7'='='?&@B" (    T%5%59I9I%IT__zzZ' 6;;'$$$//Z=M=M*MQUQ_Q_JJv||,   !$**-DVZZEUEUEWDXY''+'7'7'='='?&@B"   r+c|rt|||S|jxsd|jxsdz}|jxsd|j xsdz}|j tjk(r)|jjd|\}}||z||zfS|jstd|jd|j jd|jd|jjd|jd|jd |j |j tj"k(r|j}||z}n|j tj$k(r7|jr+|j}t'|d z|jz d z}ntd|jd|j jd|jd|jjd|jd|jd |j |jtjk(r"||jj)|f||zfS|jstd|jd|j jd|jd|jjd|jd|jd |j |jtj"k(r||j|zfS|jtj$k(r6|j r*|t'|j d z|jz d zfStd|jd|j jd|jd|jjd|jd|jd |j ) Nrr*zRequested FIXED render for z with width_type=, width_amount=, height_type=, height_amount= min_width= , min_height=rQ?)rSpackrErFrLrMrAr r_rUrBr$rbrIrJrCrKrdRELATIVErDrows) rXsizefocus extra_cols extra_rowscolsrpw_colsr5s r,rnz Overlay.packs 7<e, ,iin1q9 hhm! (8q9 ??joo -U3JD$*$dZ&77 7  -djj\:"oo33567 $ 1 145#//55789!!%!3!3 6T^^./"oo0 2  ??j.. .&&FJ&D __ 3 3 3^^Fv|d&7&77#=>D-djj\:"oo33567 $ 1 145#//55789!!%!3!3 6T^^./"oo0 2    z .&E:ZGG G!!-djj\:"oo33567 $ 1 145#//55789!!%!3!3 6T^^./"oo0 2    z// /++j88 8   z22 2tT__s2T5G5GG#MNN N)$**6////123 --01++11345!//2*+//,  .  r+cV|jxsd|jxsdz}|jtjk(r|j |zS|jtj k(r4|jr(t|jdz|j z dzS|jtjk(r|jxsd|jxsdz}|jtjk(r6|jr*|jj|jf||zS|jtj k(rYtt|d|jzdz dz|jxsd}|jj|f||zSt!d|jd|d|jj#d|jd|jj#d |j d |jd |j) z#Widget rows amount for FLOW sizing.rrQrmzRequested rows for z with size z width_type=rhrirjrkrl)rLrMrIr rdrJrorKrDr_rArBrUrpmaxrCr$rb)rXrqrr extra_heightrYs r,rpz Overlay.rows7s A$++*:;   z// /%% 4 4   z22 2tt,t/A/AACGH H   z . HHMdkk.>Q?L*"2"22t7H7Hzz(9(9';UClRR*"5"55CQ$*;*; ;c AC GH4>>K^]^`zzx7,FF!$**[$////123 --01++11345!//2*+//,  .  r+cfit||j|j|j|j |j |j|j|j|j|j|j|jd }t|tj S)N rUrVr>rYrZr[rCrKrErFrLrM)rS _repr_attrsrUrVr>rYrZr[rCrKrErFrLrMrrPrT)rXattrsr5s r,r|zOverlay._repr_attrsQs g!# ZZ ZZZZkkkk//IIZZ88kk ug&6&677r+c#Kd|jfd|jfd|jfd|jfd|jfd|j fd|j fd|jfd |jfd |jfd|jfd|jfyw) NrLrMr>rYrZr[rCrKrErFr{rXs r, __rich_repr__zOverlay.__rich_repr__csTZZ %%tzz!!tzz!! ## ##4>>))DOO++diitzz!!TXXo ##sCCcBt|j|jSN)r align_typer@rs r,r>z Overlay.alignqsdoot/@/@AAr+cBt|j|jSr)rrArBrs r,rYz Overlay.widthusdoot/@/@AAr+cBt|j|jSr)rrGrHrs r,rZzOverlay.valignst//1C1CDDr+cBt|j|jSr)rrIrJrs r,r[zOverlay.heightst//1C1CDDr+c|tjtjtjhvr t|}n2|tj k(rtj }nt d||tjtjtjhvr t|}n2|tj k(rtj }nt d|t||t |||| | ||t ||| | | S)an Return a new options tuple for use in this Overlay's .contents mapping. This is the common container API to create options for replacing the top widget of this Overlay. It is provided for completeness but is not necessarily the easiest way to change the overlay parameters. See also :meth:`.set_overlay_parameters` zUnknown alignment type z Unknown vertical alignment type ) r LEFTCENTERRIGHTr ro ValueErrorr TOPMIDDLEBOTTOMr=)rr@rArBrGrHrIrJrCrKrErFrLrMr>rZs r,optionszOverlay.optionss2 %**ellEKK@ @*%E :.. .''E6znEF F 6::v}}fmmD DK(F J// /((F? OP P   z "       { #      r+c &t|tr?|ddk(r|d}tj} n,|ddk(r|d}tj} n|} n t|} t|tr'|ddk(r |d}t }n|ddk(r |d}t }t|tr?|ddk(r|d} t j} nP|ddk(r|d} t j} n2|} n/t|t tfstd|t |} t|tr'|ddk(r |d} t }n|ddk(r |d} t }|tj}|tj}t| t\} }t|t\}}t| t\}}t!|t\}}|tj"tjhvrd}|j$|j'| |||||||||||| | f|j(d<y) z Adjust the overlay size and position parameters. See :class:`__init__() ` for a description of the parameters. rz fixed leftrz fixed rightz fixed topz fixed bottomzinvalid valign: N)r4tupler rrr r rrstrr$r r_rrrrrdrUrcontents)rXr>rYrZr[rCrKrErFrLrMnormalized_alignnormalized_valignrr@rArBrGrHrIrJs r,rWzOverlay.set_overlay_parameterss 8 eU #Qx<'Qx#(:: q]*a#(;; #( $U|  eU #Qx<'Qx$q]*a$ fe $ayK'Qi$*JJ!n,$*MM!$*!FVSM2!1&<= =!'v  fe $ayN*%k)Qi% =OOE >__F#23C\#R L#25,#G L%56G%V" ]%5fl%K" ] :++Z__= =J JJ LL   ar+c6|jjS)zReturn selectable from top_w.)rU selectablers r,rzOverlay.selectable1szz$$&&r+c |j|d}|jj|j|g|j |d|S)zPass keypress to top_w.T)rnrUkeypress top_w_sizecalculate_padding_filler)rXrqkey real_sizes r,rzOverlay.keypress5sO IIdD) zz"" DOOI W(E(EiQU(V W   r+c|jS)z Read-only property returning the child widget in focus for container widgets. This default implementation always returns ``None``, indicating that this widget has no children. )rUrs r,rrz Overlay.focusAszzr+cy)zF Return the top widget position (currently always 1). rr*rs r,focus_positionzOverlay.focus_positionJs r+c*|dk7rtd|y)z Set the widget in focus. Currently only position 0 is accepted. position -- index of child widget to be made focus rzEOverlay widget focus_position currently must always be set to 1, not N) IndexError)rXpositions r,rzOverlay.focus_positionQs% q=demdnop p r+c Gfddtttjtt ft f}|S)a- a list-like object similar to:: [(bottom_w, bottom_options)), (top_w, top_options)] This object may be used to read or update top and bottom widgets and top widgets's options, but no widgets may be added or removed. `top_options` takes the form `(align_type, align_amount, width_type, width_amount, min_width, left, right, valign_type, valign_amount, height_type, height_amount, min_height, top, bottom)` bottom_options is always `('left', None, 'relative', 100, None, 0, 0, 'top', None, 'relative', 100, None, 0, 0)` which means that bottom widget always covers the full area of the Overlay. writing a different value for `bottom_options` raises an :exc:`OverlayError`. cveZdZddZWjZWj Zd dZd dZ d fd Z d dZ d dZ y))Overlay.contents..OverlayContentscyNr*) inner_selfs r,__len__z1Overlay.contents..OverlayContents.__len__}sr+ctdNz'OverlayContents is fixed-sized sequence TypeErrorrXindexs r, __delitem__z5Overlay.contents..OverlayContents.__delitem__ IJJr+ctdrr)rXrvalues r,insertz0Overlay.contents..OverlayContents.insertrr+cdtd|jjd|d|dgdS)N<(rrz)> for )reprr5r&)rrXs r,__repr__z2Overlay.contents..OverlayContents.__repr__sBa 4 4 = =>aAPZ[\P]@^?__fgkflmnnr+c3&K|D]}d|f ywrr*)rvals r,rz7Overlay.contents..OverlayContents.__rich_repr__s%$C)O$sc3:KtdD] }|| ywr)range)ridxs r,__iter__z2Overlay.contents..OverlayContents.__iter__s# 8*C$S/)*sN)returnrD)r int | slicertyping.NoReturn)rrrz typing.Anyrr)rrrz4Iterator[tuple[str | None, typing.Any] | typing.Any])rz'Iterator[tuple[Widget, OverlayOptions]]) r&r'r(r_contents__getitem__ __getitem___contents__setitem__ __setitem__rrrrrrsr,OverlayContentsrts< 33K33K K K o $ *r+r)rrtypingUnionr!r"r=)rXrs` r,rzOverlay.contents[sB2 * LLL!89"$  *@  r+c~t|dk7r td|d|jd<|d|jd<y)Nrz,Contents length for overlay should be only 2rr)lenrr)rX new_contentss r,rzOverlay.contentss? |  !KL L'? a'? ar+c|dk(r|j|jfS|dk(r|jt|j|j |j |j|j|j|j|j|j|j|j|j|j |j"fSt%d|)Nrr!Overlay.contents has no position )rV_DEFAULT_BOTTOM_OPTIONSrUr=rr@rArBrCrErFrGrHrIrJrKrLrMrrs r,rzOverlay._contents__getitem__s A:MM4#?#?@ @ A: OO%%OO%%NNIIJJ$$&&$$&&OOHHKK &>Gc t|jdsy|j|d}|\}}|j|d\}}}}|jj ||z |z ||z |z f\} } | |k\r|dz } | |z| |zfS)z(Return cursor coords from top_w, if any.get_cursor_coordsNTr)hasattrrUrnrr) rXrqrmaxcolmaxrowrErFrLrMxys r,rzOverlay.get_cursor_coordss tzz#67IIdD) $#'#@#@D#Q eS&zz++Vd]U-BFSLSYDY,Z[1 ; A4xS  r+c |\}}d}|jtjk(ry|jj d|\}}|s t dt ||j|jtj|d|j|j\}}n[t ||j|j|j|j|j|j|j\}}|r_t||j |j"tj$|d|j&|j(\} } || z | z |kr|| z |z } n|j*tjk(rt|jj-|f|}t||j |j"tj$|d|j&|j(\} } ||kDra||z } n[t||j |j"|j*|j.|j0|j&|j(\} } ||| | fS)z1Return (padding left, right, filler top, bottom).Nr*)rrzfixed widget must have a height)rAr r_rUrnr$rrr@rCLIPrErFrBrCrrGrHrdrLrMrIrprJrK) rXrqrrrrr[rYrErFrLrMs r,rz Overlay.calculate_padding_fillers    ??joo - JJOOBeO BUHdC88r+c 4t|jdsy|j||}|j||\}} } } |\} } ||ks|| | z k\s || ks|| | z k\ry|jj |j ||| | | ||||z || z |S)z0Pass event to top_w, ignore if outside of top_w. mouse_eventF)rrUrnrrr)rXrqeventbuttoncolrowrrrrErFrLrMrrs r,rzOverlay.mouse_eventsstzz=1IIdE* #'#@#@E#R eS&" :.#)sfvo?Uzz%% OOItUC @   $J #I    r+)NNrrrr)rUr!rVr"r>~Literal['left', 'center', 'right'] | Align | tuple[Literal['relative', 'fixed left', 'fixed right', WHSettings.RELATIVE], int]rYdLiteral['pack', WHSettings.PACK] | int | tuple[Literal['relative', WHSettings.RELATIVE], int] | NonerZLiteral['top', 'middle', 'bottom'] | VAlign | tuple[Literal['relative', 'fixed top', 'fixed bottom', WHSettings.RELATIVE], int]r[rrCr?rKr?rErDrFrDrLrDrMrDrNone)rzfrozenset[Sizing])r*F)rq(tuple[()] | tuple[int] | tuple[int, int]rrboolrtuple[int, int])F)rqz tuple[int]rrrrrD)rzdict[str, typing.Any]r)rz0Align | tuple[Literal[WHSettings.RELATIVE], int])rzLiteral[WHSettings.CLIP, WHSettings.PACK] | int | tuple[Literal[WHSettings.RELATIVE], int] | tuple[Literal[WHSettings.WEIGHT], int | float])rz1VAlign | tuple[Literal[WHSettings.RELATIVE], int])rzint | Literal[WHSettings.FLOW, WHSettings.PACK] | tuple[Literal[WHSettings.RELATIVE], int] | tuple[Literal[WHSettings.WEIGHT], int | float])rzKLiteral['left', 'center', 'right', 'relative', WHSettings.RELATIVE] | Alignr@r?rAz9Literal['clip', 'pack', 'relative', 'given'] | WHSettingsrBr?rGzLLiteral['top', 'middle', 'bottom', 'relative', WHSettings.RELATIVE] | VAlignrHr?rIz9Literal['flow', 'pack', 'relative', 'given'] | WHSettingsrJr?rCr?rKr?rErDrFrDrLrDrMrDrr=)r>rrYrrZrr[rrCr?rKr?rErDrFrDrLrDrMrDrr)rr)rqrrrrz str | None)rr!)rz Literal[1])rrDrr)rz@MutableSequence[tuple[TopWidget | BottomWidget, OverlayOptions]])rz&Sequence[tuple[width, OverlayOptions]]rr)r Literal[0, 1]r/tuple[TopWidget | BottomWidget, OverlayOptions])rrrrrr)rqrrztuple[int, int] | None)rqrrrrrztuple[int, int, int, int]) rqrrErDrFrDrLrDrMrDrr)rqrrrrrr)rqrrrrrDrrDrrDrrrrz bool | None))r&r'r(r) _selectabler=r rr ror rrrTr^rnrpr|rpropertyr>rYrZr[ staticmethodrrWrrrrrsetterrrrrrrrr __classcell__)r5s@r,rPrPLs K,jj&& JJ'' B!%!%+K)K)K)  ` K)tK) `K)uK) !K)"#K)$%K)&'K)()K)*+K), -K)Z9!z:<G 6G G   G R 48$ $BBB 9BBEEE 9EE!%!%5 _5  5 N5 ! 5 b 5 " 5 O5 "5 5 5 5 5 5 5  5 5 J!%!%'h  `h th  `h uh h h !h "#h $%h &'h ( )h T'  6        qq8!8!t__++ HH 9H:88?8  8t !6 !  !J(J(J( # J(X>>> >  >  > 2>$9$ 6           r+rP)r9rrr)4 __future__rrr6collections.abcr urwid.canvasrrurwid.split_reprr constantsr r r r r rrrrrrrrr containerrrfillerrpaddingrr9rrr TYPE_CHECKINGrrtyping_extensionsr TypeVarr!r"r$r.r; NamedTupler=GenericrPr*r+r,r s" +7, N/166 2) FNN; ' v~~n- #;#%]% V&&"B  f*,Lfnn]fht]tNuB  r+