o P“hæôã@sÌdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZddlmZmZmZmZmZmZmZddlmZmZmZddlmZddlmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&dd l'm(Z(m)Z)m*Z*ej+dd …d kr†ej,Z-d Z.e  /¡d kr›d Z0ddl1Z2ddl3m4Z4n3dZ0ddl2Z2zddl5Z5ddl6Z6ddl7Z7Wne8yÍdZ9dj:e  /¡d ;e9¡dZGdd„de?ƒZ@Gdd„de  Add¡ƒZBdS)zAModule containing :class:`Terminal`, the primary API entry point.éNé)ÚCOLOR_DISTANCE_ALGORITHMS)ÚDEFAULT_ESCDELAYÚ _time_leftÚ _read_untilÚresolve_sequenceÚget_keyboard_codesÚget_leading_prefixesÚget_keyboard_sequences)ÚTermcapÚSequenceÚSequenceTextWrapper)Ú RGB_256TABLE) ÚCOLORSÚ COMPOUNDABLESÚFormattingStringÚNullCallableStringÚParameterizingStringÚFormattingOtherStringÚsplit_compoundÚresolve_attributeÚresolve_capability)ÚCAPABILITY_DATABASEÚCAPABILITIES_ADDITIVESÚCAPABILITIES_RAW_MIXINé)érTÚWindows)Úget_console_input_encodingF)ÚsetrawÚcbreakÚkbhitÚheightÚwidthzÏOne or more of the modules: 'termios', 'fcntl', and 'tty' are not found on your platform '{platform}'. The following methods of Terminal are dummy/no-op unless a deriving class overrides them: {tty_methods}.z, )ÚplatformÚ tty_methodsc@s4eZdZdZidd“dd“dd“dd “d d “d d “dd“dd“dd“dd“dd“dd“dd“dd“dd“dd “d!d"“d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2œ¥Zd²d5d6„Zd7d8„Zd9d:„Zd;d<„Zd=d>„Z d?d@„Z dAdB„Z e dCdD„ƒZ e dEdF„ƒZe dGdH„ƒZe dIdJ„ƒZe dKdL„ƒZe dMdN„ƒZe dOdP„ƒZedQdR„ƒZdSdT„ZdUdV„Zejd³dWdX„ƒZd´dYdZ„Zd´d[d\„Zd´d]d^„Zejd_d`„ƒZejdadb„ƒZdcdd„Z dedf„Z!e dgdh„ƒZ"e didj„ƒZ#e dkdl„ƒZ$e dmdn„ƒZ%e dodp„ƒZ&dqdr„Z'e dsdt„ƒZ(dudv„Z)dwdx„Z*dydz„Z+e d{d|„ƒZ,dµd~d„Z-e d€d„ƒZ.e d‚dƒ„ƒZ/e/j0d„dƒ„ƒZ/e d…d†„ƒZ1e1j0d‡d†„ƒZ1e dˆd‰„ƒZ2e dŠd‹„ƒZ3d¶ddŽ„Z4d¶dd„Z5d¶d‘d’„Z6d´d“d”„Z7d•d–„Z8d´d—d˜„Z9d´d™dš„Z:d´d›dœ„Z;ddž„Zd¤d¥„Z?d¦d§„Z@d´d¨d©„ZAejdªd«„ƒZBejd¬d­„ƒZCejd®d¯„ƒZDd3eEfd°d±„ZFd3S)¸ÚTerminala‚ An abstraction for color, style, positioning, and input in the terminal. This keeps the endless calls to ``tigetstr()`` and ``tparm()`` out of your code, acts intelligently when somebody pipes your output to a non-terminal, and abstracts over the complexity of unbuffered keyboard input. It uses the terminfo database to remain portable across terminal types. ÚsaveÚscÚrestoreÚrcÚ clear_eolÚelÚ clear_bolÚel1Ú clear_eosÚedÚenter_fullscreenÚsmcupÚexit_fullscreenÚrmcupÚmoveÚcupÚmove_yxÚmove_xÚhpaÚmove_yÚvpaÚ hide_cursorÚcivisÚ normal_cursorÚcnormÚ reset_colorsÚopÚnormalÚsgr0ÚreverseÚrevÚitalicÚsitmÚritmÚsshmÚrshmÚsmsoÚrmsoÚssubmÚrsubmÚssupmÚrsupmÚsmulÚrmulÚu6Úu7Úu8Úu9)Ú no_italicÚshadowÚ no_shadowÚstandoutÚ no_standoutÚ subscriptÚ no_subscriptÚ superscriptÚno_superscriptÚ underlineÚ no_underlineÚ cursor_reportÚcursor_requestÚterminal_answerbackÚterminal_enquireNFc Csfd|||fg|_d|_d|_||_d|_d|_d|_| ¡tr0|jdur0|p-t   |j¡|_ n |p:t j  dd¡p:d|_ d|_|durM|jrM|j d¡n|sR|jrUd|_|jr¥z t  |j |j¡Wn+t jy}zd |j |¡}t |¡|j |¡d|_ d|_WYd}~nd}~wwtdus—|j tkr›|j an t d |j tf¡| ¡| ¡| ¡dS) a© Initialize the terminal. :arg str kind: A terminal string as taken by :func:`curses.setupterm`. Defaults to the value of the ``TERM`` environment variable. .. note:: Terminals within a single process must share a common ``kind``. See :obj:`_CUR_TERM`. :arg file stream: A file-like object representing the Terminal output. Defaults to the original value of :obj:`sys.__stdout__`, like :func:`curses.initscr` does. If ``stream`` is not a tty, empty Unicode strings are returned for all capability values, so things like piping your program output to a pipe or file does not emit terminal sequences. :arg bool force_styling: Whether to force the emission of capabilities even if :obj:`sys.__stdout__` does not seem to be connected to a terminal. If you want to force styling to not happen, use ``force_styling=None``. This comes in handy if users are trying to pipe your output through something like ``less -r`` or build systems which support decoding of terminal sequences. z0parameters: kind=%r, stream=%r, force_styling=%rNTFÚTERMÚdumbzforce_styling is Nonez$Failed to setupterm(kind={0!r}): {1}zÃA terminal of kind "%s" has been requested; due to an internal python curses bug, terminal capabilities for a terminal of kind "%s" will continue to be returned for the remainder of this process.)ÚerrorsÚ_normalÚ_line_bufferedÚ_streamÚ _keyboard_fdÚ_init_descriptorÚ _is_a_ttyÚ_Terminal__init__streamsÚ IS_WINDOWSÚcursesÚget_termÚ_kindÚosÚenvironÚgetÚ _does_stylingÚis_a_ttyÚappendÚ does_stylingÚ setuptermÚerrorÚformatÚwarningsÚwarnÚ _CUR_TERMÚ#_Terminal__init__color_capabilitiesÚ_Terminal__init__capabilitiesÚ_Terminal__init__keycodes)ÚselfÚkindÚstreamÚ force_stylingÚerrÚmsg©rŠúK/var/www/html/env_mimamsha/lib/python3.10/site-packages/blessed/terminal.pyÚ__init__|sPÿ   €ûÿýÿ zTerminal.__init__c Csªd}|jdur tj|_t|jdƒs|j d¡n>t|jjƒs%|j d¡n1z|j ¡}WntyF}z|j d|¡WYd}~nd}~wwt   |¡|_ |j sV|j d¡|jtjtj fvr¡ztj  ¡|_Wnttfyƒ}z|j d|¡WYd}~n(d}~ww|js‘|j d¡d|_nt   |j¡s |j d¡d|_n|j d ¡||_|durÓz tj ¡|_WdStyÒ}z|j d |¡WYd}~dSd}~wwdS) NÚfilenozstream has no fileno methodzstream.fileno is not callablez5Unable to determine output stream file descriptor: %szstream not a TTYz4Unable to determine input stream file descriptor: %szOutput stream is not a TTYzInput stream is not a TTYz%Output stream is not a default streamz2Unable to determine __stdout__ file descriptor: %s)rkÚsysÚ __stdout__ÚhasattrrhryÚcallablerÚ ValueErrorrtÚisattyrnÚ __stderr__Ú __stdin__rlÚAttributeErrorrxrm)r„Ú stream_fdrˆrŠrŠr‹Ú__init__streamsÏsP   €ý  €ÿ   € €ÿýzTerminal.__init__streamscCsNd|_|js d|_dStstj d¡dvrd|_dStdt  d¡p"dƒ|_dS)NÚcie2000rÚ COLORTERM)Ú truecolorÚ24bitéÚcolorséÿÿÿÿ) Ú_color_distance_algorithmrzÚnumber_of_colorsrprtrurvÚmaxrqÚtigetnum©r„rŠrŠr‹Ú__init__color_capabilitiess   z#Terminal.__init__color_capabilitiescCs$tt|ƒƒt@D]}t||ƒqdS©N)ÚsetÚdirrÚdelattr)r„Úcached_color_caprŠrŠr‹Ú__clear_color_capabilities s ÿz#Terminal.__clear_color_capabilitiescCs t ¡|_t ¡D]\}\}}t|||ƒ|j|<q t ¡D]/\}\}}|jr'ó€z0Terminal.__init__capabilities..csr­r¦)Ú named_patternr¯rŠrŠr‹r³+s€  ÿz|(?P.)css |] \}}d |j¡VqdS)z({0})N)r}r®r¯rŠrŠr‹r³.s€ ÿz|(.))Ú collectionsÚ OrderedDictÚcapsrÚitemsr rrzÚgetattrÚbuildrrvÚreÚcompileÚjoinÚ caps_compiledÚ_caps_compiled_anyÚ_caps_unnamed_any)r„r±Ú attributer®Úkwdsr²rŠrŠr‹Ú__init__capabilitiess<  ÿ ÿ €ÿÿþÿ þzTerminal.__init__capabilitiesc Csâtƒ|_|j ¡D] \}}t|||ƒq t|ƒ|_t|jƒ|_t  ¡|_ |j durot r6t ƒp3t ¡p3d|_nt ¡p;d|_z t |j¡ƒ|_WdStyn}zt d |¡¡d|_t |j¡ƒ|_WYd}~dSd}~wwdS)NzUTF-8z3LookupError: {0}, defaulting to UTF-8 for keyboard.)rÚ _keycodesr¹Úsetattrr Ú_keymapr Ú_keymap_prefixesr¶ÚdequeÚ _keyboard_bufrlrprÚlocaleÚgetpreferredencodingÚ _encodingÚcodecsÚgetincrementaldecoderÚ_keyboard_decoderÚ LookupErrorr~rr})r„Úkey_codeÚkey_namerˆrŠrŠr‹Ú__init__keycodes2s.    ÿÿ€üôzTerminal.__init__keycodescCs&|jstƒSt||ƒ}t|||ƒ|S)ay Return a terminal capability as Unicode string. For example, ``term.bold`` is a unicode string that may be prepended to text to set the video attribute for bold, which should also be terminated with the pairing :attr:`normal`. This capability returns a callable, so you can use ``term.bold("hi")`` which results in the joining of ``(term.bold, "hi", term.normal)``. Compound formatters may also be used. For example:: >>> term.bold_blink_red_on_green("merry x-mas!") For a parameterized capability such as ``move`` (or ``cup``), pass the parameters as positional arguments:: >>> term.move(line, column) See the manual page `terminfo(5) `_ for a complete list of capabilities and their arguments. )rwrrrÆ)r„ÚattrÚvalrŠrŠr‹Ú __getattr__Vs   zTerminal.__getattr__cCó|jS)zl Read-only property: Terminal kind determined on class initialization. :rtype: str )rsr¤rŠrŠr‹r…xóz Terminal.kindcCrØ)zk Read-only property: Whether this class instance may emit sequences. :rtype: bool )rwr¤rŠrŠr‹rzrÙzTerminal.does_stylingcCrØ)zc Read-only property: Whether :attr:`~.stream` is a terminal. :rtype: bool )rnr¤rŠrŠr‹rxŠrÙzTerminal.is_a_ttycCó | ¡jS)zg Read-only property: Height of the terminal (in number of lines). :rtype: int )Ú_height_and_widthÚws_rowr¤rŠrŠr‹r"“ó zTerminal.heightcCrÚ)zh Read-only property: Width of the terminal (in number of columns). :rtype: int )rÛÚws_colr¤rŠrŠr‹r#œrÝzTerminal.widthcCrÚ)z] Read-only property: Height ofthe terminal (in pixels). :rtype: int )rÛÚ ws_ypixelr¤rŠrŠr‹Ú pixel_height¥rÝzTerminal.pixel_heightcCrÚ)zY Read-only property: Width of terminal (in pixels). :rtype: int )rÛÚ ws_xpixelr¤rŠrŠr‹Ú pixel_width®rÝzTerminal.pixel_widthcCs8trt |tjtj¡}tt tj |¡ŽStdddddS)aÛ Return named tuple describing size of the terminal by ``fd``. If the given platform does not have modules :mod:`termios`, :mod:`fcntl`, or :mod:`tty`, window size of 80 columns by 25 rows is always returned. :arg int fd: file descriptor queries for its window size. :raises IOError: the file descriptor ``fd`` is not a terminal. :rtype: WINSZ :returns: named tuple describing size of the terminal WINSZ is a :class:`collections.namedtuple` instance, whose structure directly maps to the return value of the :const:`termios.TIOCGWINSZ` ioctl return value. The return parameters are: - ``ws_row``: width of terminal by its number of character cells. - ``ws_col``: height of terminal by its number of character cells. - ``ws_xpixel``: width of terminal by pixels (not accurate). - ``ws_ypixel``: height of terminal by pixels (not accurate). ééPr©rÜrÞrárß) ÚHAS_TTYÚfcntlÚioctlÚtermiosÚ TIOCGWINSZÚWINSZÚ_BUFÚstructÚunpackÚ_FMT)ÚfdÚdatarŠrŠr‹Ú_winsize·szTerminal._winsizec Csp|jtjfD]}z|dur| |¡WSWqttttfy#Yqwtt t   dd¡ƒt t   dd¡ƒdddS)a~ Return a tuple of (terminal height, terminal width). If :attr:`stream` or :obj:`sys.__stdout__` is not a tty or does not support :func:`fcntl.ioctl` of :const:`termios.TIOCGWINSZ`, a window size of 80 columns by 25 rows is returned for any values not represented by environment variables ``LINES`` and ``COLUMNS``, which is the default text mode of IBM PC compatibles. :rtype: WINSZ :returns: Named tuple specifying the terminal size WINSZ is a :class:`collections.namedtuple` instance, whose structure directly maps to the return value of the :const:`termios.TIOCGWINSZ` ioctl return value. The return parameters are: - ``ws_row``: height of terminal by its number of cell rows. - ``ws_col``: width of terminal by its number of cell columns. - ``ws_xpixel``: width of terminal by pixels (not accurate). - ``ws_ypixel``: height of terminal by pixels (not accurate). .. note:: the peculiar (height, width, width, height) order, which matches the return order of TIOCGWINSZ! NÚLINESÚ25ÚCOLUMNSÚ80rå) rmrŽrròÚIOErrorÚOSErrorr’Ú TypeErrorrëÚintrtÚgetenv)r„rðrŠrŠr‹rÛÔsÿÿýzTerminal._height_and_widthc Cs¨d}zD|jr| ¡}| ¡|j |¡|j ¡t|||d\}}|r4|d| ¡…|| ¡d…}|  |¡W|durE|  ddd¡|S|durS|  ddd¡ww)au Sends a query string to the terminal and waits for a response. :arg str query_str: Query string written to output :arg str response_re: Regular expression matching query response :arg float timeout: Return after time elapsed in seconds :return: re.match object for response_re or None if not found :rtype: re.Match N)Útermr®Útimeout) rjr Ú __enter__r†ÚwriteÚflushrÚstartÚendÚungetchÚ__exit__)r„Ú query_strÚ response_rerýÚctxÚmatchrñrŠrŠr‹Ú_query_responseùs(   þ  ýÿzTerminal._query_responsec cs¶|j |j¡|dur|dur|j | ||¡¡n|dur)|j | |¡¡n |dur6|j | |¡¡z|j ¡dVW|j |j¡|j ¡dS|j |j¡|j ¡w)a’ Context manager for temporarily moving the cursor. :arg int x: horizontal position, from left, *0*, to right edge of screen, *self.width - 1*. :arg int y: vertical position, from top, *0*, to bottom of screen, *self.height - 1*. :return: a context manager. :rtype: Iterator Move the cursor to a certain position on entry, do any kind of I/O, and upon exit let you print stuff there, then return the cursor to its original position: .. code-block:: python term = Terminal() with term.location(y=0, x=0): for row_num in range(term.height-1): print('Row #{row_num}') print(term.clear_eol + 'Back to original location.') Specify ``x`` to move to a certain column, ``y`` to move to a certain row, both, or neither. If you specify neither, only the saving and restoration of cursor position will happen. This can be useful if you simply want to restore your place after doing some manual cursor movement. Calls cannot be nested: only one should be entered at a time. .. note:: The argument order *(x, y)* differs from the return value order *(y, x)* of :meth:`get_location`, or argument order *(y, x)* of :meth:`move`. This is for API Compaibility with the blessings library, sorry for the trouble! N)r†rÿr'r5r8r:rr)©r„ÚxÚyrŠrŠr‹Úlocation%s€& ÿ zTerminal.locationcCspt||jdjƒp d}| |jpd|jdj|¡}|r6dd„| ¡Dƒ\}}d|vr2|d8}|d8}||fSdS) aÑ Return tuple (row, column) of cursor position. :arg float timeout: Return after time elapsed in seconds with value ``(-1, -1)`` indicating that the remote end did not respond. :rtype: tuple :returns: cursor position as tuple in form of ``(y, x)``. When a timeout is specified, always ensure the return value is checked for ``(-1, -1)``. The location of the cursor is determined by emitting the ``u7`` terminal capability, or VT100 `Query Cursor Position `_ when such capability is undefined, which elicits a response from a reply string described by capability ``u6``, or again VT100's definition of ``\x1b[%i%d;%dR`` when undefined. The ``(y, x)`` return value matches the parameter order of the :meth:`move_yx` capability. The following sequence should cause the cursor to not move at all:: >>> term = Terminal() >>> term.move_yx(*term.get_location())) And the following should assert True with a terminal: >>> term = Terminal() >>> given_y, given_x = 10, 20 >>> with term.location(y=given_y, x=given_x): ... result_y, result_x = term.get_location() ... >>> assert given_x == result_x, (given_x, result_x) >>> assert given_y == result_y, (given_y, result_y) rbz [%i%d;%dRzcss|]}t|ƒVqdSr¦©rú©r°rÖrŠrŠr‹r³’s€z(Terminal.get_location..z%ir)rŸrŸ)rºr¸rÂr rTÚ re_compiledÚgroups)r„rýÚ response_strrÚrowÚcolrŠrŠr‹Ú get_locationZs1ÿ zTerminal.get_locationcCó2| dt d¡|¡}|rtdd„| ¡DƒƒSdS)aN Return tuple (r, g, b) of foreground color. :arg float timeout: Return after time elapsed in seconds with value ``(-1, -1, -1)`` indicating that the remote end did not respond. :rtype: tuple :returns: foreground color as tuple in form of ``(r, g, b)``. When a timeout is specified, always ensure the return value is checked for ``(-1, -1, -1)``. The foreground color is determined by emitting an `OSC 10 color query `_. z]10;?z6]10;rgb:([0-9a-fA-F]+)/([0-9a-fA-F]+)/([0-9a-fA-F]+)csó|]}t|dƒVqdS©éNrrrŠrŠr‹r³¸r´z'Terminal.get_fgcolor..©rŸrŸrŸ©r r¼r½Útupler©r„rýrrŠrŠr‹Ú get_fgcolor¥ó  ýzTerminal.get_fgcolorcCr)aN Return tuple (r, g, b) of background color. :arg float timeout: Return after time elapsed in seconds with value ``(-1, -1, -1)`` indicating that the remote end did not respond. :rtype: tuple :returns: background color as tuple in form of ``(r, g, b)``. When a timeout is specified, always ensure the return value is checked for ``(-1, -1, -1)``. The background color is determined by emitting an `OSC 11 color query `_. z]11;?z6]11;rgb:([0-9a-fA-F]+)/([0-9a-fA-F]+)/([0-9a-fA-F]+)csrrrrrŠrŠr‹r³Ír´z'Terminal.get_bgcolor..rrrrŠrŠr‹Ú get_bgcolorºrzTerminal.get_bgcolorc cóZ|j |j¡|j ¡zdVW|j |j¡|j ¡dS|j |j¡|j ¡w)aZ Context manager that switches to secondary screen, restoring on exit. Under the hood, this switches between the primary screen buffer and the secondary one. The primary one is saved on entry and restored on exit. Likewise, the secondary contents are also stable and are faithfully restored on the next entry:: with term.fullscreen(): main() .. note:: There is only one primary and one secondary screen buffer. :meth:`fullscreen` calls cannot be nested, only one should be entered at a time. N)r†rÿr1rr3r¤rŠrŠr‹Ú fullscreenÏs€ ÿ zTerminal.fullscreenc cr!)a Context manager that hides the cursor, setting visibility on exit. with term.hidden_cursor(): main() .. note:: :meth:`hidden_cursor` calls cannot be nested: only one should be entered at a time. N)r†rÿr<rr>r¤rŠrŠr‹Ú hidden_cursorès€ ÿ zTerminal.hidden_cursorcCs | ||¡S)až A callable string that moves the cursor to the given ``(x, y)`` screen coordinates. :arg int x: horizontal position, from left, *0*, to right edge of screen, *self.width - 1*. :arg int y: vertical position, from top, *0*, to bottom of screen, *self.height - 1*. :rtype: ParameterizingString :returns: Callable string that moves the cursor to the given coordinates ©r5r rŠrŠr‹Úmove_xyûs zTerminal.move_xycCs | ||¡S)až A callable string that moves the cursor to the given ``(y, x)`` screen coordinates. :arg int y: vertical position, from top, *0*, to bottom of screen, *self.height - 1*. :arg int x: horizontal position, from left, *0*, to right edge of screen, *self.width - 1*. :rtype: ParameterizingString :returns: Callable string that moves the cursor to the given coordinates r$)r„r r rŠrŠr‹r7 ó zTerminal.move_yxcCót|jt|jƒƒS)zBMove cursor 1 cells to the left, or callable string for n>1 cells.)rÚcub1rÚcubr¤rŠrŠr‹Ú move_leftózTerminal.move_leftcCr')zKMove cursor 1 or more cells to the right, or callable string for n>1 cells.)rÚcuf1rÚcufr¤rŠrŠr‹Ú move_rightr+zTerminal.move_rightcCr')zFMove cursor 1 or more cells upwards, or callable string for n>1 cells.)rÚcuu1rÚcuur¤rŠrŠr‹Úmove_upr+zTerminal.move_upcCr')zHMove cursor 1 or more cells downwards, or callable string for n>1 cells.)rÚcud1rÚcudr¤rŠrŠr‹Ú move_down$r+zTerminal.move_downcCó|jr t|j|jdƒStƒS)a A callable string that sets the foreground color. :rtype: ParameterizingString The capability is unparameterized until called and passed a number, at which point it returns another string which represents a specific color change. This second string can further be called to color a piece of text and set everything back to normal afterward. This should not be used directly, but rather a specific color by name or :meth:`~.Terminal.color_rgb` value. Úcolor)rzrÚ_foreground_colorrBrr¤rŠrŠr‹r6)szTerminal.colorcCóD|jdkrd |||¡}t||jƒS| |||¡}t| |¡|jƒS)aá Provides callable formatting string to set foreground color to the specified RGB color. :arg int red: RGB value of Red. :arg int green: RGB value of Green. :arg int blue: RGB value of Blue. :rtype: FormattingString :returns: Callable string that sets the foreground color If the terminal does not support RGB color, the nearest supported color will be determined using :py:attr:`color_distance_algorithm`. rz[38;2;{0};{1};{2}m)r¡r}rrBÚrgb_downconvertr7©r„ÚredÚgreenÚblueÚfmt_attrÚ color_idxrŠrŠr‹Ú color_rgb<s  zTerminal.color_rgbcCr5)zm A callable capability that sets the background color. :rtype: ParameterizingString Úon_color)rzrÚ_background_colorrBrr¤rŠrŠr‹rARszTerminal.on_colorcCr8)aá Provides callable formatting string to set background color to the specified RGB color. :arg int red: RGB value of Red. :arg int green: RGB value of Green. :arg int blue: RGB value of Blue. :rtype: FormattingString :returns: Callable string that sets the foreground color If the terminal does not support RGB color, the nearest supported color will be determined using :py:attr:`color_distance_algorithm`. rz[48;2;{0};{1};{2}m)r¡r}rrBr9rBr:rŠrŠr‹Ú on_color_rgb^s  zTerminal.on_color_rgbcCs*t|ƒ}tdd„|Dƒƒrt||ƒStƒS)aö Provides callable formatting string to set color and other text formatting options. :arg str value: Sugary, ordinary, or compound formatted terminal capability, such as "red_on_white", "normal", "red", or "bold_on_black". :rtype: :class:`FormattingString` or :class:`NullCallableString` :returns: Callable string that sets color and other text formatting options Calling ``term.formatter('bold_on_red')`` is equivalent to ``term.bold_on_red``, but a string that is not a valid text formatter will return a :class:`NullCallableString`. This is intended to allow validation of text formatters without the possibility of inadvertently returning another terminal capability. css |] }|tvp |tvVqdSr¦)rr)r°ÚfmtrŠrŠr‹r³‚s€z%Terminal.formatter..)rÚallrºr)r„ÚvalueÚ formattersrŠrŠr‹Ú formatterrs zTerminal.formatterc Cs`t|j}d}d}ttƒD] \}}|||||fƒ} |dus!| |kr%| }|}||jkr-|Sq |S)a: Translate an RGB color to a color code of the terminal's color depth. :arg int red: RGB value of Red (0-255). :arg int green: RGB value of Green (0-255). :arg int blue: RGB value of Blue (0-255). :rtype: int :returns: Color code of downconverted RGB color éN)rÚcolor_distance_algorithmÚ enumeraterr¡) r„r;r<r=Ú fn_distancer?Úshortest_distanceÚ cmp_depthÚcmp_rgbÚ cmp_distancerŠrŠr‹r9‡s  þzTerminal.rgb_downconvertcCs|jr|jSt|dƒ|_|jS)a0 A capability that resets all video attributes. :rtype: str ``normal`` is an alias for ``sgr0`` or ``exit_attribute_mode``. Any styling attributes previously applied, such as foreground or background colors, reverse video, or bold are reset to defaults. rB)rirr¤rŠrŠr‹rB£s  zTerminal.normalÚcCslt|ƒdksJt|ƒ|fƒ‚|r(tt|ƒƒdks"Jtt|ƒƒ|fƒ‚d |¡}nd}|js/|Sd |||¡S)aŒ Display ``text`` that when touched or clicked, navigates to ``url``. Optional ``url_id`` may be specified, so that non-adjacent cells can reference a single target, all cells painted with the same "id" will highlight on hover, rather than any individual one, as described in "Hovering and underlining the id parameter" of gist https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda. :param str url: Hyperlink URL. :param str text: Clickable text. :param str url_id: Optional 'id'. :rtype: str :returns: String of ``text`` as a hyperlink to ``url``. iÐéúzid={0}rQz]8;{0};{1}\{2}]8;;\)ÚlenÚstrr}rz)r„ÚurlÚtextÚurl_idÚparamsrŠrŠr‹Úlink³s$  ÿz Terminal.linkcCrØ)a Read-only property: stream the terminal outputs to. This is a convenience attribute. It is used internally for implied writes performed by context managers :meth:`~.hidden_cursor`, :meth:`~.fullscreen`, :meth:`~.location`, and :meth:`~.keypad`. )rkr¤rŠrŠr‹r†Ís zTerminal.streamcCrØ)a< Number of colors supported by terminal. Common return values are 0, 8, 16, 256, or 1 << 24. This may be used to test whether the terminal supports colors, and at what depth, if that's a concern. If this property is assigned a value of 88, the value 16 will be saved. This is due to the the rarity of 88 color support and the inconsistency of behavior between implementations. Assigning this property to a value other than 0, 4, 8, 16, 88, 256, or 1 << 24 will raise an :py:exc:`AssertionError`. )Ú_number_of_colorsr¤rŠrŠr‹r¡ØszTerminal.number_of_colorscCs*|dvsJ‚|dkr dn||_| ¡dS)N)rééréXérr]r)rZÚ#_Terminal__clear_color_capabilities©r„rFrŠrŠr‹r¡ês  cCrØ)zÜ Color distance algorithm used by :meth:`rgb_downconvert`. The slowest, but most accurate, 'cie2000', is default. Other available options are 'rgb', 'rgb-weighted', 'cie76', and 'cie94'. )r r¤rŠrŠr‹rJòsz!Terminal.color_distance_algorithmcCs|tvsJ‚||_| ¡dSr¦)rr r_r`rŠrŠr‹rJüs  cCó |jp|jS)aA Convenience capability to support :attr:`~.on_color`. Prefers returning sequence for capability ``setaf``, "Set foreground color to #1, using ANSI escape". If the given terminal does not support such sequence, fallback to returning attribute ``setf``, "Set foreground color #1". )ÚsetafÚsetfr¤rŠrŠr‹r7r&zTerminal._foreground_colorcCra)aA Convenience capability to support :attr:`~.on_color`. Prefers returning sequence for capability ``setab``, "Set background color to #1, using ANSI escape". If the given terminal does not support such sequence, fallback to returning attribute ``setb``, "Set background color #1". )ÚsetabÚsetbr¤rŠrŠr‹rB r&zTerminal._background_colorú cCó |dur|j}t||ƒ ||¡S)a˜ Left-align ``text``, which may contain terminal sequences. :arg str text: String to be aligned :arg int width: Total width to fill with aligned text. If unspecified, the whole width of the terminal is filled. :arg str fillchar: String for padding the right of ``text`` :rtype: str :returns: String of ``text``, left-aligned by ``width``. N)r#r Úljust©r„rVr#ÚfillcharrŠrŠr‹rhs zTerminal.ljustcCrg)a— Right-align ``text``, which may contain terminal sequences. :arg str text: String to be aligned :arg int width: Total width to fill with aligned text. If unspecified, the whole width of the terminal is used. :arg str fillchar: String for padding the left of ``text`` :rtype: str :returns: String of ``text``, right-aligned by ``width``. N)r#r ÚrjustrirŠrŠr‹rk)ó zTerminal.rjustcCrg)a• Center ``text``, which may contain terminal sequences. :arg str text: String to be centered :arg int width: Total width in which to center text. If unspecified, the whole width of the terminal is used. :arg str fillchar: String for padding the left and right of ``text`` :rtype: str :returns: String of ``text``, centered by ``width`` N)r#r ÚcenterrirŠrŠr‹rm8rlzTerminal.centercCs|dur|j}t||ƒ |¡S)az Truncate ``text`` to maximum ``width`` printable characters, retaining terminal sequences. :arg str text: Text to truncate :arg int width: The maximum width to truncate it to :rtype: str :returns: ``text`` truncated to at most ``width`` printable characters >>> term.truncate(u'xyz\x1b[0;3m', 2) u'xy\x1b[0;3m' N)r#r Útruncate)r„rVr#rŠrŠr‹rnGs zTerminal.truncatecCót||ƒ ¡S)u¤ Return printable length of a string containing sequences. :arg str text: String to measure. May contain terminal sequences. :rtype: int :returns: The number of terminal character cells the string will occupy when printed Wide characters that consume 2 character cells are supported: >>> term = Terminal() >>> term.length(term.clear + term.red(u'コンニãƒãƒ')) 10 .. note:: Sequences such as 'clear', which is considered as a "movement sequence" because it would move the cursor to (y, x)(0, 0), are evaluated as a printable length of *0*. )r Úlength©r„rVrŠrŠr‹rpWszTerminal.lengthcCót||ƒ |¡S)zë Return ``text`` without sequences and leading or trailing whitespace. :rtype: str :returns: Text with leading and trailing whitespace removed >>> term.strip(u' \x1b[0;3m xyz ') u'xyz' )r Ústrip©r„rVÚcharsrŠrŠr‹rsmó zTerminal.stripcCrr)zö Return ``text`` without terminal sequences or trailing whitespace. :rtype: str :returns: Text with terminal sequences and trailing whitespace removed >>> term.rstrip(u' \x1b[0;3m xyz ') u' xyz' )r ÚrstriprtrŠrŠr‹rwyrvzTerminal.rstripcCrr)zó Return ``text`` without terminal sequences or leading whitespace. :rtype: str :returns: Text with terminal sequences and leading whitespace removed >>> term.lstrip(u' \x1b[0;3m xyz ') u'xyz ' )r ÚlstriprtrŠrŠr‹rx…rvzTerminal.lstripcCro)aÜ Return ``text`` stripped of only its terminal sequences. :rtype: str :returns: Text with terminal sequences removed >>> term.strip_seqs(u'\x1b[0;3mxyz') u'xyz' >>> term.strip_seqs(term.cuf(5) + term.red(u'test')) u' test' .. note:: Non-destructive sequences that adjust horizontal distance (such as ``\b`` or ``term.cuf(5)``) are replaced by destructive space or erasing. )r Ú strip_seqsrqrŠrŠr‹ry‘szTerminal.strip_seqsrcCsl|j}g}tt ||¡ƒD]&\}}| | ¡¡|r3||kr3|| ¡d…}|r0|d|7<|Sq |S)a™ Return ``text`` split by individual character elements and sequences. :arg str text: String containing sequences :arg int maxsplit: When maxsplit is nonzero, at most maxsplit splits occur, and the remainder of the string is returned as the final element of the list (same meaning is argument for :func:`re.split`). :rtype: list[str] :returns: List of sequences and individual characters >>> term.split_seqs(term.underline(u'xyz')) ['\x1b[4m', 'x', 'y', 'z', '\x1b(B', '\x1b[m'] >>> term.split_seqs(term.underline(u'xyz'), 1) ['\x1b[4m', r'xyz\x1b(B\x1b[m'] NrŸ)rÁrKr¼ÚfinditerryÚgroupr)r„rVÚmaxsplitr®ÚresultÚidxrÚ remainingrŠrŠr‹Ú split_seqs£s €zTerminal.split_seqscKs\|dur|jn|}td||dœ|¤Ž}g}| ¡D]}| | ¡r(t| |¡ƒnd¡q|S)a¡ Text-wrap a string, returning a list of wrapped lines. :arg str text: Unlike :func:`textwrap.wrap`, ``text`` may contain terminal sequences, such as colors, bold, or underline. By default, tabs in ``text`` are expanded by :func:`string.expandtabs`. :arg int width: Unlike :func:`textwrap.wrap`, ``width`` will default to the width of the attached terminal. :arg \**kwargs: See :py:class:`textwrap.TextWrapper` :rtype: list :returns: List of wrapped lines See :class:`textwrap.TextWrapper` for keyword arguments that can customize wrapping behaviour. N)r#rü©rQrŠ)r#r Ú splitlinesÚextendrsÚiterÚwrap)r„rVr#ÚkwargsÚwrapperÚlinesÚlinerŠrŠr‹r…¿s  "z Terminal.wrapcCs,|jdusJ‚t |jd¡}|jj|ddS)aa Read, decode, and return the next byte from the keyboard stream. :rtype: unicode :returns: a single unicode character, or ``u''`` if a multi-byte sequence has not yet been fully received. This method name and behavior mimics curses ``getch(void)``, and it supports :meth:`inkey`, reading only one byte from the keyboard string at a time. This method should always return without blocking if called after :meth:`kbhit` has returned True. Implementors of alternate input stream methods should override this method. NrF)Úfinal)rlrtÚreadrÐÚdecode)r„ÚbyterŠrŠr‹ÚgetchØszTerminal.getchcCs|j |¡dS)z– Buffer input data to be discovered by next call to :meth:`~.inkey`. :arg str text: String to be buffered as keyboard input. N)rÊÚ extendleftrqrŠrŠr‹rìszTerminal.ungetchcCsžt ¡}dg}|jdur|jgng}trDz t |gg|¡\}}}Wnty@|dur>|t ¡|8}|dkr:Yqg}YnYnwnts|jdurKdS||kS)a" Return whether a keypress has been detected on the keyboard. This method is used by :meth:`inkey` to determine if a byte may be read using :meth:`getch` without blocking. The standard implementation simply uses the :func:`select.select` call on stdin. :arg float timeout: When ``timeout`` is 0, this call is non-blocking, otherwise blocking indefinitely until keypress is detected when None (default). When ``timeout`` is a positive number, returns after ``timeout`` seconds have elapsed (float). :rtype: bool :returns: True if a keypress is awaiting to be read on the keyboard attached to this terminal. When input is not a terminal, False is always returned. NrF)ÚtimerlræÚselectÚInterruptedError)r„rýÚstimeÚready_rÚcheck_rÚ_rŠrŠr‹r!ôs$ ùòæzTerminal.kbhitc có‚tr<|jdur`_. Decreasing the time resolution will reduce this to 10 ms, while increasing it, which is rarely done, will have a perceptable impact on the behavior. _`ncurses(3)`: https://www.man7.org/linux/man-pages/man3/ncurses.3x.html rQr)rýN)rrÊÚpopr!rŽrrÇrÅrÚcodeÚ KEY_ESCAPErÈrrS)r„rýÚ esc_delayr“ÚucsÚksÚesctimerŠrŠr‹Úinkey—s6$ÿ   ÿ þ   ÿ  ü ÿzTerminal.inkey)NNF)NNr¦r)Nrf)r)GÚ__name__Ú __module__Ú __qualname__Ú__doc__Ú_sugarrŒrorr_r‚rƒr×Úpropertyr…rzrxr"r#ràrâÚ staticmethodròrÛr Ú contextlibÚcontextmanagerr rrr r"r#r%r7r*r.r1r4r6r@rArCrHr9rBrYr†r¡ÚsetterrJr7rBrhrkrmrnrprsrwrxryr€r…rŽrr!r r¡r¤rr¬rŠrŠrŠr‹r&Ks ÿþýüûúùø ÷ ö õ ô óòñðïà #S2 $$"        %,  4 K                           4 / $ r&c@s"eZdZdZdZde e¡ZdS)rëaF Structure represents return value of :const:`termios.TIOCGWINSZ`. .. py:attribute:: ws_row rows, in characters .. py:attribute:: ws_col columns, in characters .. py:attribute:: ws_xpixel horizontal size, pixels .. py:attribute:: ws_ypixel vertical size, pixels ÚhhhhúN)r­r®r¯r°rïríÚcalcsizerìrŠrŠrŠr‹rëçsrërå)Cr°rtr¼rŽrrÎrËr‘rír$r~r´r¶r6rÚkeyboardrrrrrr r Ú sequencesr r r Ú colorspacerrGrrrrrrrrrÚ _capabilitiesrrrÚ version_infor|r’ræÚsystemrpÚjinxedrqÚ jinxed.win32rrçrér™Ú ImportErrorÚ _TTY_METHODSr}r¾Ú_MSG_NOSUPPORTrr€Úobjectr&Ú namedtuplerërŠrŠrŠr‹Úsp $ ,    ûÿ ö '