gf,E dZddlZddlZddlZddlmZddlZejdk(r ddlZ ddl m Z n ddl Z ddl m Z GddejZdZd Zd Zd Zd Zd ZdZdZdZeej5ZeD]Zedz Zeedez<gej<de j>fej<de j>fej<de j@fej<de!fej<de jDfej<de j@fde jFfde jHfde jJfde jLfde jNfde jPfde jRfd e jTfd!e jVfd"e jXfd#e jVfd$e jZfd%e j\fd&e j>fd'e/fd(e0fd)e1fd*e2fd+e3fd,e4fd-e5fd.e6fd/e7fd0e8fd1e9fd2e:fd3e;fd4efd7e?fd8e jfd9e jfd:e jfd;e jfde jXfd?e jVfd@e jFfdAe jHfdBe jJfdCe jLfdDe jVfdEe jXfdFe jfdGe jfdHe jfdIe jfZHdJe jfdKe jfdLe j\fdMe jZfdNe jDfdOe jNfdPe jPfdQe jfdRe jfdSe jfdTe jff ZMdUZNy)Vz*Sub-module providing 'keyboard awareness'.N) OrderedDictWindows)_capability_namesceZdZdZddZedZdZejje_edZ edZ y) Keystrokea A unicode-derived class for describing a single keystroke. A class instance describes a single keystroke received on input, which may contain multiple characters as a multibyte sequence, which is indicated by properties :attr:`is_sequence` returning ``True``. When the string is a known sequence, :attr:`code` matches terminal class attributes for comparison, such as ``term.KEY_LEFT``. The string-name of the sequence, such as ``u'KEY_LEFT'`` is accessed by property :attr:`name`, and is used by the :meth:`__repr__` method to display a human-readable form of the Keystroke this class instance represents. It may otherwise by joined, split, or evaluated just as as any other unicode string. Ncbtjj||}||_||_|S)zClass constructor.)six text_type__new___name_code)clsucscodenamenews h/var/dept/share/cheung/public_html/OutSchool/python/env/lib/python3.12/site-packages/blessed/keyboard.pyr zKeystroke.__new__*s+mm##C-   c|jduS)z9Whether the value represents a multibyte sequence (bool).Nr selfs r is_sequencezKeystroke.is_sequence1szz%%rcp|jtjj|S|jS)zDocstring overwritten.)r r r __repr__rs rrzKeystroke.__repr__6s.04 0B &&t,   rc|jS)z;String-name of key sequence, such as ``u'KEY_LEFT'`` (str).)r rs rrzKeystroke.name<zzrc|jS)z2Integer keycode value of multibyte sequence (int).rrs rrzKeystroke.codeArr)NN) __name__ __module__ __qualname____doc__r propertyrrr r rrrrrrs_$&&}},,H rrcttDcgc]}|jdr|}}|Dcic]}|tt|c}Scc}wcc}w)a1 Return mapping of curses key-names paired by their keycode integer value. :rtype: dict :returns: Dictionary of (name, code) pairs for curses keyboard constant values and their mnemonic name. Such as code ``260``, with the value of its key-name identity, ``u'KEY_LEFT'``. KEY_)dircurses startswithgetattr)attr _keynameskeynames rget_curses_keycodesr/GsU#&f+-$OOF+-I-=F G'GWVW- - GG- Gs A Ac,tt}|jt|jdt j j Dtt|j|jS)a? Return mapping of keycode integer values paired by their curses key-name. :rtype: dict :returns: Dictionary of (code, name) pairs for curses keyboard constant values and their mnemonic name. Such as key ``260``, with the value of its identity, ``u'KEY_LEFT'``. These keys are derived from the attributes by the same of the curses module, with the following exceptions: * ``KEY_DELETE`` in place of ``KEY_DC`` * ``KEY_INSERT`` in place of ``KEY_IC`` * ``KEY_PGUP`` in place of ``KEY_PPAGE`` * ``KEY_PGDOWN`` in place of ``KEY_NPAGE`` * ``KEY_ESCAPE`` in place of ``KEY_EXIT`` * ``KEY_SUP`` in place of ``KEY_SR`` * ``KEY_SDOWN`` in place of ``KEY_SF`` This function is the inverse of :func:`get_curses_keycodes`. With the given override "mixins" listed above, the keycode for the delete key will map to our imaginary ``KEY_DELETE`` mnemonic, effectively erasing the phrase ``KEY_DC`` from our code vocabulary for anyone that wishes to use the return value to determine the key-name by keycode. c3NK|]\}}|jds||fyw)r'N)r*).0rvalues r z%get_keyboard_codes..rs)%$T__U[E\u s% %) rr/updateCURSES_KEYCODE_OVERRIDE_MIXINglobalscopyitemsdictzipvalueskeys)keycodess rget_keyboard_codesr?Usk4.01H OO12 OO)0)9)?)?)A HOO%x}}7 88rci}|jr,|jdk7rtj||j<|jr,|jdk7rtj||j<|S)a Determine and return mapping of left and right arrow keys sequences. :arg blessed.Terminal term: :class:`~.Terminal` instance. :rtype: dict :returns: Dictionary of sequences ``term._cuf1``, and ``term._cub1``, valued as ``KEY_RIGHT``, ``KEY_LEFT`` (when appropriate). This function supports :func:`get_terminal_sequences` to discover the preferred input sequence for the left and right application keys. It is necessary to check the value of these sequences to ensure we do not use ``u' '`` and ``u'\b'`` for ``KEY_RIGHT`` and ``KEY_LEFT``, preferring their true application key sequence, instead.  )_cuf1r) KEY_RIGHT_cub1KEY_LEFT)termkeymaps r_alternative_left_rightrI{sX"F zzdjjD(#--tzz zzdjjE)#__tzz Mrc8t|jr"ddtjDDndj t |j t tfdtjtdDS)a Return mapping of keyboard sequences paired by keycodes. :arg blessed.Terminal term: :class:`~.Terminal` instance. :returns: mapping of keyboard unicode sequences paired by keycodes as integer. This is used as the argument ``mapper`` to the supporting function :func:`resolve_sequence`. :rtype: OrderedDict Initialize and return a keyboard map and sequence lookup table, (sequence, keycode) from :class:`~.Terminal` instance ``term``, where ``sequence`` is a multibyte input sequence of unicode characters, such as ``u'\x1b[D'``, and ``keycode`` is an integer value, matching curses constant such as term.KEY_LEFT. The return value is an OrderedDict instance, with their keys sorted longest-first. c3LK|]\}}|r|jd|fyw)latin1N)decode)r2seqvals rr4z)get_keyboard_sequences..s/ S# H s#s"$c3PK|]\}}tj||f ywN)r)tigetstr)r2rOcaps rr4z)get_keyboard_sequences..s* c__S !3 ' s$&r%c3,K|] }||f ywrQr%)r2rN sequence_maps rr4z)get_keyboard_sequences..s 9%(l3 9sT)keyreverse) r: does_stylingcapability_namesr9r5rIDEFAULT_SEQUENCE_MIXINrsortedr=len)rGrUs @rget_keyboard_sequencesr]s<     .446  !# $L/56./ 9,2    S$-89 ::rc l|Dchc]!}tdt|D]}|d| #c}}Scc}}w)a Return a set of proper prefixes for given sequence of strings. :arg iterable sequences :rtype: set :return: Set of all string prefixes Given an iterable of strings, all textparts leading up to the final string is returned as a unique set. This function supports the :meth:`~.Terminal.inkey` method by determining whether the given input is a sequence that **may** lead to a final matching pattern. >>> prefixes(['abc', 'abdf', 'e', 'jkl']) set([u'a', u'ab', u'abd', u'j', u'jk']) N)ranger\) sequencesrNis rget_leading_prefixesrcs5 ) E%3s82D EQCG EG EE Es&0c|jD])\}}|j|st||||cSt|xr|dxsdS)a Return a single :class:`Keystroke` instance for given sequence ``text``. :arg str text: string of characters received from terminal input stream. :arg OrderedDict mapper: unicode multibyte sequences, such as ``u'\x1b[D'`` paired by their integer value (260) :arg dict codes: a :type:`dict` of integer values (such as 260) paired by their mnemonic name, such as ``'KEY_LEFT'``. :rtype: Keystroke :returns: Keystroke instance for the given sequence The given ``text`` may extend beyond a matching sequence, such as ``u\x1b[Dxxx`` returns a :class:`Keystroke` instance of attribute :attr:`Keystroke.sequence` valued only ``u\x1b[D``. It is up to calls to determine that ``xxx`` remains unresolved. )rrrrr)r)r9r*r)textmappercodessequencers rresolve_sequencerisY"!,,.H$ ??8 $5;G GH )$q'0S 11rcR|r$td|tj|z z S|S)a Return time remaining since ``stime`` before given ``timeout``. This function assists determining the value of ``timeout`` for class method :meth:`~.Terminal.kbhit` and similar functions. :arg float stime: starting time for measurement :arg float timeout: timeout period, may be set to None to indicate no timeout (where None is always returned). :rtype: float or int :returns: time remaining as float. If no time is remaining, then the integer ``0`` is returned. r)maxtime)stimetimeouts r _time_leftros(7>3q'TYY[501 2J7Jrc tj}d\}} |jt||}|r||z }|jd}|rtj||}| ||fS|t||s ||fSj)a? Convenience read-until-pattern function, supporting :meth:`~.get_location`. :arg blessed.Terminal term: :class:`~.Terminal` instance. :arg float timeout: timeout period, may be set to None to indicate no timeout (where 0 is always returned). :arg str pattern: target regular expression pattern to seek. :rtype: tuple :returns: tuple in form of ``(match, str)``, *match* may be :class:`re.MatchObject` if pattern is discovered in input stream before timeout has elapsed, otherwise None. ``str`` is any remaining text received exclusive of the matching pattern). The reason a tuple containing non-matching data is returned, is that the consumer should push such data back into the input buffer by :meth:`~.Terminal.ungetch` if any was received. For example, when a user is performing rapid input keystrokes while its terminal emulator surreptitiously responds to this in-band sequence, we must ensure any such keyboard data is well-received by the next call to term.inkey() without delay. )Nr)rnr)patternstring)rlinkeyroresearch)rGrqrnrmmatchbufrs r _read_untilrxs0 IIKEJE3 jjE7!;j<  3JC**Q*'C '#6    #:  z%'A  #:+ r)TAB KP_MULTIPLYKP_ADD KP_SEPARATOR KP_SUBTRACT KP_DECIMAL KP_DIVIDEKP_EQUALKP_0KP_1KP_2KP_3KP_4KP_5KP_6KP_7KP_8KP_9r_r'  zzzzzzzzzzzzzzOMzOjzOkzOlzOmzOnzOozOXzOpzOqzOrzOszOtzOuzOvzOwzOxzOyz[1~z[2~z[3~z[4~z[5~z[6~z[7~z[8~zAzBzCzDzFzHzOPzOQzORzOS KEY_DELETE KEY_INSERTKEY_PGUP KEY_PGDOWN KEY_ESCAPEKEY_SUP KEY_SDOWN KEY_UP_LEFT KEY_UP_RIGHT KEY_CENTER KEY_BEGIN)rr?r])Or#rtrlplatform collectionsrr systemjinxedr)jinxed.has_keyrrYcurses.has_keyr rr/r?rIr]rcrirorx_CURSES_KEYCODE_ADDINSrkr<_LASTVAL keycode_namer7unichr KEY_ENTER KEY_BACKSPACEKEY_TABKEY_EXITKEY_UPKEY_DOWNrDrFKEY_SRKEY_SF KEY_SRIGHT KEY_SLEFTKEY_ENDKEY_HOME KEY_NPAGE KEY_PPAGEKEY_KP_MULTIPLY KEY_KP_ADDKEY_KP_SEPARATORKEY_KP_SUBTRACTKEY_KP_DECIMAL KEY_KP_DIVIDE KEY_KP_EQUALKEY_KP_0KEY_KP_1KEY_KP_2KEY_KP_3KEY_KP_4KEY_KP_5KEY_KP_6KEY_KP_7KEY_KP_8KEY_KP_9KEY_FINDKEY_ICKEY_DC KEY_SELECTKEY_F1KEY_F2KEY_F3KEY_F4rZKEY_A1KEY_A3KEY_B2KEY_BEGr6__all__r%rrrs0 # 8?? !DD- -` H#9L2.:bF&2.K"5@ ( "$++- .*0L MH'/GIf|#$0&HSZZ^V%%&HSZZ^V%%& H SZZ]F(() H SZZ]G HSZZ^V__%HSZZ_f**+H H H  !H H6==!H6==!H 6$$%!H"6##$#H$%H& 'H*+H,  !-H.  !/H<  !=H> ?H@ AHB !CHD EHFGHH IHJ KHLMHNOHPQHRSHTUHVWHXYHZ[H\]H^_Hd!eHfgHhiHj""#kHl!!"mHn!!"oHp!qHr sHtuHv!wHx!!"yHz!{H| }H~!HH IHJ KHL MHN OH\6==!6==!!!"6##$6??# &-- FMM"V]]#6==!&..! ! Ir