codekingpro/portable-devtools
115k
1�
2 ��j � � � % S r SSKJr SSKrSSKrSSKJr " S S\R 5 r\" SSS SS39\" S SS SS49\" S SS
SS59\" SSS
SS69\" SSSSS79\" SSSSS89S.r S\9S' " S S\R 5 r " S S\R 5 r g)aV 10`kitty text sizing protocol`_ (OSC 66) parsing and measurement.11 12The kitty text sizing protocol allows terminal apps to explicitly tell13terminals how many cells text occupies, using the escape sequence::14 15 ESC ] 66 ; metadata ; text BEL/ST16 17Metadata is colon-separated ``key=value`` pairs:18 19- ``s``: scale20- ``w``: width in cells21- ``n``: fractional numerator22- ``d``: fractional denominator23- ``v``: vertical alignment24- ``h``: horizontal alignment25 26Parsing is pretty straight-forward:27 28- When ``w > 0``, return ``s * w``.29- Otherwise ``w == 0``, ``s * wcswidth(inner_text_width)`` cells.30 31Numerator, denominator, and alignment codes and values are parsed but otherwise ignored32and have no effect on measurements made in this library.33 34.. _`kitty text sizing protocol`: https://sw.kovidgoyal.net/kitty/text-sizing-protocol/35 36.. versionadded:: 0.7.037� )� annotationsN� )�wcswidthc �> � \ rS rSr% S\S' S\S' S\S' S\S' Srg )38�39_FieldMeta�* �str�name�int�low�high�default� N)�__name__�40__module__� __qualname__�__firstlineno__�__annotations__�__static_attributes__r � �YD:\code\apps\devtools\python\user_packages\Python313\site-packages\wcwidth/text_sizing.pyr r * s � �41
�I� �H�42
�I�
�Lr r �scale� )r43 r r
r �width� numerator� � denominator�vertical_align� �horizontal_align)�s�w�n�d�v�hzdict[str, _FieldMeta]�TEXT_FIELD_MAPPINGc � � \ rS rSr% SrSrS\S' SrS\S' SrS\S' Sr S\S ' Sr44S\S45' Sr S\S ' SS jr SS
jr
\SSS jj5 rSrg)�TextSizingParams�: a 46Parsed parameters from a text sizing escape sequence (OSC 66).47 48:param scale: Scale factor (1-7). Text occupies ``scale`` rows tall and ``scale * width``49 columns wide.50:param width: Width in cells (0-7). When 0, width is auto-calculated from the inner text.51:param numerator: Fractional scaling numerator (0-15).52:param denominator: Fractional scaling denominator (0-15).53:param vertical_align: Vertical alignment (0=top, 1=bottom, 2=center).54:param horizontal_align: Horizontal alignment (0=left, 1=right, 2=center).55r r r r r r r r r c � ^ � SR U 4S j[ R 5 5 5 nT R R SU S3$ )z56Return a compact representation including only non-default fields.57 58This avoids verbose output when most fields are defaults.59z, c 3 � ># � U HP n[ TUR 5 UR :w d M) UR S [ TUR 5 3v � MR g7f)�=N)�getattrr60 r )�.0�field�selfs �r � <genexpr>�,TextSizingParams.__repr__.<locals>.<genexpr>U sN �� � � L�*E�� '��e�j�j� 9�U�]�]� J� I��61�62�|�1�W�T�5�:�:�-F�,G� H�*E�s63 �(A�,A�(�))�joinr' �values� __class__r )r1 �repr_fmts ` r �__repr__�TextSizingParams.__repr__N sL �� � �9�9� L�*<�*C�*C�*E� L� L�� �.�.�)�)�*�!�H�:�Q�7�7r c �� � / n[ R 5 HA u p#[ XR 5 =oCR :w d M+ UR U SU 35 MC SR
U5 $ )z0Build and return sub-part of an OSC 66 sequence.r- �:)r' �itemsr. r64 r �appendr6 )r1 �parts� field_keyr0 �vals r �
make_sequence� TextSizingParams.make_sequenceZ s\ � ��� 2� 8� 8� :� �I� �t�Z�Z�0�0��]�]�B�� � � �{�!�C�5� 1�2� !;� �x�x��� r c �� � 0 nU( d U " 5 $ UR S5 GH
nSU; a US:X a [ SU< SU< 35 eM% UR S5 u pVn[ R U5 nUc US:X a [ SU SU< 35 eMk [ U5 n US:X aZ X�R :� d X�R : a< [ S U SU< S U S
UR SUR SUR 3 5 e[ UR [ UR U 5 5 X8R ' GM U " S0 UD6$ ! [ a( n65US:X a [ S U SU< S66U67 35 U68e Sn69A70GMG Sn71A72ff = f)a0 73Parse colon-separated ``key=value`` metadata string.74 75:param raw: Metadata string, e.g. ``'s=2:w=3'``.76:param control_codes: 'parse' or 'strict'.77:raises ValueError: If ``control_codes='strict'`` unrecognized text sizing parameters raise78 ValueError.79:returns: Parsed parameters with values clamped to valid ranges.80 Unknown keys are ignored. Non-integer values use defaults.81 82Example::83 84 >>> TextSizingParams.from_params('s=2:w=3')85 TextSizingParams(scale=2, width=3, numerator=0, denominator=0, vertical_align=0, horizontal_align=0)86r= r- �strictz5Expected '=' in text sizing parameter (key=val), got z in OSC 66 sequence, NzUnknown text sizing field 'z' in OSC 66 sequence, zIllegal text sizing value 'z: z!Out of bounds text sizing value 'z: allowed range for 'z' (z) is z to r ) �split�87ValueError� partitionr' �getr r
r r88 �max�min) �cls�raw�
control_codes�kwargs�part�key�_eqrB r0 �value�excs r � from_params� TextSizingParams.from_paramsc s� � �$ )+����5�L��I�I�c�N�D��$�� �H�,�$� (,�,0�8�3H���&Q� R� R�� �N�N�3� /�M�C�c�&�*�*�3�/�E��}� �H�,�$�'B�3�%� H<�<?�7�&D� E� E� �
��C��� ��(�e�j�j�.@�E�I�I�DU� �#D�S�E� J8�8;�w� ?7�7:�e�3�u�z�z�l� K'�',�y�y�k��e�j�j�\�"C� D� D� "%�U�Y�Y��E�J�J��0F�!G�F�:�:� �7 #�8 �}�V�}� �� �
� �H�,�$�'B�3�%� H<�<?�7�"�S�E�&K� L�QT�U� ��
�s � D<�<89E.� E)�)E.r N��returnr ��parse)rN r rO r rY r) )r r r r �__doc__r r r r r r r r: rC � classmethodrV r r r r r) r) : sb � �90� �E�3�N��E�3�N��I�s���K����N�C�� ��c� �918� � �0 � �0 r r) c �h � \ rS rSr% SrS\S' S\S' S\S' \S
SS jj5 rSSS jjrSS92 jr S r93g )�94TextSizing� zBBasic horizontal width measurement for kitty text sizing protocol.r) �paramsr �text�95terminatorc � � U " [ R UR S5 US9UR S5 UR S5 S9$ )a� 96Parse using matching OSC 66 Sequence.97 98:param match: match object from :attr:`wcwidth.escape_sequences.TEXT_SIZING_PATTERN`.99:param control_codes: 'parse' or 'strict', same meaning as delegated by100 :func:`wcwidth.width`.101:raises ValueError: When ``control_codes='strict'`` for unrecognized, invalid, or out of102 bounds text sizing parameters.103:returns: TextSizing object from parsed sequence104 105Example::106 107 from wcwidth.escape_sequences import TEXT_SIZING_PATTERN108 >>> TextSizing.from_match(TEXT_SIZING_PATTERN.match('\x1b]66;w=2;XY\x07'))109 TextSizing(params=TextSizingParams(scale=1, width=2, numerator=0, denominator=0, \110 vertical_align=0, horizontal_align=0), text='XY', terminator='\x07')111r )rO r � )ra rb rc )r) rV �group)rM �matchrO s r �112from_match�TextSizing.from_match� sC � �& �*�6�6�u�{�{�1�~�Ub�6�c� � � �A�� #�k�k�!�n�.� .r c �� � U R R S:� a- U R R U R R - $ [ U R US9nU R R [ SU5 - $ )a� 113Calculate the display width of a text sizing sequence.114 115:param ambiguous_width: Width for East Asian Ambiguous characters.116:returns: Display width in terminal cells. When ``width > 0``, returns117 ``params.scale * params.width``. When ``width == 0``, returns118 ``params.scale * measured_inner_width``.119 120.. note: Fractional scaling (numerator/denominator) does not affect the121 cell count, it adjusts only the font size within the cells allocated by 'w'.122r )�ambiguous_width)ra r r r rb rK )r1 rk r" s r �
display_width�TextSizing.display_width� s` � � �;�;� � �q� ��;�;�$�$�t�{�{�'8�'8�8� 8� �T�Y�Y�� @���{�{� � �3�q�!�9�,�,r c �n � SU R R 5 SU R U R 3$ )z3Build and return complete OSC 66 Terminal Sequence.z]66;�;)ra rC rb rc )r1 s r rC �TextSizing.make_sequence� s0 � ��$�+�+�3�3�5�6�a�� � �{�4�?�?�BS�T�Tr r NrZ )rg z
re.Match[str]rO r rY r_ )r )rk r rY r rX ) r r r r r\ r r] rh rl rC r r r r r_ r_ � s2 � �L� � �123
�I��O��.� �.�,-�"Ur r_ )
r\ �124__future__r �re�typing� _wcswidthr �125NamedTupler r' r r) r_ r r r �<module>rv s� �� �< #� 126�
� ���"�"� � 127��a�a�� ;� ��a�a�� ;� ��!�"�a� @� � �A�B�� B� �)�q�q�!� D� �+���A� F�
-H� �)� H�Z �v�(�(� Z �z1U��"�"� 1Ur