gfBdZddlZddlZddlZddlZddlmZddlmZdZGdde Z Gdd ejZ ejje _Gd d ejZd Zd Zy)z&Module providing 'sequence awareness'.N)wcwidth)CAPABILITIES_CAUSE_MOVEMENT)SequenceSequenceTextWrapper iter_parsemeasure_lengthcjeZdZdZdZdZedZedZedZ dZ e d dZ y ) Termcapz7Terminal capability of given variable name and pattern.c<||_||_||_d|_y)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)selfr r rs i/var/dept/share/cheung/public_html/OutSchool/python/env/lib/python3.12/site-packages/blessed/sequences.py__init__zTermcap.__init__s!  " c&dj|S)Nz&rformatrs r__repr__zTermcap.__repr__#s7>>D>IIrc&dj|S)z;Regular expression pattern for capability with named group.z(?P<{self.name}>{self.pattern})rrrs r named_patternzTermcap.named_pattern's177T7BBrcz|j$tj|j|_|jS)z3Compiled regular expression pattern for capability.)rrecompiler rs r re_compiledzTermcap.re_compiled-s1    $ " 4<< 8D    rc&|jtvS)z*Whether capability causes cursor movement.)r rrs r will_movezTermcap.will_move4syy777rcddddddj|j}||Sdddj|j}|8t|jj |j d}||zSy)aA 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)getr intrmatchgroup)rtextvalueunits rhorizontal_distancezTermcap.horizontal_distance9s  #dii.   L!#!"  #dii.   ((..t4::1=>E%< rc  d |rd |rd |dn|}|dk(r||tj||Stj||f|z} |sKt|dz |dzD]6} t| | vs| j t|  } ||| |cS|rtj d fd| } ntj d fd | } ||| |S) ak 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#cSNx_numeric_regexs rzTermcap.build..srcSr8r9r:s rr=zTermcap.build..s~r)rescaperangestrreplacesub) clsr capabilityrnparamsnumeric match_grouped match_anymatch_optional_outpnumr r<s @rbuildz Termcap.buildYs8  %N &N"W a<tRYYz2I> > *wj7&:;<Wq['A+6 9s8u$#mmCHnEGtWi88 9 ffX'?GGffV%=uEG4),,rN)rr5FFF) __name__ __module__ __qualname____doc__rrpropertyrrr r3 classmethodrMr9rrr r sqA !JCC !! 88@899>"2-2-rr c"eZdZdZdZdZdZy)rzDocstring overridden.c T||_tjj||fi|y)ze Class initializer. This class supports the :meth:`~.Terminal.wrap` method. N)termtextwrap TextWrapperr)rwidthrVkwargss rrzSequenceTextWrapper.__init__s&  %%dE 0)drop_whitespacer")rY isinstancer- ValueErrorrtyperVhasattrr\reversesubsequent_indentinitial_indentlenrstriplengthappendpop_handle_long_wordjoin) rchunkslinesrVr\cur_linecur_lenindentrY chunk_lens r _wrap_chunksz SequenceTextWrapper._wrap_chunkss ::?*TZZ"=B D$457 7yy%d,=((@+/+?+? HG/4T++$:M:MFJJV,EVBZ.446"<2J$VBZ6==? Y&. -9$  (6":t4;;=E&&vx%H(2,!=!C!C!E!KRL Vchhx&889)* rch|dkrdn||z }|jrx|j}|d}dx}} t||D]7\} } | t| z } t |d| |j |kDrn| }9|j |d|||d|d<y|s |j |jyy)a Sequence-aware :meth:`textwrap.TextWrapper._handle_long_word`. This simply ensures that word boundaries are not broken mid-sequence, as standard python textwrap would incorrectly determine the length of a string containing sequences, and may also break consider sequences part of a "word" that may be broken by hyphen (``-``), where this implementation corrects both. r#r"rN)break_long_wordsrVrrerrgrhri) rreversed_chunksrnrorY space_leftrVchunkidxnxtr0_s rrjz%SequenceTextWrapper._handle_long_words !)Q   99D#B'EMC#%dE2 as4y E$3K.557*D   OOE$3K ("'+OB   OOO//1 2rN)rNrOrPrQrrrrjr9rrrrs=,\3rrc`eZdZdZdZddZddZddZdZdZ dd Z dd Z dd Z d Z dd Zy)ra 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`. cTtjj||}||_|S)z Class constructor. :arg str sequence_text: A string that may contain sequences. :arg blessed.Terminal term: :class:`~.Terminal` instance. )six text_type__new___term)rD sequence_textrVnews rrzSequence.__new__s&mm##C7  rc |ttdt|j|j z tt |z z}dj ||fS)aq 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 r]r-maxfloat __index__rgrerk)rrYfillchar rightsides rljustzSequence.ljust sZs eEOO- => ?5XCW W YY xxy)**rc |ttdt|j|j z tt |z z}dj ||fS)as 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 rr]r)rrYrleftsides rrjustzSequence.rjustsZc eEOO- => ?5XCW WYYxx4())rc tdt|j|jz dz }|t tdt j |tt|z z}|t tdt j|tt|z z}dj|||fS)al 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 rr6r]) rrrrgr-mathfloorreceilrk)rrYrsplitrrs rcenterzSequence.center%sCu01DKKMABQFc djj' (E#h-,@ @BBs dii& '5X+? ? AA xx4344rcd}d}|j}t|j|j}|D]+\}}|s|t t |dz }||kDrn||z }-|dj d|DzS)a 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. r]rc3,K|] \}}|s |ywr8r9).0r0caps r z$Sequence.truncate..QsHsCHs )rrrpaddrrrk)rrYoutput current_width target_width parsed_seqr0rs rtruncatezSequence.truncate6s (  DIIK8 $ ID#WT]A!66  </ dNF  HjHHHHrcFtd|jdDS)u 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). c3FK|]}tt|dyw)rN)rr)rw_chars rrz"Sequence.length..nsOv3wv*Os!Trf)sumrrs rrgzSequence.lengthSs 6O9NOOOrNc@|jj|S)a  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_seqsrfrcharss rrfzSequence.stripps &&u--rc@|jj|S)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 rrzSequence.lstripz ''..rc@|jj|S)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 rrzSequence.rstriprrc&|jdS)z Return ``text`` stripped of only its terminal sequences. :rtype: str :returns: Text with terminal sequences removed Tr)rrs rrzSequence.strip_seqssyyty$$rcd}t|j|D]?\}}|s||z }|j|}|dkDr |d|zz }-|dkr|d|}8|r;||z }A|S)z Return non-destructive horizontal movement as destructive spacing. :arg bool strip: Strip terminal sequences :rtype: str :returns: Text adjusted for horizontal movement r]r N)rrr3)rrfoutpr0rr1s rrz Sequence.padds#DJJ5 ID# ++D1Eqye #FU|   r)rr8)F)rNrOrPrQrrrrrrgrfrrrrr9rrrrs@  + *5"I:P:.//%rrc#K|jj|D]>}|j}|j|}|dk(r|df,||j|f@yw)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 lastgroupr/caps)rVr0r.r r1s rrrsd((11$7) D! : $- 4( ( )sAA cp tt||\}}|r t|S y#t$rYywxYw)zk .. deprecated:: 1.12.0. :rtype: int :returns: Length of the first sequence in the string r)nextrre StopIteration)r0rVrEs rrrsH 4 67j t9    s $) 55)rQrrrWr}rblessed._capabilitiesr__all__objectr rXrr~rrrr9rrrs{,  > Mz-fz-zY3(..Y3D'22::xs}}xv)"  r