(ph$FSrSSKrSSKrSSKrSSKJr SSKJr SSKJr Sr "SS\ 5r "S S \R5r \RR\ l"S S \5rS rSrg)z&Module providing 'sequence awareness'.N)wcwidth)TextType)CAPABILITIES_CAUSE_MOVEMENT)SequenceSequenceTextWrapper iter_parsemeasure_lengthct\rSrSrSrSrSr\S5r\S5r \S5r Sr \ S S j5r S rg ) Termcapz7Terminal capability of given variable name and pattern.c6XlX lX0lSUlg)z Class initializer. :arg str name: name describing capability. :arg str pattern: regular expression string. :arg str attribute: :class:`~.Terminal` attribute used to build this terminal capability. N)namepattern attribute _re_compiled)selfrrrs D/var/www/html/venv/lib/python3.13/site-packages/blessed/sequences.py__init__Termcap.__init__s  " c SRUS9$)Nz&rformatrs r__repr__Termcap.__repr__%s7>>D>IIrc SRUS9$)z;Regular expression pattern for capability with named group.z(?P<{self.name}>{self.pattern})rrrs r named_patternTermcap.named_pattern)s177T7BBrc~URc%[R"UR5UlUR$)z3Compiled regular expression pattern for capability.)rrecompilerrs r re_compiledTermcap.re_compiled/s1    $ " 4<< 8D    rc(UR[;$)z*Whether capability causes cursor movement.)rrrs r will_moveTermcap.will_move6syy777rcSSSSSS.RUR5nUbU$SSS.RUR5nUb7[URR U5R S55nX2-$g)a Horizontal carriage adjusted by capability, may be negative. :rtype: int :arg str text: for capabilities *parm_left_cursor*, *parm_right_cursor*, provide the matching sequence text, its interpreted distance is returned. :returns: 0 except for matching ' ) cursor_left backspace cursor_righttab ascii_tab)parm_left_cursorparm_right_cursorr)getrintr#matchgroup)rtextvalueunits rhorizontal_distanceTermcap.horizontal_distance;s  #dii.   L!#!"  #dii.   ((..t4::1=>E< rc ^ Sm U(aSm U(aSm UcSOUnUS:XaU"U[R"U5U5$[R"U"U4U-65n U(dN[US- US-5H8n [U 5U ;dMU R [U 5T 5n U"XU5s $ U(a[R "SU 4SjU 5n O[R "SU 4S jU 5n U"XU5$) a Class factory builder for given capability definition. :arg str name: Variable name given for this pattern. :arg str capability: A unicode string representing a terminal capability to build for. When ``nparams`` is non-zero, it must be a callable unicode string (such as the result from ``getattr(term, 'bold')``. :arg str attribute: The terminfo(5) capability name by which this pattern is known. :arg int nparams: number of positional arguments for callable. :arg int numeric: Value to substitute into capability to when generating pattern :arg bool match_grouped: If the numeric pattern should be grouped, ``(\d+)`` when ``True``, ``\d+`` default. :arg bool match_any: When keyword argument ``nparams`` is given, *any* numeric found in output is suitable for building as pattern ``(\d+)``. Otherwise, only the first matching value of range *(numeric - 1)* through *(numeric + 1)* will be replaced by pattern ``(\d+)`` in builder. :arg bool match_optional: When ``True``, building of numeric patterns containing ``(\d+)`` will be built as optional, ``(\d+)?``. :rtype: blessed.sequences.Termcap :returns: Terminal capability instance for given capability definition z\d+z(\d+)z(\d+)?crr*c>T$Nx_numeric_regexs rTermcap.build..src>T$r@rArBs rrErFs~r)r!escaperangestrreplacesub) clsr capabilityrnparamsnumeric match_grouped match_anymatch_optional_outpnumrrDs @rbuild Termcap.buildYs8  %N &N"W a<tRYYz2I> > *wj7&:;<Wq['A+6s8u$#mmCHnEGti887 ffX'?GGffV%=uEG4),,r)rrrrN)rr=FFF)__name__ __module__ __qualname____firstlineno____doc__rrpropertyrr#r&r: classmethodrV__static_attributes__rArrr r spA !JCC !! 88<899>"2-2-rr c*\rSrSrSrSrSrSrSrg)rzDocstring overridden.c RX l[RR"X40UD6 g)zM Class initializer. This class supports the :meth:`~.Terminal.wrap` method. N)termtextwrap TextWrapperr)rwidthrckwargss rrSequenceTextWrapper.__init__s"  %%d 0)drop_whitespacer))rf isinstancer4 ValueErrorrtyperchasattrrjreversesubsequent_indentinitial_indentlenrstriplength_handle_long_wordappendpopjoin) rchunkslinesrcrjcur_linecur_lenindentrf chunk_lens r _wrap_chunks SequenceTextWrapper._wrap_chunkss ::?*TZZ"="=B D$457 7yy%d,=((@+/+?+? HG/4T++$:M:MFJJV,EVBZ.446"<2J$VBZ6==? &. (..vP -$&(2,!=!C!C!E!KRL Vchhx&889)f* rcUS:aSOXC- nUR(aURnUSnS=p[Xg5HRupU [U 5- n [ USU U5R 5n X:aUS:XaUS:Xa U S:XaU S:XaO OU nMT UR USU5 XxSUS'gU(d UR UR55 gg)a Sequence-aware :meth:`textwrap.TextWrapper._handle_long_word`. This method ensures that word boundaries are not broken mid-sequence, as standard python textwrap would incorrectly determine the length of a string containing sequences and wide characters it would also break these "words" that would be broken by hyphen (``-``), this implementation corrects both. This is done by mutating the passed arguments, removing items from 'reversed_chunks' and appending them to 'cur_line'. However, some characters (east-asian, emoji, etc.) cannot be split any less than 2 cells, so in the case of a width of 1, we have no choice but to allow those characters to flow outside of the given cell. r*r)rNr>)break_long_wordsrcrrsrrurwrx) rreversed_chunksr|r}rf space_leftrcchunkidxnxtr7_ seq_lengths rrv%SequenceTextWrapper._handle_long_words& !)Q   99D#B'EMC%d2s4y %eDSk48??A *!| saxJRSO3 OOE$3K ("'+OB   OOO//1 2r)rcN) rXrYrZr[r\rrrvr_rArrrrs=,\.3rrcv\rSrSrSrSrSSjrSSjrSSjrSr Sr SS jr SS jr SS jr S rSSjrSrg )riz A "sequence-aware" version of the base :class:`str` class. This unicode-derived class understands the effect of escape sequences of printable length, allowing a properly implemented :meth:`rjust`, :meth:`ljust`, :meth:`center`, and :meth:`length`. c>[R"X5nX#lU$)z Class constructor. :arg str sequence_text: A string that may contain sequences. :arg blessed.Terminal term: :class:`~.Terminal` instance. )r__new___term)rM sequence_textrcnews rrSequence.__new__ ss2  rc U[[S[UR5UR 5- 55[[ U55- 5-nSR X45$)a9 Return string containing sequences, left-adjusted. :arg int width: Total width given to left-adjust ``text``. If unspecified, the width of the attached terminal is used (default). :arg str fillchar: String for padding right-of ``text``. :returns: String of ``text``, left-aligned by ``width``. :rtype: str rkr4maxfloat __index__rursry)rrffillchar rightsides rljustSequence.ljustsXs eEOO- => ?5XCW W YY xx)**rc U[[S[UR5UR 5- 55[[ U55- 5-nSR X045$)a; Return string containing sequences, right-adjusted. :arg int width: Total width given to right-adjust ``text``. If unspecified, the width of the attached terminal is used (default). :arg str fillchar: String for padding left-of ``text``. :returns: String of ``text``, right-aligned by ``width``. :rtype: str rrkr)rrfrleftsides rrjustSequence.rjust&sXc eEOO- => ?5XCW WYYxx())rc [S[UR55UR5- 5S- nU[ [S[ R "U55[[U55- 5-nU[ [S[ R"U55[[U55- 5-nSRX@U45$)a4 Return string containing sequences, centered. :arg int width: Total width given to center ``text``. If unspecified, the width of the attached terminal is used (default). :arg str fillchar: String for padding left and right-of ``text``. :returns: String of ``text``, centered by ``width``. :rtype: str rr>rk) rrrrur4mathfloorrsceilry)rrfrsplitrrs rcenterSequence.center4sCu01DKKMABQFc djj' (E#h-,@ @BBs dii& '5X+? ? AA xx344rcSnSnUR5n[URUR55nUH/upgU(dU[ [ U5S5- nX4:a OX&- nM1 USR SU55-$)aW Truncate a string in a sequence-aware manner. Any printable characters beyond ``width`` are removed, while all sequences remain in place. Horizontal Sequences are first expanded by :meth:`padd`. :arg int width: The printable width to truncate the string to. :rtype: str :returns: String truncated to at most ``width`` printable characters. rkrc3<# UHupU(dMUv M g7fr@rA).0r7caps r $Sequence.truncate..`sHjCjs  )rrrpaddrrry)rrfoutput current_width target_width parsed_seqr7rs rtruncateSequence.truncateEs (  DIIK8 $IDWT]A!66  / NF $HjHHHHrc@[SURSS955$)uA Return the printable length of string containing sequences. Strings containing ``term.left`` or ``\b`` will cause "overstrike", but a length less than 0 is not ever returned. So ``_\b+`` is a length of 1 (displays as ``+``), but ``\b`` alone is simply a length of 0. Some characters may consume more than one cell, mainly those CJK Unified Ideographs (Chinese, Japanese, Korean) defined by Unicode as half or full-width characters. For example: >>> from blessed import Terminal >>> from blessed.sequences import Sequence >>> term = Terminal() >>> msg = term.clear + term.red(u'コンニチハ') >>> Sequence(msg, term).length() 10 .. note:: Although accounted for, strings containing sequences such as ``term.clear`` will not give accurate returns, it is not considered lengthy (a length of 0). c3L# UHn[[U5S5v M g7f)rN)rr)rw_chars rr"Sequence.length..}s O9Nv3wv**9Ns"$Trt)sumrrs rruSequence.lengthbs 6O9NOOOrNc@UR5RU5$)z Return string of sequences, leading and trailing whitespace removed. :arg str chars: Remove characters in chars instead of whitespace. :rtype: str :returns: string of sequences with leading and trailing whitespace removed. ) strip_seqsrtrcharss rrtSequence.strips &&u--rc@UR5RU5$)z Return string of all sequences and leading whitespace removed. :arg str chars: Remove characters in chars instead of whitespace. :rtype: str :returns: string of sequences with leading removed. )rlstriprs rrSequence.lstrip ''..rc@UR5RU5$)z Return string of all sequences and trailing whitespace removed. :arg str chars: Remove characters in chars instead of whitespace. :rtype: str :returns: string of sequences with trailing removed. )rrstriprs rrSequence.rstriprrc URSS9$)zv Return ``text`` stripped of only its terminal sequences. :rtype: str :returns: Text with terminal sequences removed Tr)rrs rrSequence.strip_seqssyyty$$rcSn[URU5HMup4U(dX#- nMURU5nUS:a USU-- nM3US:aUSUnM@U(aMIX#- nMO U$)z Return non-destructive horizontal movement as destructive spacing. :arg bool strip: Strip terminal sequences :rtype: str :returns: Text adjusted for horizontal movement rkr N)rrr:)rrtoutpr7rr8s rr Sequence.paddsw#DJJ5ID ++D1Eqye #FU|U 6 rrA)rr@)F)rXrYrZr[r\rrrrrrurtrrrrr_rArrrrs@  + *5"I:P:.//%rrc## URRU5H@nURnURU5nUS:XaUS4v M.X@RU4v MB g7f)z Generator yields (text, capability) for characters of ``text``. value for ``capability`` may be ``None``, where ``text`` is :class:`str` of length 1. Otherwise, ``text`` is a full matching sequence of given capability. MISMATCHN)_caps_compiled_anyfinditer lastgroupr6caps)rcr7r5rr8s rrrs\((11$7 D! : $- 4( ( 8sA!A#cx[[X55upU(a [U5$g![a gf=f)z[ .. deprecated:: 1.12.0. :rtype: int :returns: Length of the first sequence in the string r)nextrrs StopIteration)r7rcrNs rr r sD 4 67 t9    s ', 99)r\r!rrdrblessed._compatrblessed._capabilitiesr__all__objectr rerrrr rArrrsw, %= M x-fx-vh3(..h3b'22::xxxv)"  r