codekingpro/portable-devtools
114k
1�
2 ��j~ � �� � S r SSKJr SSKrSSKrSSKJr SSKJr \R " S5 r3\R " S5 r " S S4\R 5 r
" S S \R 5 rg)
zC5OSC 8 hyperlink parsing and measurement.6 7.. versionadded:: 0.7.08� )� annotationsN� )�width)�_SEQUENCE_CLASSIFYz*\x1b]8;([^;]*);([^\x07\x1b]*)(\x07|\x1b\\)z\x1b]8;;(\x07|\x1b\\)c �h � \ rS rSr% SrS\S' SrS\S' SrS\S' \SS j5 r SS9 jr10SS jr S r g
)�HyperlinkParams� z�11Parsed parameters from an OSC 8 hyperlink open sequence.12 13:param url: The hyperlink URL.14:param params: Colon-separated metadata string (often empty).15:param terminator: Sequence terminator (``\x07`` or ``\x1b\\``).16�str�url� �params��17terminatorc � � [ R U5 nUc gU " UR S5 UR S5 UR S5 S9$ )z�18Parse an OSC 8 open sequence string.19 20Returns ``None`` if *seq* is not a valid OSC 8 open.21 22Example::23 24 >>> HyperlinkParams.parse('\x1b]8;;http://example.com\x07')25 HyperlinkParams(url='http://example.com', params='', terminator='\\x07')26N� r � )r r
r )�HYPERLINK_OPEN_RE�match�group)�cls�seq�ms �WD:\code\apps\devtools\python\user_packages\Python313\site-packages\wcwidth/hyperlink.py�parse�HyperlinkParams.parse# sC � �
� #� #�C� (�� �9���q�w�w�q�z�!�'�'�!�*������L�L� c �R � SU R SU R U R 3$ )z(Generate the OSC 8 open escape sequence.z]8;�;)r
r r ��selfs r � make_open�HyperlinkParams.make_open4 s& � �����
�Q�t�x�x�j�� � �0A�B�Br c � � SU R 3$ )z)Generate the OSC 8 close escape sequence.z]8;;)r r s r �27make_close�HyperlinkParams.make_close8 s � ��$�/�/�*�+�+r � N)r r28 �returnzHyperlinkParams | None�r' r29 )
�__name__�30__module__� __qualname__�__firstlineno__�__doc__�__annotations__r
r � classmethodr r! r$ �__static_attributes__r& r r r r sA � �� 31
�H��F�C�� �J�� ��M� �M� C�,r r c � � \ rS rSr% SrS\S' S\S' \SS j5 rSS S32S . SS jjr\SSS
jj5 r SS jr33Sr g)� Hyperlink�= z�34A complete OSC 8 hyperlink with target and inner text.35 36:param params: Parsed open sequence parameters.37:param text: Inner text between the open and close sequences.38r r
r39 �textc �t � [ R X5 nUc gUR 5 UR 5 4$ )a� 40Find the matching OSC 8 close sequence.41 42Searches 'text' starting at 'open_end', the position just past the open43sequence. Returns position of close sequence ``(close_start,44close_end)`` or ``(-1, -1)`` if not found.45 46Per the OSC 8 specification, terminal emulators treat hyperlinks as a47state attribute, not as nested HTML anchors. A close sequence closes48the current hyperlink regardless of how many open sequences preceded it.49������r7 )�HYPERLINK_CLOSE_RE�search�start�end)r r4 �open_endr s r �50find_close�Hyperlink.find_closeH s3 � �
� %� %�d� 5�� �9����� �1�5�5�7�#�#r r � r ��
control_codes�tabsize�ambiguous_widthc �. � [ U R UUUS9$ )z�51Measure the display width of the hyperlink's inner text.52 53Delegates to :func:`wcwidth.width` with the given parameters.54 55Example::56 57 >>> hl = Hyperlink.parse('\x1b]8;;http://example.com\x07Hello\x1b]8;;\x07', 0)58 >>> hl.display_width()59 560r@ )�_widthr4 )r rA rB rC s r �
display_width�Hyperlink.display_widthZ s! � �$ � �I�I�'�� +� 61� 62r c � � [ R " X5 nUc g[ R UR 5 5 nUc gU R XR
5 5 u pVXV4S:X a gU " XAUR
5 U S9$ )a� 63Parse a complete OSC 8 hyperlink unit from *text* at position *start*.64 65Locates the open sequence, finds the matching close, and returns a66``Hyperlink`` containing the parsed parameters and inner text. Returns67``None`` if the text at *start* is not a complete OSC 8 hyperlink.68 69Example::70 71 >>> Hyperlink.parse('\x1b]8;;http://example.com\x07Hello\x1b]8;;\x07')72 Hyperlink(params=HyperlinkParams(url='http://example.com', ...), text='Hello')73Nr6 )r
r4 )r r r r r r= r; )r r4 r: r r
� close_start� close_ends r r �Hyperlink.parses sw � �
� $� $�T� 1�� �9�� �&�&�q�w�w�y�1�� �>��!$� � ��e�e�g�!>� � � � #�x� /���&�A�E�E�G�K�'@�A�Ar c � � U R R 5 U R - U R R 5 - $ )z5Rebuild the complete OSC 8 hyperlink escape sequence.)r
r! r4 r$ r s r �
make_sequence�Hyperlink.make_sequence� s0 � ��{�{�$�$�&����2�T�[�[�5K�5K�5M�M�Mr r& N)r4 r74 r< �intr' ztuple[int, int])rA z+typing.Literal['parse', 'strict', 'ignore']rB rO rC rO r' rO )r )r4 r75 r: rO r' zHyperlink | Noner( ) r) r* r+ r, r- r. r/ r= rF r rM r0 r& r r r2 r2 = s} � ��
��76
�I��$� �$�( FM�� � 77� C�78� � 79�80 � 81� 82
�
83�2 �B� �B�0Nr r2 )r- �84__future__r �re�typingrE r �escape_sequencesr �compiler r8 �85NamedTupler r2 r& r r �<module>rV sh ��� #� 86�
� $� 0��J�J� L�M� ��Z�Z� 8�9� �$,�f�'�'� $,�NQN��!�!� QNr