Vi>K@SSKrSSKrSSKrSSKrSSKJrJr SSKJrJ r J r J r SSK J r \ "SSSSS 9rS rS rS rS r\4SjrSrSrS\S4Sjr0SS_SS_SS_SS_SS_SS_SS _S!S_S"S _S#S$_S%\ _S&\_S'\ _S(S)_S*S+_S,S_S-S_r"S.S/\5r"S0S1\5rg)2N)uniquesplit)format_flag_labelformat_flag_post_docformat_posargs_labelecho)Flagz--helpTz-hzshow this help message and exit)parse_aschardocxcSSKnSSKn[R"S/SQ5nUR[R UR U5(aeUup4 nX44$)NrH)rrrr)fcntltermiosarrayioctlsysstdout TIOCGWINSZ)rrwinsizews_rowws_col_s _/home/james-whalen/.local/share/pipx/venvs/semgrep/lib/python3.13/site-packages/face/helpers.py_get_termios_winsizersOkk#|,G{{3::w'9'97CCC C"FAq >c[[RS5[[RS5pX4$![[4a SupX4$f=f)NROWSCOLUMNSNN)intosenvironKeyError ValueError)rowscolumnss r_get_environ_winsizer)s[#BJJv./RZZ 5J1Kg = j !#" g =#s7<AAcSup[5upX4$![a% [5upX4$![a X4$f=ff=f)Nr!)r Exceptionr))r'colss r get_winsizer-(sjJD)+  :  -/JD$ :   : s"  A 0 AAAAcH[5upUcSn[X 5nUS-nU$)NP)r-min) max_widthrwidths rget_wrap_widthr44s-}HA }  !E QJE Lrcx/nURnX-nU(d U"U5 U$[U5n [R"X55n [U5U::a.UR U[U5- 5U-n U"XS-5 OU"U5 U"SXI- -U-U S-5 U SSHn U"SU-U -5 M U$)Nr )appendlentextwrapwrapljust) indentlabelsepr doc_start max_doc_widthretr8lhslen_sep wrapped_doclhs_flines r_wrap_stout_pairrH=s C ZZF .C s  #hG--3K 3x9 )c#h./#5u1~%&s y*+s2[^CDABsY%&  Jrc2/n[UR5S5Vs/sHnU(dM SRU5PM nnUH7n[R"UU[ U5- UUS9nUR U5 M9 SRU5$s snf)z*Function for wrapping command description.c,UR5(+$)N)lstrip)ls r%_wrap_stout_cmd_doc..]s 188:~r )textr3initial_indentsubsequent_indentz )r splitlinesjoinr:fillr9r8)r=r r2partsparaparasparts r_wrap_stout_cmd_docrZYs E 3>>#%= >  >"&TYYt_ >  }}$$-F $;,2/57  T  ;;u  s BB(cU=(d [US9n[U5n[U5nSnUn X5- n UH8n [U 5n X:aMU nX|-U-U-U:dM'X8- U- U- n X|-U-n M: UUU U S.$)Nr2r)r3 label_width doc_widthr@)r4r9) labelsr=r?r3r2 min_doc_widthrD len_indentmax_label_widthrAr@r>cur_lens rget_stout_layoutrehs  8^i8E#hGVJO!M%Ie*  $ !  7 *] :e C!3g= JM",w6I*&" $$r usage_labelzUsage:subcmd_section_headingz Subcommands: flags_section_headingzFlags: posargs_section_headingzPositional arguments: section_breakrO group_breaksubcmd_example subcommandr3r2ra2rrr doc_separatorz section_indentz pre_docpost_doccH\rSrSrSr\"\5rSrSr S Sjr S Sjr Sr g) StoutHelpFormatteraThis formatter takes :class:`Parser` and :class:`Command` instances and generates help text. The output style is inspired by, but not the same as, argparse's automatic help formatting. Probably what most Pythonists expect, this help text is slightly stouter (conservative with vertical space) than other conventional help messages. The default output looks like:: Usage: example.py subcommand [FLAGS] Does a bit of busy work Subcommands: sum Just a lil fun in the sum subtract print Flags: --help / -h show this help message and exit --verbose / -V Due to customizability, the constructor takes a large number of keyword arguments, the most important of which are highlighted here. Args: width (int): The width of the help output in columns/characters. Defaults to the width of the terminal, with a max of *max_width*. max_width (int): The widest the help output will get. Too wide and it can be hard to visually scan. Defaults to 120 columns. min_doc_width (int): The text documentation's minimum width in columns/characters. Puts flags and subcommands on their own lines when they're long or the terminal is narrow. Defaults to 50. doc_separator (str): The string to put between a flag/subcommand and its documentation. Defaults to `' '`. (Try `' + '` for a classy bulleted doc style. An instance of StoutHelpFormatter can be passed to :class:`HelpHandler`, which can in turn be passed to :class:`Command` for maximum command customizability. Alternatively, when using :class:`Parser` object directly, you can instantiate this type and pass a :class:`Parser` object to :meth:`get_help_text()` or :meth:`get_usage_line()` to get identically formatted text without sacrificing flow control. HelpFormatters are stateless, in that they can be used more than once, with different Parsers and Commands without needing to be recreated or otherwise reset. c 0UlURR5H#up#URX#5URU'M% U(a%[ S[ UR 55-5eg)Nz"unexpected formatter arguments: %r)ctxdefault_contextitemspop TypeErrorlistkeys)selfkwargskeyvals r__init__StoutHelpFormatter.__init__s^,,224HC"JJs0DHHSM5 @4 CVVW W rc TURn[UUSUSUSUSUSS9$)Nrqrpr3r2ra)r`r=r?r3r2ra)rxre)rr`rxs r _get_layoutStoutHelpFormatter._get_layoutsDhhv'*+;'<$'$8&)'l*-k*:.1/.B D DrNc URnURXUS9/nURnU"US5 URUSS9nU(aURUnUR (a?U"[ USUR US=(d [USS9S 95 U"US 5 UR(a[URVs/sHo(dM US PM sn5n URU S 9n U"US 5 U"US5 [URVs/sHo(dM US PM sn5HXn URU 4n [USU RSS5USU R U SU SS9n URU 5 MZ U"US 5 U(dSRU5$USnUVs/sH o"U5PM nnURUS 9nUSnU"US5 U"US5 UHnURnURb URnOnUR (a UR /O/nUR (a UR OU"U5nU(aURU5 SRU5n[USU"U5USUUSUSS9nURU5 M USSRU5-US-$s snfs snfs snf)a`Turn a :class:`Parser` or :class:`Command` into a multiline formatted help string, suitable for printing. Includes the usage line and trailing newline by default. Args: parser (Parser): A :class:`Parser` or :class:`Command` object to generate help text for. subcmds (tuple): A sequence of subcommand strings specifying the subcommand to generate help text for. Defaults to ``()``. program_name (str): The program name, if it differs from the default ``sys.argv[0]``. (For example, ``example.py``, when running the command ``python example.py --flag val arg``.) subcmds program_namerkF)path with_hiddenrqr3r2r])r=r r2rjr)r`rgr-rpr@r_)r=r>r?r r@rArOrrrhr6rrrs)rxget_usage_liner8 get_flags subprs_mapr rZr4rrrHreplaceextendrTdisplayfull_docrs)rparserrrrxrBr8 shown_flagssp subcmd_names subcmd_layoutsub_namesubprs subcmd_linesfmt_flag_labelflag flag_labels flag_layoutfmt_flag_post_docdispr _partsrs flag_liness r get_help_text StoutHelpFormatter.get_help_texts$hh""6"VWs=!"&&G&G &&w/F :: &c2B.C+1::14W2G585EBGH I 3' (   !63D3D"K3DR52a53D"KLL ,,L,AM 3/0 1 3}% &"F4E4E#L4EbEBqE4E#LM**H;7/s;K7L6>6F6FsC6P474H4:JJ:G :T>KK>X  Z  <(N 3' (99S> !018CD ~d+ D&&k&:  67s*+,s=!"D<t0D.1/.B.14? 4L8CK8P RJ JJz "% (9~ #.Z@@a#L $M"Es K3 K3% K83 K8 K=cURn[U=(d S5nUS(aUS/O/nURnU=(d URnU"SR U4U-55 U(dUR (a U"S5 O-U(a&UR UR (aU"S5 U(aUR UnUR SS9nU(aU"S5 URRR(dUSnU"U"UR55 SR U5$) zGet just the top line of automated text output. Arguments are the same as :meth:`get_help_text()`. Basic info about running the command, such as: Usage: example.py subcommand [FLAGS] [args ...] rfr6rnF)rz[FLAGS]r) rxtupler8namerTrrposargsrhidden) rrrrrxrVr8flagsfmt_posargs_labels rr!StoutHelpFormatter.get_usage_line;shh 2&(+M(:]#$#2v{{ sxx'1236,, < **73>> <  &&w/F  U 3  9 ~~%%,, #$: ;  $V^^4 5xxr)rx)rN) __name__ __module__ __qualname____firstlineno____doc__dictDEFAULT_CONTEXTryrrrr__static_attributes__rrrrurus-;x?+OXDTAl$rruc0\rSrSrSr\S\S4SjrSrSr g) HelpHandlerimaThe HelpHandler is a one-stop object for that all-important CLI feature: automatic help generation. It ties together the actual help handler with the optional flag and subcommand such that it can be added to any :class:`Command` instance. The :class:`Command` creates a HelpHandler instance by default, and its constructor also accepts an instance of this type to customize a variety of helpful features. Args: flag (face.Flag): The Flag instance to use for triggering a help output in a Command setting. Defaults to the standard ``--help / -h`` flag. Pass ``False`` to disable. subcmd (str): A subcommand name to be added to any :class:`Command` using this HelpHandler. Defaults to ``None``. formatter: A help formatter instance or type. Type will be instantiated with keyword arguments passed to this constructor. Defaults to :class:`StoutHelpFormatter`. func (callable): The actual handler function called on flag presence or subcommand invocation. Defaults to :meth:`HelpHandler.default_help_func()`. All other remaining keyword arguments are used to construct the HelpFormatter, if *formatter* is a type (as is the default). For an example of a formatter, see :class:`StoutHelpFormatter`, the default help formatter. Nc XlX lUbUO URUl[ UR5(d[ SU-5eX0lU(d[ SU-5e[U[5(aU"S0UD6UlO1U(a*[ S[UR55<SU<35e[ [UR SS55nU(d[ SUR <35eg)Nz1expected help handler func to be callable, not %rz,expected Formatter type or instance, not: %rz%only accepts extra formatter kwargs (z2) if formatter argument is a Formatter type, not: rzMexpected valid formatter, or other object with a get_help_text() method, not r) rsubcmddefault_help_funcfunccallabler| formatter isinstancetypesortedr~getattr)rrrrrformatter_kwargs_has_get_help_texts rrHelpHandler.__init__s   ,D$2H2H  ""ORVVW W"JYVW W i & &&:)9:DN %&6&;&;&=> KL L&gdnnot&TU!AERS SrcJ[URRXBUS95 g)zThe default help handler function. Called when either the help flag or subcommand is passed. Prints the output of the help formatter instance attached to this HelpHandler and exits with exit code 0. rN)rrr)rcmd_subcmds_args_command_s rrHelpHandler.default_help_funcs! T^^ ) )(SW ) XYr)rrrr) rrrrrDEFAULT_HELP_FLAGrurrrrrrrrms@.d-D0Zrr)r#rrr:boltons.iterutilsrr face.utilsrrrr face.parserr rDEFAULT_MAX_WIDTHrr)r-r4rHrZrerobjectrurrrrrsf +ZZDtAbc  /8 15@Q#%$28oY6  T  2 l TR0*0Ud r!"#*IIZAZ&AZHzr