^j~dZddlmZddlZddlZddlmZddlmZejdZ ejdZ Gd d ejZ Gd d ejZy) zC OSC 8 hyperlink parsing and measurement. .. versionadded:: 0.7.0 ) annotationsN)width)_SEQUENCE_CLASSIFYz*\x1b]8;([^;]*);([^\x07\x1b]*)(\x07|\x1b\\)z\x1b]8;;(\x07|\x1b\\)cZeZdZUdZded<dZded<dZded<ed dZd d Z d d Z y )HyperlinkParamsz Parsed parameters from an OSC 8 hyperlink open sequence. :param url: The hyperlink URL. :param params: Colon-separated metadata string (often empty). :param terminator: Sequence terminator (``\x07`` or ``\x1b\\``). strurlparams terminatorctj|}|y||jd|jd|jdS)a% Parse an OSC 8 open sequence string. Returns ``None`` if *seq* is not a valid OSC 8 open. Example:: >>> HyperlinkParams.parse('\x1b]8;;http://example.com\x07') HyperlinkParams(url='http://example.com', params='', terminator='\\x07') Nr)r r r)HYPERLINK_OPEN_REmatchgroup)clsseqms J/opt/ringagent/.cad-venv/lib/python3.12/site-packages/wcwidth/hyperlink.pyparsezHyperlinkParams.parse#sC  # #C ( 9qwwqz!''!*LLcRd|jd|j|jS)z(Generate the OSC 8 open escape sequence.z]8;;)r r rselfs r make_openzHyperlinkParams.make_open4s& Qtxxj0ABBrc d|jS)z)Generate the OSC 8 close escape sequence.z]8;;)rrs r make_closezHyperlinkParams.make_close8s$//*++rN)rr returnzHyperlinkParams | Noner"r ) __name__ __module__ __qualname____doc____annotations__r r classmethodrrr!rrrrsA HFCJMM C,rrcteZdZUdZded<ded<eddZddd d  dd Zeddd Zdd Z y) Hyperlinkz A complete OSC 8 hyperlink with target and inner text. :param params: Parsed open sequence parameters. :param text: Inner text between the open and close sequences. rr r textcttj||}|y|j|jfS)a Find the matching OSC 8 close sequence. Searches 'text' starting at 'open_end', the position just past the open sequence. Returns position of close sequence ``(close_start, close_end)`` or ``(-1, -1)`` if not found. Per the OSC 8 specification, terminal emulators treat hyperlinks as a state attribute, not as nested HTML anchors. A close sequence closes the current hyperlink regardless of how many open sequences preceded it. r0)HYPERLINK_CLOSE_REsearchstartend)rr-open_endrs r find_closezHyperlink.find_closeHs5  % %dH 5 9 1557##rrr control_codestabsizeambiguous_widthc4t|j|||S)a1 Measure the display width of the hyperlink's inner text. Delegates to :func:`wcwidth.width` with the given parameters. Example:: >>> hl = Hyperlink.parse('\x1b]8;;http://example.com\x07Hello\x1b]8;;\x07', 0) >>> hl.display_width() 5 r8)_widthr-)rr9r:r;s r display_widthzHyperlink.display_widthZs!$ II'+   rc tj||}|ytj|j }|y|j ||j \}}||fdk(ry||||j |S)a Parse a complete OSC 8 hyperlink unit from *text* at position *start*. Locates the open sequence, finds the matching close, and returns a ``Hyperlink`` containing the parsed parameters and inner text. Returns ``None`` if the text at *start* is not a complete OSC 8 hyperlink. Example:: >>> Hyperlink.parse('\x1b]8;;http://example.com\x07Hello\x1b]8;;\x07') Hyperlink(params=HyperlinkParams(url='http://example.com', ...), text='Hello') Nr/)r r-)rrrrrr6r4)rr-r3rr close_start close_ends rrzHyperlink.parsess  $ $T5 1 9 &&qwwy1 >!$aeeg!> Y  #x /&tAEEGK'@AArc|jj|jz|jjzS)z5Rebuild the complete OSC 8 hyperlink escape sequence.)r rr-r!rs r make_sequencezHyperlink.make_sequences0{{$$&2T[[5K5K5MMMrN)r-r r5intr"ztuple[int, int])r9z+typing.Literal['parse', 'strict', 'ignore']r:rDr;rDr"rD)r)r-r r3rDr"zHyperlink | Noner#) r$r%r&r'r(r)r6r>rrCr*rrr,r,=s}  I$$(FM  C      2BB0Nrr,)r' __future__rretypingr=rescape_sequencesrcompilerr1 NamedTuplerr,r*rrrKsl # $0BJJLMRZZ 89$,f''$,NQN!!QNr