(phSrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK r SSK Jr SSKJrJrJrJrJrJrJr SSKJrJrJr SSKJr SSKJrJrJ r J!r!J"r"J#r#J$r$J%r%J&r& SS K'J(r(J)r)J*r* \RVSS S :a \RXr-S r.\ R^"5S :Xa S r0SSK1r2SSK3J4r4 OSr0SSK2r2SSK5r5SSK6r6SSK7r7Sq>"SS\?5r@"SS\ R"SS55rBg!\8aG Sr9SRu\ R^"5SRw\95S9r<\ Rz"\<5 Sr.Nvf=f)zAModule containing :class:`Terminal`, the primary API entry point.N)COLOR_DISTANCE_ALGORITHMS)DEFAULT_ESCDELAY _time_left _read_untilresolve_sequenceget_keyboard_codesget_leading_prefixesget_keyboard_sequences)TermcapSequenceSequenceTextWrapper) RGB_256TABLE) COLORS COMPOUNDABLESFormattingStringNullCallableStringParameterizingStringFormattingOtherStringsplit_compoundresolve_attributeresolve_capability)CAPABILITY_DATABASECAPABILITIES_ADDITIVESCAPABILITIES_RAW_MIXIN)rTWindows)get_console_input_encodingF)setrawcbreakkbhitheightwidthzOne 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\rSrSrSr0SS_SS_SS_S S _S S _S S_SS_SS_SS_SS_SS_SS_SS_SS_SS_S S!_S"S#_S$S%S&S'S(S)S*S+S,S-S.S/S0S1S2S3.ErStS5jrS6rS7rS8r S9r S:r S;r \ S<5r\ S=5r\ S>5r\ S?5r\ S@5r\ SA5r\ SB5r\SC5rSDrSEr\R4SuSFj5rSvSGjrSvSHjrSvSIjr\R4SJ5r\R4SK5r SLr!SMr"\ SN5r#\ SO5r$\ SP5r%\ SQ5r&\ SR5r'SSr(\ ST5r)SUr*SVr+SWr,\ SX5r-SwSYjr.\ SZ5r/\ S[5r0\0RbS\5r0\ S]5r2\2RbS^5r2\ S_5r3\ S`5r4SxSajr5SxSbjr6SxScjr7SvSdjr8Ser9SvSfjr:SvSgjr;SvShjrSvSkjr?Slr@SmrASvSnjrB\R4So5rC\R4Sp5rD\R4Sq5rES4\F4SrjrGSsrHg4)zTerminalKaj 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. savescrestorerc clear_eolel clear_bolel1 clear_eosedenter_fullscreensmcupexit_fullscreenrmcupmovecupmove_yxmove_xhpamove_yvpa hide_cursorcivis normal_cursorcnorm reset_colorsopnormalsgr0reverserevitalicsitmritmsshmrshmsmsormsossubmrsubmssupmrsupmsmulrmulu6u7u8u9) no_italicshadow no_shadowstandout no_standout subscript no_subscript superscriptno_superscript underline no_underline cursor_reportcursor_requestterminal_answerbackterminal_enquireNcSU<SU<SU<3/UlSUlSUlX lSUlSUlSUlUR5 [(a<UR b/U=(d [R"UR 5Ul O7U=(d) [RRSS5=(d SUl SUlUc-UR (aURR#S 5 OU(dUR (aSUlUR$(a[R&"URUR 5 [(bUR[(:Xa URqO.[*R,"S UR<S [(<S 35 UR35 UR55 UR75 g![R.aenS R1URU5n[*R,"U5 URR#U5 SUl SUlSnANSnAff=f)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. zparameters: kind=z , stream=z, force_styling=NTFTERMdumbzforce_styling is NonezA terminal of kind "zj" has been requested; due to an internal python curses bug, terminal capabilities for a terminal of kind "zA" will continue to be returned for the remainder of this process.z$Failed to setupterm(kind={0!r}): {1})errors_normal_line_buffered_stream _keyboard_fd_init_descriptor _is_a_tty_Terminal__init__streams IS_WINDOWScursesget_term_kindosenvironget _does_stylingis_a_ttyappend does_styling setupterm _CUR_TERMwarningswarnerrorformat#_Terminal__init__color_capabilities_Terminal__init__capabilities_Terminal__init__keycodes)selfkindstream force_stylingerrmsgs C/var/www/html/venv/lib/python3.13/site-packages/blessed/terminal.py__init__Terminal.__init__|s<fm56  #   $  :$//;G1F1F!GDJI!?I6DJ"  T]] KK  6 7 dmm!%D     5  T-B-BC$ i(? $ IMM !JJ 45 '') !!# 1<< +<CCDJJPST c" ""3'! %*""  +s4+G&&I:AIIcxSnURc[RUl[URS5(dURR S5 O[ URR5(dURR S5 ObURR5n[R"U5Ul UR(dURR S5 UR[R[R4;a[RR5UlUR(d#URR S5 SUlOc[R"UR5(d"URR S5 SUlOURR S 5 XlUc%[RR5Ulgg![a)nURR SU-5 SnAGNFSnAff=f![ [4a(nURR SU-5 SnANSnAff=f![a(nURR S U-5 SnAgSnAff=f) Nfilenozstream has no fileno methodzstream.fileno is not callablezstream not a TTYz5Unable to determine output stream file descriptor: %szOutput stream is not a TTYzInput stream is not a TTYz4Unable to determine input stream file descriptor: %sz%Output stream is not a default streamz2Unable to determine __stdout__ file descriptor: %s)rosys __stdout__hasattrrlr}callablerrxisattyrr ValueError __stderr__ __stdin__rpr|AttributeErrorrq)r stream_fdrs r__init__streamsTerminal.__init__streamss  << >>DLt||X.. KK  < =$,,--.. KK  > ? ; LL//1 "$9!5~~KK&&'9: <>+6:PP$+D !$'6??8+D+J$KD !c^[[U55[-Hn[X5 M gN)setdirrdelattr)rcached_color_caps r__clear_color_capabilities#Terminal.__clear_color_capabilities s" #CI 7  D +!8rc[R"5Ul[R"5H!unup#[ XU5URU'M# [ R"5Hunup$UR(a9[X5nU(a'[ R"XU40UD6URU'MR[R"U5nU(dMq[ XU5URU'M [R"SRSURR 5555Ul[R"SRSURR 555S-5Ul[R"SRSURR 555S-5Ulg)N|c3># UHupURv M g7fr)pattern.0namecaps r 0Terminal.__init__capabilities..'sD2CYTS[[2Cc3># UHupURv M g7fr) named_patternrs rrr+s6 /@)$C  /@rz|(?P.)c3\# UH"upSRUR5v M$ g7f)z({0})N)rrrs rrr.s&5 9JIDGNN3;; ' '9Js*,z|(.)) collections OrderedDictcapsritemsr rr~getattrbuildrrzrecompilejoin caps_compiled_caps_compiled_any_caps_unnamed_any)rr attributerkwdsrs r__init__capabilitiesTerminal.__init__capabilitiessy ++- +A*F*F*H &D&9%dY?DIIdO+I(;'@'@'B #D#9  d.&-mm9'604'6DIIdO-006Gw")$"C $(C ZZ HHD$))//2CD DF #%**SXX6 /3yy/@6 . .# "$CHH5 9=9J5 - -"rc[5UlURR5Hup[XU5 M [ U5Ul[ UR 5Ul[R"5Ul URb[(a5[5=(d [R"5=(d SUlO#[R"5=(d SUl["R$"UR 5"5Ulgg![(a`n[*R,"SR/U55 SUl["R$"UR 5"5UlSnAgSnAff=f)NzUTF-8z3LookupError: {0}, defaulting to UTF-8 for keyboard.)r _keycodesrsetattrr _keymapr _keymap_prefixesrdeque _keyboard_bufrprtrlocalegetpreferredencoding _encodingcodecsgetincrementaldecoder_keyboard_decoder LookupErrorrrr)rkey_codekey_namers r__init__keycodesTerminal.__init__keycodes2s0,-#'.."6"6"8 H DH -#9.d3 !5T\\ B)..0    (z!;!="@224"@8?"(!!I' X)/)E)Ednn)U)W& ) X SZZ[^_`!()/)E)Ednn)U)W&&  Xs4*D F *AFF cjUR(d [5$[X5n[XU5 U$)a 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. )r{rrr)rattrvals r __getattr__Terminal.__getattr__Vs1.!!%' '  +C  rcUR$)zT Read-only property: Terminal kind determined on class initialization. :rtype: str )rwrs rr Terminal.kindxszzrcUR$)zS Read-only property: Whether this class instance may emit sequences. :rtype: bool )r{rs rr~Terminal.does_stylings!!!rcUR$)zK Read-only property: Whether :attr:`~.stream` is a terminal. :rtype: bool )rrrs rr|Terminal.is_a_ttys~~rc6UR5R$)zO Read-only property: Height of the terminal (in number of lines). :rtype: int )_height_and_widthws_rowrs rr#Terminal.height%%'...rc6UR5R$)zP Read-only property: Width of the terminal (in number of columns). :rtype: int )rws_colrs rr$Terminal.widthrrc6UR5R$)zE Read-only property: Height ofthe terminal (in pixels). :rtype: int )r ws_ypixelrs r pixel_heightTerminal.pixel_height%%'111rc6UR5R$)zA Read-only property: Width of terminal (in pixels). :rtype: int )r ws_xpixelrs r pixel_widthTerminal.pixel_widthrrc[(a_[R"U[R[ R 5n[ [R"[ RU56$[ SSSSS9$)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). Prrrrr) HAS_TTYfcntlioctltermios TIOCGWINSZWINSZ_BUFstructunpack_FMT)fddatas r_winsizeTerminal._winsizesP. 7;;r7#5#5uzzBD&-- D9: :BrQ!DDrc HUR[R4HnUbURU5s $M [[[R"SS55[[R"SS55SSS9$![[ [ [4a Mf=f)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! NLINES25COLUMNS80r) rqrrrIOErrorOSErrorr TypeErrorr intrxgetenv)rrs rrTerminal._height_and_widths2((#..9B >==,,":C '4 89 )T :;##% %Wj)<  sBB! B!cSnUR(a UR5nUR5 URR U5 URR 5 [ UUUS9upVU(a&USUR5XeR5S-nURU5 UbURSSS5 U$!UbURSSS5 ff=f)a= 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)termrtimeout) rnr! __enter__rwriteflushrstartendungetch__exit__)r query_str response_rer"ctxmatchrs r_query_responseTerminal._query_responses  /""kkm  KK  i ( KK   &4.9.57KE NU[[]+d99;<.@@ LL  T4.  T4.s B1C C&c## URRUR5 Ub.Ub+URRURX!55 O[Ub+URRUR U55 O-Ub*URRUR U55 URR 5 Sv URRUR5 URR 5 g!URRUR5 URR 5 f=f7f)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)rr$r*r8r;r=r%r,rxys rlocationTerminal.location%sL $))$ =Q] KK  diio . ] KK  dkk!n - ] KK  dkk!n - KK     KK  dll + KK    KK  dll + KK   s B2E5DAEAEEc:[XRSR5=(d SnURUR=(d SURSR U5nU(a,SUR 55upESU;a US-nUS-nXE4$g)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) rez [%i%d;%dRzc38# UHn[U5v M g7frrrrs rr(Terminal.get_location..s;NSCNsz%ir)rr)rrrr.rW re_compiledgroups)rr" response_strr-rowcols r get_locationTerminal.get_locationZsbtYY%?%I%IJ^N^ $$ GG !z499_#=#I#I7  ;ELLN;HC $qq8O rcURS[R"S5U5nU(a [SUR 555$S$)a 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]+)c3:# UHn[US5v M g7fNr8r9s rr'Terminal.get_fgcolor..<^cSb\\^rrrr.rrtupler<rr"r-s r get_fgcolorTerminal.get_fgcolorI$$  JJV W   AFu`_. z]11;?z6]11;rgb:([0-9a-fA-F]+)/([0-9a-fA-F]+)/([0-9a-fA-F]+)c3:# UHn[US5v M g7frDr8r9s rr'Terminal.get_bgcolor..rGrHrIrJrLs r get_bgcolorTerminal.get_bgcolorrOrc## URRUR5 URR5 Sv URRUR5 URR5 g!URRUR5 URR5 f=f7f)a 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)rr$r4r%r6rs r fullscreenTerminal.fullscreens" $//0   KK  d22 3 KK    KK  d22 3 KK    AC BAC ACC c## URRUR5 URR5 Sv URRUR5 URR5 g!URRUR5 URR5 f=f7f)z 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)rr$r?r%rArs r hidden_cursorTerminal.hidden_cursors $**+   KK  d00 1 KK    KK  d00 1 KK   rXc$URX!5$)an 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 r8r1s rmove_xyTerminal.move_xysyyrc$URX5$)an 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])rr3r2s rr:Terminal.move_yx syyrcT[UR[UR55$)zBMove cursor 1 cells to the left, or callable string for n>1 cells.)rcub1rcubrs r move_leftTerminal.move_left%TYY0DTXX0NOOrcT[UR[UR55$)zKMove cursor 1 or more cells to the right, or callable string for n>1 cells.)rcuf1rcufrs r move_rightTerminal.move_rightrgrcT[UR[UR55$)zFMove cursor 1 or more cells upwards, or callable string for n>1 cells.)rcuu1rcuurs rmove_upTerminal.move_uprgrcT[UR[UR55$)zHMove cursor 1 or more cells downwards, or callable string for n>1 cells.)rcud1rcudrs r move_downTerminal.move_down$rgrczUR(a![URURS5$[ 5$)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)r~r_foreground_colorrErrs rrxTerminal.color)s/   '(>(> WU U!##rcURS:Xa'SRXU5n[X@R5$UR XU5n[UR U5UR5$)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)rrrrErgb_downconvertryrredgreenbluefmt_attr color_idxs r color_rgbTerminal.color_rgb<sc  G +077DIH#Hkk: :((T:  6 6y A4;;OOrczUR(a![URURS5$[ 5$)zU A callable capability that sets the background color. :rtype: ParameterizingString on_color)r~r_background_colorrErrs rrTerminal.on_colorRs/   '(>(> ZX X!##rcURS:Xa'SRXU5n[X@R5$UR XU5n[UR U5UR5$)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)rrrrEr|rr}s r on_color_rgbTerminal.on_color_rgb^sa  G +077DIH#Hkk: :((T:  6 6y A4;;OOrcp[U5n[SU55(a [X5$[5$)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. c3R# UHo[;=(d U[;v M g7fr)rr)rfmts rr%Terminal.formatter..sM*3v 5 !55*s%')rallrr)rvalue formatterss r formatterTerminal.formatterrs3$E* M*M M M4' '!##rc[URnSnSn[[5H-upxU"XX#45n UbX:aU nUnXpR:dM, U$ U$)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)rcolor_distance_algorithm enumeraterr) rr~rr fn_distancershortest_distance cmp_depthcmp_rgb cmp_distances rr|Terminal.rgb_downconvertss 00M0MN   "+L"9 I&we0BCL (L,L$0!% 111#:rcvUR(a UR$[US5UlUR$)a 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. rE)rmrrs rrETerminal.normals- <<<< )$9 ||rc*[U5S:d[U5U45eU(aE[[U55S:d[[U55U45eSRU5nOSnUR(dU$SRXAU5$)a4 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``. izid={0}z]8;{0};{1}\{2}]8;;\)lenstrrr~)rurltexturl_idparamss rlink Terminal.links3x$/S3/ s6{#c) ECF ,>> term.truncate(u'xyz\x1b[0;3m', 2) u'xy\x1b[0;3m' )r$r truncate)rrr$s rrTerminal.truncateGs( =JJE#,,U33rc4[X5R5$)u4 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 lengthrrs rrTerminal.lengthWs(#**,,rc6[X5RU5$)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 striprrcharss rrTerminal.stripms#))%00rc6[X5RU5$)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 rstriprs rrTerminal.rstripy#**511rc6[X5RU5$)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 lstriprs rrTerminal.lstriprrc4[X5R5$)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_seqsrs rrTerminal.strip_seqss #..00rcURn/n[[R"X155H[upVUR UR 55 U(dM-XR:XdM4XR 5SnU(a US==U- ss' U$ U$)a9 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)rrrfinditerr}groupr')rrmaxsplitrresultidxr- remainings r split_seqsTerminal.split_seqssz"((#BKK$>?JC MM%++- (xCO . 2J)+J @ rc Uc UROUn[SX S.UD6n/nUR5HCnURUR 5(a[ UR U55OS5 ME U$)a9 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. )r$r!r)r$r splitlinesextendriterwrap)rrr$kwargswrapperlineslines rr Terminal.wrapsh"$m %GEGGOO%D LLTZZ\\gll401v N& rcURce[R"URS5nURR USS9$)a  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. rF)final)rprxreadrdecode)rbytes rgetchTerminal.getchsH   ,,,wwt((!,%%,,T,??rc:URRU5 g)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 extendleftrs rr(Terminal.ungetchs %%d+rcx[R"5nS/nURb UR/O/n[(a[R"U//U5un nURcS$XC:H$![a/ Ub)U[R"5U- -nUS:aMn/nMIOf=f[(aM{N])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)timerprselectInterruptedError)rr"stimeready_rcheck_r_s rr"Terminal.kbhits$ ()-):):)F4$$%Bg  & gr2w G A0))1uIw7II3$ &tyy{U22G{  G' gsA22.B+#B+*B+c## [(aURb[R"UR5nURn[ R "UR[R5 SUlSv [R"UR[RU5 X lgSv g![R"UR[RU5 X lf=f7f)a Allow each keystroke to be read immediately after it is pressed. This is a context manager for :func:`tty.setcbreak`. This context manager activates 'rare' mode, the opposite of 'cooked' mode: On entry, :func:`tty.setcbreak` mode is activated disabling line-buffering of keyboard input and turning off automatic echo of input as output. .. note:: You must explicitly print any user input you would like displayed. If you provide any kind of editing, you must handle backspace and other line-editing control functions in this mode as well! **Normally**, characters received from the keyboard cannot be read by Python until the *Return* key is pressed. Also known as *cooked* or *canonical input* mode, it allows the tty driver to provide line-editing before shuttling the input to your program and is the (implicit) default terminal mode set by most unix shells before executing programs. Technically, this context manager sets the :mod:`termios` attributes of the terminal attached to :obj:`sys.__stdin__`. .. note:: :func:`tty.setcbreak` sets ``VMIN = 1`` and ``VTIME = 0``, see http://www.unixwiz.net/techtips/termios-vmin-vtime.html NF) rrpr  tcgetattrrntty setcbreakTCSANOW tcsetattr TCSAFLUSHr save_modesave_line_buffereds rr!Terminal.cbreak(s< 7t((4))$*;*;8C66C9c## [(aURb[R"UR5nURn[ R "UR[R5 SUlSv [R"UR[RU5 X lgSv g![R"UR[RU5 X lf=f7f)a A context manager for :func:`tty.setraw`. Although both :meth:`cbreak` and :meth:`raw` modes allow each keystroke to be read immediately after it is pressed, Raw mode disables processing of input and output. In cbreak mode, special input characters such as ``^C`` or ``^S`` are interpreted by the terminal driver and excluded from the stdin stream. In raw mode these values are received by the :meth:`inkey` method. Because output processing is not done, the newline ``'\n'`` is not enough, you must also print carriage return to ensure that the cursor is returned to the first column:: with term.raw(): print("printing in raw mode", end="\r\n") NF) rrpr rrnrr rrrrs rraw Terminal.rawXs( 7t((4))$*;*;`_. 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 rr)r"N)rrpopr"rrrrrcode KEY_ESCAPErr(r)rr" esc_delayrucsksesctimes rinkeyTerminal.inkeysH   %%))+ +C   jjj# ::< Cjjj##c<< @ Ju,FG ::< C!#||T^^DBJu,FGG 77doo %iikG77doo-///::j&D:Ezz|#%c<<H 77doo-///::j&D:EE SR]# r)rrrr{rrqrrrrrprrrrwrnrmrrorrrlr)NNF)NNrr)N )r)I__name__ __module__ __qualname____firstlineno____doc___sugarrrsrrrrrpropertyrr~r|r#r$rr staticmethodrrr. contextlibcontextmanagerr4r@rMrSrVrZr^r:rerkrprurxrrrrr|rErrrsetterrryrrrrrrrrrrrrrr(r"r!rrrr)__static_attributes__rrrr(r(Ks@!!4! T! U ! T ! G ! 7! ! 5! %! %! w! ! ! &! 5!!" &#!$!# A!FFQ f0_dL,"H"XH D""////2222EE8#%J*X2 2 hIVX*X*  0  $  PPPPPPPP$$$P, $ $P($*8  <4&&"**..$$*%* '''';" ; <4 -, 1 2 21$82@(,2Jh--^""H  2!,<Mrr(cF\rSrSrSrSrS\R"\5-rSr g)r ia 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 hhhhrN) r,r-r.r/r0rrcalcsizer r7rrrr r s!( D FOOD) )Drr r)Cr0rxrrrrrrrr%rr4rrxrkeyboardrrrrr r r sequencesr r r colorspacerrrrrrrrrrr _capabilitiesrrr version_inforrrsystemrtjinxedru jinxed.win32rrr r ImportError _TTY_METHODSrr_MSG_NOSUPPORTrrobjectr( namedtupler rrrrIsMH -///>=$---_^ BQ& ||  ?? !J7J  YvYx,*K " "7-6 7*W-  G  EVX__. $ , 79   n% s C;;A EE