Vi7dSSKrSSKrSSKrSSKrSSKrSSKrSSKJrJr SSK J r J r SSK J r SSKr\ \ "S5r\R*"S5r\S\S0rS rS rS rS rS rSrSr Sr!Sr"Sr#Sr$SSjr%Sr&Sr'Sr(Sr)\)\(l*Sr+SSjr,Sr-\-\,l.g!\a \r\rNxf=f)N) pluralize strip_ansi)splitunique) make_sentinelERRORz^[A-z][-_A-z0-9]*\ZintegerdecimalcDU(a[U[[45(d[SU-5eUR S5(dUR S5(a[SU-5e[ R U5nU(d[SU-5e[U5nU$)aOValidate and canonicalize a Command's name, generally on construction or at subcommand addition. Like ``flag_to_identifier()``, only letters, numbers, '-', and/or '_'. Must begin with a letter, and no trailing underscores or dashes. Python keywords are allowed, as subcommands are never used as attributes or variables in injection. z --flag). r z&expected identifier, not flag name: %rr r&) startswithrr r!) identifierr#s ridentifier_to_flagr0isKS!!AJNOO     $ $S# .C #:rczURRbURR$[UR5/nUR(aUR SUR-5 SR U5nURR(aUSURR-- nU$)zCThe default flag label formatter, used in help and error formattingr z /  )displaylabelr0rcharappendjoin value_name)r"partsr#s rformat_flag_labelr:ss ||%||!!!  * +E yy S499_% **U C || sT\\,,,, JrcURR(aURR$UR(dg[URRUR UR 5$)HThe default positional argument label formatter, used in help formatting)r3r4 accepts_argsget_cardinalized_args_labelr min_count max_count) posargspecs rformat_posargs_labelrCsW!!'''  " " &z'9'9'>'> @T@TV`VjVj kkrcX:XaSRU/U-5$US:XaUS-[USUb US- S9-$SS9-$US:XaSOSnUS:XaX0-$U[U5S--$) z Examples for parameter values: (min_count, max_count): output for name=arg: 1, 1: arg 0, 1: [arg] 0, None: [args ...] 1, 3: args ... r2rrN)r@rAz[%s]z%sz ...)r7r?r)rr@rAtmpls rr?r?sxx*++A~cz7BCS\Sh)a-tt tnrtt t!^6DA~{ 9T?V+ ,,rcBURRbURR$UR[RLagURb6[ UR5[ RUR5:XagSUR<S3$)r<z (required)r=z (defaults to ))r3post_docmissingfacerreprobject__repr__)r"s rformat_flag_post_docrNst ||(||$$$ ||tzz! ||tDLL1V__T\\5RR S"& //rc [U5(d[SU-5eS[U4$![a Of=fSUR4$![ a Of=fSUR 4$![ a Of=fS[U54$)zHKind of a hacky way to improve message readability around argument typesz(expected parse_as to be callable, not %raswith)callable TypeErrorFRIENDLY_TYPE_NAMESKeyError__name__AttributeError func_namerK)parse_ass r get_type_descrZs H  BXMNN (222     X&&&&     x))))     4> !!s/ + 88 A AA A)) A65A6c@/n/nUR5HOnUR5nU(aURU5 M-URSRU55 /nMQ U(a URSRU55 SRU5$)zfTurn wrapped text into flowing paragraphs, ready for rewrapping by the console, browser, or textwrap. r2z ) splitlinesstripr6r7)text all_grafscur_graflines r unwrap_textrbsIH!zz|  OOD !   SXXh/ 0H "(+, ;;y !!rct0nUHnU/[5/pTnU(aUR5nURU5 URU/5nX';a[ SU<SU<35eUR UVs/sH oU;dM UPM sn5 UR U5 U(aMXAU'M U$s snf)zg expects and returns a dict of {item: set([deps])} item can be a string or any other hashable object. zdependency cycle: z0 recursively depends on itself. full dep chain: )setpopr6getrextendupdate) dep_mapr#keyto_procrdeps cur_chaincur cur_rdepscs r get_rdep_maprqs C%(E35" ++-C   S ! C,I EH)"UVV NNyEy!W4DAyE F LL #gC J Fs 7 B5 B5 c~Uc[ROUnUc[ROUnUcUR SS5OUn[ U[ [45(aURS5n[RRU5nUH*n[RRX5U:XdM(Us $ U$)aGet the shortest form of a path to an executable, based on the state of the process environment. Args: executable (str): Name or path of an executable path (list): List of directories on the "PATH", or ':'-separated path list, similar to the $PATH env var. Defaults to ``environ['PATH']``. environ (dict): Mapping of environment variables, will be used to retrieve *path* if it is None. Ignored if *path* is set. Defaults to ``os.environ``. Used by face's default help renderer for a more readable usage string. PATHr=:) sys executableosenvironrfrrrrpathbasenamerelpath)rvryrxexecutable_basenameps rget_minimal_executabler~s$.#5:J#ObjjG&*l7;;vr "D$g''zz#''**:6  77??: )-@ @& & rcDUR5$![a gf=f)z!Returns True if *stream* is a ttyF)isatty Exceptionstreams rrrs%}} s  c"[U5(+$)zNReturns True when ANSI color codes should be stripped from output to *stream*.)rrs rshould_strip_ansirsf~ rc U=(d Sn[U[[45(d [U5nURSS5nURSU(d[R O[R 5nURSS5nURSS5nURSS5nS n[U[5(aXv-nUc[U5(+nUc0URS S 5(a[U[5(aS OS nU(aX- nU(a[R"XS9nU(a#U(d [U5nURU5 UR5 g)aA better-behaved :func:`print()` function for command-line applications. Writes text or bytes to a file or stream and flushes. Seamlessly handles stripping ANSI color codes when the output file is not a TTY. >>> echo('test') test Args: msg (str): A text or byte string to echo. err (bool): Set the default output file to ``sys.stderr`` file (file): Stream or other file-like object to output to. Defaults to ``sys.stdout``, or ``sys.stderr`` if *err* is True. nl (bool): If ``True``, sets *end* to ``'\n'``, the newline character. end (str): Explicitly set the line-ending character. Setting this overrides *nl*. color (bool): Set to ``True``/``False`` to always/never echo ANSI color codes. Defaults to inspecting whether *file* is a TTY. r=errFfileendNcolorindentr2nlT  )prefix)rrbytesrerustdoutstderrintrtextwraprrwriteflush)msgkwis_err_filer enable_colorrspaces rechors. )C cGU+ , ,cl VVE5 !F FF6V3:: DE && C66'4(L VVHb !FE&#,U33  { 66$  %c733%C   ooc1 S/C C KKM rc"SUS'[U0UD6$)zx A convenience function which works exactly like :func:`echo`, but always defaults the output *file* to ``sys.stderr``. Tr)r)ars recho_errrTs BuI >b>rcR[U[5(dURS5$U$)Nutf8)rrdecode)inps r _get_textras# c7 # #zz&!! Jrc^^U=(d UnU(aU(dSUR5<3nUU4SjnU"U5n[U5nU(a.U"U5n[U5nXx:wa[R"S5eU$)a+A better-behaved :func:`input()` function for command-line applications. Ask a user for input, confirming if necessary, returns a text string. Handles Ctrl-C and EOF more gracefully than Python's built-ins. Args: label (str): The prompt to display to the user. confirm (bool): Pass ``True`` to ask the user to retype the input to confirm it. Defaults to False, unless *confirm_label* is passed. confirm_label (str): Override the confirmation prompt. Defaults to "Retype *label*" if *confirm* is ``True``. hide_input (bool): If ``True``, disables echoing the user's input as they type. Useful for passwords and other secret entry. See :func:`prompt_secret` for a more convenient interface. Defaults to ``False``. err (bool): If ``True``, prompts are printed on ``sys.stderr``. Defaults to ``False``. :func:`prompt` is primarily intended for simple plaintext entry. See :func:`prompt_secret` for handling passwords and other secret user input. Raises :exc:`UsageError` if *confirm* is enabled and inputs do not match. zRetype c>T(a[RO[n[USTS9 U"S5nU$![[4a T(a [STS9 ef=f)NF)rrr=)r)getpass raw_inputrKeyboardInterruptEOFError)r4funcr#r hide_inputs r prompt_funcprompt..prompt_funcs[",w)  5c *r(C "8, Ts#   s 5#AzSorry, inputs did not match.)r rrJ UsageError) r4confirm confirm_labelrr do_confirmrr#ret2s `` rpromptrgsl6)MJ-',{{}6 " e C C.C=) ;//"@A A Jrc HSUS'URSS5 [U40UD6$)aA convenience function around :func:`prompt`, which is preconfigured for secret user input, like passwords. All arguments are the same, except *hide_input* is always ``True``, and *err* defaults to ``True``, for consistency with :func:`getpass.getpass`. Trr) setdefaultr)r4rs r prompt_secretrs,B|MM% % 2 r)NNN)NNFF)/rwrerurr'rboltons.strutilsrrboltons.iterutilsrrboltons.typeutilsrrJr NameErrorrinputrrcompilerrfloatrTrrr,r0r:rCr?rNrZrbrqr~rrrrrrrrsecretrrrs 2++  g 12 Ii)<!H l-, 0","$<< 5 p  8v  A GIsB"" B/.B/