codekingpro/portable-devtools
114k
1�
2 ��j�1 � �� � S SK Jr S SKrS SKJr S SKJr S SKJr S SK J3r4 S SK J r J
r
SS KJrJrJr SS5KJrJr \R* ( a S S KJr S S KJr S S
KJr " S S\5 r " S S\5 r g)� )� annotationsN)� text_layout)�apply_text_layout)�remove_defaults)�6calc_width)�decompose_tagmarkup� get_encoding� )�Align�Sizing�WrapMode)�Widget� WidgetError)�Hashable)�Literal)�7TextCanvasc � � \ rS rSrSrg)� TextError� � N)�__name__�8__module__� __qualname__�__firstlineno__�__static_attributes__r � �WD:\code\apps\devtools\python\user_packages\Python313\site-packages\urwid/widget/text.pyr r s � �r r c � ^ � \ rS rSrSr\" \R \R /5 r Sr9Sr \ R \R S4 SU 4S jjjrSU 4S jjrS U 4S jjrS U 4S jjrS S10 jrS S jr\S S j5 r\S!S
j5 rS"S jrS#S jr S$ S%S jjr\" S \5 r \" S \5 r \S 5 r S& S'S jjr S&S(S jjr S$ S)S jjr! S*S jr" S+ S,S jjr#Sr$U =r%$ )-�Text� z'11a horizontally resizeable text widget12T� Nc � >� [ TU ] 5 SU l U=( d [ R U l U R
U5 U R X#U5 g)a� 13:param markup: content of text widget, one of:14 15 bytes or unicode16 text to be displayed17 18 (*display attribute*, *text markup*)19 *text markup* with *display attribute* applied to all parts20 of *text markup* with no display attribute already applied21 22 [*text markup*, *text markup*, ... ]23 all *text markup* in the list joined together24 25:type markup: :ref:`text-markup`26:param align: typically ``'left'``, ``'center'`` or ``'right'``27:type align: text alignment mode28:param wrap: typically ``'space'``, ``'any'``, ``'clip'`` or ``'ellipsis'``29:type wrap: text wrapping mode30:param layout: defaults to a shared :class:`StandardTextLayout` instance31:type layout: text layout instance32 33>>> Text("Hello")34<Text fixed/flow widget 'Hello'>35>>> t = Text(("bold", "stuff"), "right", "any")36>>> t37<Text fixed/flow widget 'stuff' align='right' wrap='any'>38>>> print(t.text)39stuff40>>> t.attrib41[('bold', 5)]42N)�super�__init__�
_cache_maxcolr �default_layout�_layout�set_text�43set_layout)�self�markup�align�wrap�layout� __class__s �r r$ �
Text.__init__$ sE �� �L ����)-���/5�/S��9S�9S�� � �
�
�f� � ����V�,r c �� >� [ TU ] 5 nU R 5 S n[ U5 n[ U5 U R44 :� a. USU R45 S- S- S-46 S- X0R47 * S- S - n/ UQUP$ )zg48Show the text in the repr in python3 format (b prefix for byte strings) and truncate if it's too long49r N� � z...)r# � _repr_words�get_text�repr�len�_repr_content_length_max)r* �first�text�restr/ s �r r4 �Text._repr_wordsP s� �� � ��#�%���}�}��q�!���D�z�� �t�9�t�4�4� 4��A�t�4�4�q�8�A�=��A�B�U�J�T�Sp�Sp�Rp�tu�Ru�Rw�Mx�x�
� ��~��~� r c � >� 0 [ TU ] 5 EU R U R S.En[ U[50 R 5 $ )N)r, r- )r# � _repr_attrs� _align_mode�51_wrap_moder r r$ )r* �attrsr/ s �r r> �Text._repr_attrs] sB �� �52��g�!�#�53��%�%��O�O�54��55 �u�d�m�m�4�4r c �0 >� S U l [ TU ] 5 g �N)r% r# � _invalidate)r* r/ s �r rE �Text._invalidatee s �� � !���
��� r c �T � [ U5 u U l U l U R 5 g)aa 56Set content of text widget.57 58:param markup: see :class:`Text` for description.59:type markup: text markup60 61>>> t = Text("foo")62>>> print(t.text)63foo64>>> t.set_text("bar")65>>> print(t.text)66bar67>>> t.text = "baz" # not supported because text stores text but set_text() takes markup68Traceback (most recent call last):69AttributeError: can't set attribute70N)r �_text�_attribrE )r* r+ s r r( �
Text.set_texti s# � �" $7�v�#>� ��71�D�L� ���r c �2 � U R U R 4$ )a� 72:returns: (*text*, *display attributes*)73 74 *text*75 complete bytes/unicode content of text widget76 77 *display attributes*78 run length encoded display attributes for *text*, eg.79 ``[('attr1', 10), ('attr2', 5)]``80 81>>> Text("Hello").get_text() # ... = u in Python 282(...'Hello', [])83>>> Text(("bright", "Headline")).get_text()84(...'Headline', [('bright', 8)])85>>> Text([("a", "one"), "two", ("b", "three")]).get_text()86(...'onetwothree', [('a', 3), (None, 3), ('b', 5)])87)rH rI �r* s r r5 �
Text.get_text} s � �$ �z�z�4�<�<�'�'r c �( � U R 5 S $ )zP88Read-only property returning the complete bytes/unicode content89of this widget90r �r5 rL s r r: � Text.text� � � � �}�}��q�!�!r c �( � U R 5 S $ )zW91Read-only property returning the run-length encoded display92attributes of this widget93r94 rO rL s r �attrib� Text.attrib� rQ r c � � U R R U5 ( d [ SU< S35 eXl U R 5 g)a# 95Set text alignment mode. Supported modes depend on text layout96object in use but defaults to a :class:`StandardTextLayout` instance97 98:param mode: typically ``'left'``, ``'center'`` or ``'right'``99:type mode: text alignment mode100 101>>> t = Text("word")102>>> t.set_align_mode("right")103>>> t.align104'right'105>>> t.render((10,)).text # ... = b in Python 3106[...' word']107>>> t.align = "center"108>>> t.render((10,)).text109[...' word ']110>>> t.align = "somewhere"111Traceback (most recent call last):112TextError: Alignment mode 'somewhere' not supported.113zAlignment mode � not supported.N)r. �supports_align_moder r? rE �r* �modes r �set_align_mode�Text.set_align_mode� s? � �* �{�{�.�.�t�4�4��o�d�X�_� E�F� F� �� ���r c � � U R R U5 ( d [ SU< S35 eXl U R 5 g)ap 114Set text wrapping mode. Supported modes depend on text layout115object in use but defaults to a :class:`StandardTextLayout` instance116 117:param mode: typically ``'space'``, ``'any'``, ``'clip'`` or ``'ellipsis'``118:type mode: text wrapping mode119 120>>> t = Text("some words")121>>> t.render((6,)).text # ... = b in Python 3122[...'some ', ...'words ']123>>> t.set_wrap_mode("clip")124>>> t.wrap125'clip'126>>> t.render((6,)).text127[...'some w']128>>> t.wrap = "any" # Urwid 0.9.9 or later129>>> t.render((6,)).text130[...'some w', ...'ords ']131>>> t.wrap = "somehow"132Traceback (most recent call last):133TextError: Wrap mode 'somehow' not supported.134z135Wrap mode rV N)r. �supports_wrap_moder r@ rE rX s r �
set_wrap_mode�Text.set_wrap_mode� s> � �. �{�{�-�-�d�3�3��j���� @�A� A� �� ���r c �z � Uc [ R nX0l U R U5 U R U5 g)a� 136Set the text layout object, alignment and wrapping modes at137the same time.138 139:type align: text alignment mode140:param wrap: typically 'space', 'any', 'clip' or 'ellipsis'141:type wrap: text wrapping mode142:param layout: defaults to a shared :class:`StandardTextLayout` instance143:type layout: text layout instance144 145>>> t = Text("hi")146>>> t.set_layout("right", "clip")147>>> t148<Text fixed/flow widget 'hi' align='right' wrap='clip'>149N)r r& r' rZ r^ )r* r, r- r. s r r) �Text.set_layout� s5 � �* �>� �/�/�F� � � ���E�"� ���4� r c � � U R $ rD )r? rL s r �<lambda>�
Text.<lambda>� s150 � �$�"2�"2r c � � U R $ rD )r@ rL s r rc rd � s � �� � r c � � U R $ rD )r' rL s r r. � Text.layout� s � ��|�|�r c � � U R 5 u p4U( a Uu nOU R US9u pVU R XSU45 n[ X4Xu5 $ )a? 151Render contents with wrapping and alignment. Return canvas.152 153See :meth:`Widget.render` for parameter details.154 155>>> Text("important things").render((18,)).text156[b'important things ']157>>> Text("important things").render((11,)).text158[b'important ', b'things ']159>>> Text("demo text").render(()).text160[b'demo text']161)�focus)r5 �pack�get_line_translationr )r* �sizeri r: �attr�maxcol�_�transs r �render� Text.render� sN � �" �]�]�_�162�� � �I�V� � � �� �.�I�F��)�)�&��,�?�� ��U�;�;r c �> � Uu n[ U R U5 5 $ )z�163Return the number of rows the rendered text requires.164 165See :meth:`Widget.rows` for parameter details.166 167>>> Text("important things").rows((18,))1681169>>> Text("important things").rows((11,))1702171)r7 rk )r* rl ri rn s r �rows� Text.rows s! � � � ���4�,�,�V�4�5�5r c �~ � U R ( a U R U:w a U R X5 U R $ )ad 172Return layout structure used to map self.text to a canvas.173This method is used internally, but may be useful for debugging custom layout classes.174 175:param maxcol: columns available for display176:type maxcol: int177:param ta: ``None`` or the (*text*, *display attributes*) tuple178 returned from :meth:`.get_text`179:type ta: text and display attributes180)r% �_update_cache_translation�_cache_translation)r* rn �tas r rk �Text.get_line_translation! s4 � � �!�!�T�%7�%7�6�%A� � *� *�6� 6��&�&�&r c � � U( a Uu p4OU R 5 u p4Xl U R R X1U R U R 5 U l g rD )r5 r% r. r? r@ rx )r* rn ry r: �_attrs r rw � Text._update_cache_translation4 sK � �181 � �K�D�%� �-�-�/�K�D� #��"&�+�+�"4�"4�T�4�CS�CS�UY�Ud�Ud�"e�� r c �� � U R 5 u p4U( al Uu n[ U R S5 ( d XPR X5 4$ U R XSU45 nU R R XV5 nU[
U5 4$ U( a\ [ U[ 5 ( a UR [ 5 5 nUR S5 n[ S U 5 5 [
U5 4$ g)u� 182Return the number of screen columns and rows required for183this Text widget to be displayed without wrapping or184clipping, as a single element tuple.185 186:param size: ``None`` or ``()`` for unlimited screen columns (like FIXED sizing)187 or (*maxcol*,) to specify a maximum column size188:type size: widget size189:param focus: widget is focused on190:type focus: bool191 192>>> Text("important things").pack()193(16, 1)194>>> Text("important things").pack((15,))195(9, 2)196>>> Text("important things").pack((8,))197(8, 2)198>>> Text("important things").pack(())199(16, 1)200>>> not_common_separated_text = "Line feed\nLine Separator\u2028Paragraph Separator\u2029"201>>> #
(Line Separator) and
(Paragraph Separator) are not splitted by StandardTextLayout202>>> not_common_separated = Text(not_common_separated_text)203 204>>> not_common_separated.pack()205(33, 2)206>>> not_common_separated_canv = not_common_separated.render(())207>>> not_common_separated_canv.cols()20833209>>> not_common_separated_canv.rows()2102211rj �212c 3 �N # � U H n[ US [ U5 5 v � M g7f)r N)r r7 )�.0�lines r � <genexpr>� Text.pack.<locals>.<genexpr>v s � � �J�z�t�J�t�Q��D� �2�2�z�s �#%)r r213 )
r5 �hasattrr. rt rk rj r7 �214isinstance�bytes�decoder �split�max) r* rl ri r: rm rn rp �cols�215split_texts r rj � Text.pack@ s� � �H �]�]�_�216�� � �I�V��4�;�;��/�/� �y�y�� 5�5�5��-�-�f�T�l�C�E��;�;�#�#�F�2�D��#�e�*�%� %� ��$��&�&��{�{�<�>�2�� ���D�)�J� �J�z�J�J��J���
� r )r? rI r% rx r' rH r@ )217r+ �=str | tuple[Hashable, str] | list[str | tuple[Hashable, str]]r, �*Literal['left', 'center', 'right'] | Alignr- �6Literal['space', 'any', 'clip', 'ellipsis'] | WrapModer. � text_layout.TextLayout | None�return�None)r� z list[str])r� zdict[str, typing.Any])r� r� )r+ r� r� r� )r� z.tuple[str | bytes, list[tuple[Hashable, int]]])r� z str | bytes)r� zlist[tuple[Hashable, int]])rY r� r� r� )rY r� r� r� rD )r, r� r- r� r. r� r� r� )F)rl ztuple[int] | tuple[()]ri �boolr� r )rl z218tuple[int]ri r� r� �int)rn r� ry �5tuple[str | bytes, list[tuple[Hashable, int]]] | Noner� zAlist[list[tuple[int, int, int | bytes] | tuple[int, int | None]]])rn r� ry r� r� r� )NF)rl z tuple[()] | tuple[int] | Noneri r� r� ztuple[int, int])&r r r r �__doc__� frozensetr �FLOW�FIXED�_sizing� ignore_focusr8 r �LEFTr
�SPACEr$ r4 r> rE r( r5 �propertyr: rS rZ r^ r) r, r- r. rq rt rk rw rj r �
__classcell__)r/ s @r r r s� �� �� ����f�l�l�3�4�G��L� "� �219 =B�J�J�GO�~�~�04� *-�M�*-� :�*-� E� *-�220 .� *-� 221�
*-� *-�X �5� ��((�( �"� �"� �"� �"��4�@ 15� !�9�!� E�!� .� !�222 223� !�6
�2�N� C�E� �0�-� @�D�
� � � � �<�$�<� �<� 224� <�4 6�" EI�'��'�
B�'� 225K� '�&226f��227f�
B�228f� 229� 230f� /3��9�+�9� �9� 231� 9� 9r r ) �232__future__r �typing�urwidr � urwid.canvasr �urwid.split_reprr �urwid.str_utilr �233urwid.utilr r � constantsr r r
�widgetr r �
TYPE_CHECKING�collections.abcr �typing_extensionsr r r r r r r �<module>r� sO �� "�
� � *� ,� %� 8� .� .� '� ���(�)�'� � � �_�6� _r