jj\ddlmZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z mZmZddlmZd d lmZmZmZd d lmZmZej2rdd lmZdd lmZddlmZGddeZGddeZ Gdde Z!y)) annotationsN) text_layout)CompositeCanvas)Command)remove_defaults) is_wide_charmove_next_charmove_prev_char)decompose_tagmarkup)AlignSizingWrapMode)Text TextError)Hashable)Literal) TextCanvasc eZdZy) EditErrorN)__name__ __module__ __qualname__Z/home/ubuntu/.cache/pipx/cdb5059130eadca/lib/python3.12/site-packages/urwid/widget/edit.pyrrsrrc eZdZUdZeej gZdZdZ ddgZ de d<d&dZ d d de jej dd d d f d'fd Zd(fd Zd)fd Zd*dZd+dZd,dZd-dZed.dZd/dZededZd0dZd1dZd.dZeeedZd1dZ d2dZ!d3dZ" d4dZ# d5dZ$ d6d Z%d7d!Z& d8 d9fd" Z' d: d;fd# Z(dEdita Text editing widget implements cursor movement, text insertion and deletion. A caption may prefix the editing area. Uses text class for text layout. Users of this class may listen for ``"change"`` or ``"postchange"`` events. See :func:``connect_signal``. * ``"change"`` is sent just before the value of edit_text changes. It receives the new text as an argument. Note that ``"change"`` cannot change the text in question as edit_text changes the text afterwards. * ``"postchange"`` is sent after the value of edit_text changes. It receives the old value of the text as an argument and thus is appropriate for changing the text. It is possible for a ``"postchange"`` event handler to get into a loop of changing the text and then being called when the event is re-emitted. It is up to the event handler to guard against this case (for instance, by not changing the text if it is signaled for text that it has already changed once). TFchange postchangeztyping.ClassVar[list[str]]signalscZt|dxst|dk(xrt|dk\S)z Filter for text that may be entered into this widget by the user :param ch: character to be inserted :type ch: str This implementation returns True for all printable characters. rr )rlenordselfchs r valid_charzEdit.valid_char7s+B"Fs2w!|'EB2 FrNc .t |d|||||_||_d|_t |\|_|_d|_d|_ |j|| t|}|j||j| d|_y)a :param caption: markup for caption preceding edit_text, see :class:`Text` for description of text markup. :type caption: text markup :param edit_text: initial text for editing, type (bytes or unicode) must match the text in the caption :type edit_text: bytes or unicode :param multiline: True: 'enter' inserts newline False: return it :type multiline: bool :param align: typically 'left', 'center' or 'right' :type align: text alignment mode :param wrap: typically 'space', 'any' or 'clip' :type wrap: text wrapping mode :param allow_tab: True: 'tab' inserts 1-8 spaces False: return it :type allow_tab: bool :param edit_pos: initial position for cursor, None:end of edit_text :type edit_pos: int :param layout: defaults to a shared :class:`StandardTextLayout` instance :type layout: text layout instance :param mask: hide text entered with this character, None:disable mask :type mask: bytes or unicode >>> Edit() >>> Edit("Y/n? ", "yes") >>> Edit("Name ", "Smith", edit_pos=1) >>> Edit("", "3.14", align="right") r*rNF)super__init__ multiline allow_tab _edit_posr _caption_attrib _edit_text highlight set_edit_textr$ set_edit_posset_mask_shift_view_to_cursor) r'caption edit_textr.alignwrapr/edit_poslayoutmask __class__s rr-z Edit.__init__BsX UD&1""&9'&B# t|15 9%  9~H (# d%*"rct|ddt|jgzd|jgt |jzzdg|j duzzS)Nzcaption=r.T)r, _repr_wordsreprr3r1boolr.)r'r@s rrCzEdit._repr_words|sn G  !#2 &DOO$% &$--*+,tDMM/BB Cmt~~56 7 rctit|d|ji}t|tj S)Nr=)r, _repr_attrsr0rrr-)r'attrsr@s rrGzEdit._repr_attrss1E57&(E*dnnEudmm44rc|j%|j|jz|jfS|j|jt |jzz|jfS)a Returns ``(text, display attributes)``. See :meth:`Text.get_text` for details. Text returned includes the caption and edit_text, possibly masked. >>> Edit("What? ", "oh, nothing.").get_text() ('What? oh, nothing.', []) >>> Edit(("bright", "user@host:~$ "), "ls").get_text() ('user@host:~$ ls', [('bright', 13)]) >>> Edit("password:", "seekrit", mask="*").get_text() ('password:*******', []) )_maskr1r3r2r$r's rget_textz Edit.get_textsT :: ==4??2DLL@ @}} S-A ABDLLPPrcJt|ds |dk(rd|_ytd)z Not supported by Edit widget. >>> Edit().set_text("test") Traceback (most recent call last): EditError: set_text() not supported. Use set_caption() or set_edit_text() instead. _textr*NzHset_text() not supported. Use set_caption() or set_edit_text() instead.)hasattrrNr)r'markups rset_textz Edit.set_texts*tW%&B,DJ bccrc`|\}|j\}}||k7r|j|fdS|S)a Return the preferred column for the cursor, or the current cursor x value. May also return ``'left'`` or ``'right'`` to indicate the leftmost or rightmost column available. This method is used internally and by other widgets when moving the cursor up or down between widgets so that the column selected is one that the user would expect. >>> size = (10,) >>> Edit().get_pref_col(size) 0 >>> e = Edit("", "word") >>> e.get_pref_col(size) 4 >>> e.keypress(size, "left") >>> e.get_pref_col(size) 3 >>> e.keypress(size, "end") >>> e.get_pref_col(size) >>> e = Edit("", "2\nwords") >>> e.keypress(size, "left") >>> e.keypress(size, "up") >>> e.get_pref_col(size) 4 >>> e.keypress(size, "left") >>> e.get_pref_col(size) 0 r)pref_col_maxcolget_cursor_coords)r'sizemaxcolpref_col then_maxcols r get_pref_colzEdit.get_pref_cols@>  $ 4 4+ & ))6)4Q7 7rcTt|\|_|_|jy)au Set the caption markup for this widget. :param caption: markup for caption preceding edit_text, see :meth:`Text.__init__` for description of text markup. >>> e = Edit("") >>> e.set_caption("cap1") >>> print(e.caption) cap1 >>> e.set_caption(("bold", "cap2")) >>> print(e.caption) cap2 >>> e.attrib [('bold', 4)] >>> e.caption = "cap3" # not supported because caption stores text but set_caption() takes markup Traceback (most recent call last): AttributeError: can't set attribute N)r r1r2 _invalidate)r'r9s r set_captionzEdit.set_captions#(':'&B# t| rc|jS)zK Read-only property returning the caption for this widget. )r1rKs rr9z Edit.captions }}rctt|dt|j}d|_d|_||_|jy)a Set the cursor position with a self.edit_text offset. Clips pos to [0, len(edit_text)]. :param pos: cursor position :type pos: int >>> e = Edit("", "word") >>> e.edit_pos 4 >>> e.set_edit_pos(2) >>> e.edit_pos 2 >>> e.edit_pos = -1 # Urwid 0.9.9 or later >>> e.edit_pos 0 >>> e.edit_pos = 20 >>> e.edit_pos 4 rNNN)minmaxr$r3r4rSr0r[)r'poss rr6zEdit.set_edit_possA*#c1+s4??34) rc|jSN)r0rKs rz Edit.s T^^rzI Property controlling the edit position for this widget. )docc2||_|jy)z Set the character for masking text away. :param mask: hide text entered with this character, None:disable mask :type mask: bytes or unicode N)rJr[)r'r?s rr7z Edit.set_masks  rc |j|}d|_|jd||j}||_t |j t ||_|jd||jy)a Set the edit text for this widget. :param text: text for editing, type (bytes or unicode) must match the text in the caption :type text: bytes or unicode >>> e = Edit() >>> e.set_edit_text("yes") >>> print(e.edit_text) yes >>> e >>> e.edit_text = "no" # Urwid 0.9.9 or later >>> print(e.edit_text) no Nrr )_normalize_to_captionr4_emitr3r`r=r$r[)r'textold_texts rr5zEdit.set_edit_text si$))$/ 8T"??DMM3t95  <* rc|jS)z Return the edit text for this widget. >>> e = Edit("What? ", "oh, nothing.") >>> print(e.get_edit_text()) oh, nothing. >>> print(e.edit_text) oh, nothing. )r3rKs r get_edit_textzEdit.get_edit_text<srzE Property controlling the edit text for this widget. c|j|}|j|\}}|j||j|d|_y)aI Insert text at the cursor position and update cursor. This method is used by the keypress() method when inserting one or more characters into edit_text. :param text: text for inserting, type (bytes or unicode) must match the text in the caption :type text: bytes or unicode >>> e = Edit("", "42") >>> e.insert_text(".5") >>> e >>> e.set_edit_pos(2) >>> e.insert_text("a") >>> print(e.edit_text) 42a.5 N)riinsert_text_resultr5r6r4)r'rk result_text result_poss r insert_textzEdit.insert_textPsL&))$/"&"9"9$"? Z ;' *%rct|t}t|jt}||k(r|S|r|jdS|j dS)zIReturn text converted to the same type as self.caption (bytes or unicode)ascii) isinstancestrr1encodedecode)r'rktucus rrizEdit._normalize_to_captionisK c "  s + 8K ;;w' '{{7##rc|j|}|jr5|j\}}|jd||j|d}}||z}|}n|j}|j} |d||z||dz}|t|z }||fS#tt f$r@}t t|j||fj|j|d}~wwxYw)a! Return result of insert_text(text) without actually performing the insertion. Handy for pre-validation. :param text: text for inserting, type (bytes or unicode) must match the text in the caption :type text: bytes or unicode N) rir4r:r= IndexError TypeError ValueErrorrDwith_traceback __traceback__r$) r'rkstartstopbtextetextrqrrexcs rrpzEdit.insert_text_resultss))$/ >>..KE4>>&514>>$%3H5E%-KJ..KJ s%kz2T9K >;"EFGVVWZWhWhior r ss,B C;CCc|j}|j|rMt|tr+t|jts|j d}|j |y|dk(r3|jr'dd|jdzz z}|j |y|dk(r |jrd}|j |y|j|tjk(r0|dk(r|St|jd|}|j|y|j|tjk(rV|t!|jk\r|St#|j|t!|j}|j|y|j|tj$tj&hvrzd|_|j+|\}}|j-|}| t/||j|tj$k(r|d z}n|d z }|j1|||s|Sy|d k(rd |_|j5sh|dk(r|St|jd|}|j7|jd||j|jdz|j|yy|d k(rd |_|j5s}|t!|jk\r|St#|j|t!|j}|j7|jd|j|j|dzyy|j|tj8tj:hvrd|_d |_|j+|\}}|j|tj8k(r"|j1|t<j|y|j1|t<j|y|S) a Handle editing keystrokes, return others. >>> e, size = Edit(), (20,) >>> e.keypress(size, "x") >>> e.keypress(size, "left") >>> e.keypress(size, "1") >>> print(e.edit_text) 1x >>> e.keypress(size, "backspace") >>> e.keypress(size, "end") >>> e.keypress(size, "2") >>> print(e.edit_text) x2 >>> e.keypress(size, "shift f1") 'shift f1' zutf-8Ntab enter rr backspacer_delete)r=r)rvrwr1rxrsr/r. _command_maprLEFTr r:r6RIGHTr$r UPDOWNr4rTrYrmove_cursor_to_coordsrS_delete_highlightedr5MAX_LEFT MAX_RIGHTr )r'rUkeyrb_xyrWs rkeypressz Edit.keypresss,mm ??3 #s#Jt}}c,Jjj)   S ! %dnnC   S !   S !W\\ 1ax  C8C   c "   S !W]] 2c$..))  c$..6IJC   c "   S !gjj',,%? ?!DN**40EB((.H **   %3QQ--dHa@  + #-D ++-!8J$T^^Q<""4>>$3#7$..:Y#YZ!!#& (?#-D ++-#dnn--J$T^^S#dnn:MN""4>>/DMM#BT^^TWTXEY#YZ   S !g&6&68I8I%J J!DN#-D **40EB  %)9)99**4Q?**4a@ rc|\}|j|}|j|d\}}||ks|t|k\rytj|j d|||}t t|t|jz dt|j} | |_ ||f|_ |jy)a Set the cursor position with (x,y) coordinates. Returns True if move succeeded, False otherwise. >>> size = (10,) >>> e = Edit("", "edit\ntext") >>> e.move_cursor_to_coords(size, 5, 0) True >>> e.edit_pos 4 >>> e.move_cursor_to_coords(size, 5, 3) False >>> e.move_cursor_to_coords(size, 0, 1) True >>> e.edit_pos 5 rFT) get_line_translationposition_coordsr$rcalc_posrLr`rar9r:r=rSr[) r'rUxrrVtrans_top_xtop_yrbe_poss rrzEdit.move_cursor_to_coordss. ))&1,,VQ7  u9SZ""4==?1#5uaCCc$,,//3S5HI  &y rc4|dk(r|j|||Sy)z Move the cursor to the location clicked for button 1. >>> size = (20,) >>> e = Edit("", "words here") >>> e.mouse_event(size, "mouse press", 1, 2, 0, True) True >>> e.edit_pos 2 r F)r)r'rUeventbuttoncolrowfocuss r mouse_eventzEdit.mouse_event!s#& Q;--dC= =rc|jsy|j\}}|jd||j|d}}|j||z||_d|_y)zm Delete all highlighted text and update cursor position, if any text is highlighted. FNT)r4r:r5r=)r'rrrrs rrzEdit._delete_highlighted8s] ~~nn t~~fu-t~~de/Du 55=) rct||_t| ||}|r!t |}|j ||_|S)a Render edit widget and return canvas. Include cursor when in focus. >>> edit = Edit("? ", "yes") >>> c = edit.render((10,), focus=True) >>> c.text [b'? yes '] >>> c.cursor (5, 0) )rEr8r,renderrrTcursor)r'rUrcanvr@s rrz Edit.renderFsG &*%["-2W^D%-H "4(D006DK  rct|||}|js|S|j\}}t j |||j t|jz\}}|dkr*g|d|t j||| g||dzdS||k\r0g|d|t j||||z dz g||dzdS|S)Nrr ) r,rr8rLr calc_coordsr=r$r9 shift_line) r'rVtarrk_ignorerrr@s rrzEdit.get_line_translationcs ,VR8))L  g&&tUDMMC DU4UV1 q5r((qA267q1uw  ;r((qQZ!^3DEFq1uw   rcP|\}d|_|j||jS)z Return the (*x*, *y*) coordinates of cursor within widget. >>> Edit("? ", "yes").get_cursor_coords((10,)) (5, 0) T)r8rr=)r'rUrVs rrTzEdit.get_cursor_coords~s* %)"##FDMM::rc|t|jz}|j|}tj|j d||\}}||fS)zR Return (*x*, *y*) coordinates for an offset into self.edit_text. r)r$r9rrrrL)r'rVrbprrrs rrzEdit.position_coordssS #dll# #))&1&&t}}q'95!D1!t rr(rwreturnrE)r9=str | tuple[Hashable, str] | list[str | tuple[Hashable, str]]r:rwr.rEr;z*Literal['left', 'center', 'right'] | Alignr<z6Literal['space', 'any', 'clip', 'ellipsis'] | WrapModer/rEr=z int | Noner>ztext_layout.TextLayoutr? str | NonerNone)rz list[str])rzdict[str, typing.Any])rz.tuple[str | bytes, list[tuple[Hashable, int]]])rPrrr)rU tuple[int]rint)r9rrr)rrw)rbrrr)r?rrr)rkrwrr)rk str | bytesrr)rkrwrztuple[str | bytes, int]rUrrrwrr)rUrrz&int | Literal[Align.LEFT, Align.RIGHT]rrrrE)rUrrrwrrrrrrrrErz bool | None)rrE)F)rUrrrErzTextCanvas | CompositeCanvasrd)rVrrz5tuple[str | bytes, list[tuple[Hashable, int]]] | NonerzAlist[list[tuple[int, int, int | bytes] | tuple[int, int | None]]])rUrrtuple[int, int])rVrrbrrr),rrr__doc__ frozensetrFLOW_sizing _selectable ignore_focusr!__annotations__r)r rrSPACEr-rCrGrLrQrYr\propertyr9r6r=r7r5rnr:rsrirprrrrrrrTr __classcell__r@s@rrrsK( &GKL+3\*BG 'B GRT>> IntEdit("", 42) Nr*)rwr,r-)r'r9defaultvalr@s rr-zIntEdit.__init__s(  g,CC #&rc,t|||x}r|S|jdkDrp|jdddk(r^|j |jdz |j |jdd|jdkDr|jdddk(r^y)a7 Handle editing keystrokes. Remove leading zeros. >>> e, size = IntEdit("", 5002), (10,) >>> e.keypress(size, "home") >>> e.keypress(size, "delete") >>> print(e.edit_text) 002 >>> e.keypress(size, "end") >>> print(e.edit_text) 2 rNr 0)r,rr=r:r6r5)r'rUr unhandledr@s rrzIntEdit.keypresss"(s3 39 3 mmaDNN2A$6#$=   dmma/ 0   t~~ab1 2mmaDNN2A$6#$=rcF|jrt|jSy)z Return the numeric value of self.edit_text. >>> e, size = IntEdit(), (10,) >>> e.keypress(size, "5") >>> e.keypress(size, "1") >>> e.value() == 51 True r)r:rrKs rvaluez IntEdit.values >>t~~& &rr)r*N)rzint | str | Nonerrr)rr) rrrrr)r-rrrrs@rrrs6(4 '  6 rr)" __future__rrtypingurwidr urwid.canvasrurwid.command_maprurwid.split_reprrurwid.str_utilrr r urwid.utilr constantsr rrrkrr TYPE_CHECKINGcollections.abcrtyping_extensionsrrrrrrrrrse" (%,GG*..! ()'  v 4v r?d?r