xjW&ddlZddlmZmZmZmZmZmZmZ ddl m Z n#e $r ddl m Z YnwxYwddl mZdedefd Zdedefd Zd edefd Zd edeeeeffd ZGddZdS)N)AnyDictListIterableOptionalTupleUnion)Lexicon)Argumentnamereturncz|ddddS)N_-)lstriprstripreplacers FC:\Projects\Historical\venv\Lib\site-packages\invoke/parser/context.pytranslate_underscoresr s2 ;;s   " "3 ' ' / /S 9 99cZt|}t|dkrd|zSd|zS)Nr rz--)rlenrs rto_flagrs2  & &D 4yyA~~Tz $;rargc|j}d|Dfd|D}ttrn|dS)Nc^h|]*}t|ddk(|+S)rr )rstrip.0xs r z!sort_candidate..s4 9 9 9A#aggcll"3"3q"8"8a"8"8"8rch|]}|v| Sr&)r"r#shortss rr$z!sort_candidate..s 1 1 11&Qrr)namesstrsorted)rr(longsr's @rsort_candidater,sZ IE 9 9 9 9 9F 1 1 1 1 1 1 1E v1ffE2215 6 66rcg}t|}|t|dkrdnd||d}|D]A}||r|n|z }B|||S)zZ Obtain useful key list-of-ints for sorting CLI flags. .. versionadded:: 1.0 r r)r,appendrlowerisupperupper)rretr#inversedchars rflag_keyr6s"$CsAJJCFFaKKqqQ'''JJqwwyyHEEDLLNNDDJJLLL DJJx Jrc VeZdZdZ ddeedeedeeddfdZdefd Z de d e ddfd Z e de efd Ze deee ffd Zdede efdZdedeeeffdZde eeeeffdZdeedffdZdS) ParserContextz Parsing context with knowledge of flags & their format. Generally associated with the core program or a task. When run through a parser, will also hold runtime values filled in by the parser. .. versionadded:: 1.0 Nr&raliasesargsrct|_g|_t|_i|_||_||_|D]}||dS)a Create a new ``ParserContext`` named ``name``, with ``aliases``. ``name`` is optional, and should be a string if given. It's used to tell ParserContext objects apart, and for use in a Parser when determining what chunk of input might belong to a given ParserContext. ``aliases`` is also optional and should be an iterable containing strings. Parsing will honor any aliases when trying to "find" a given context in its input. May give one or more ``args``, which is a quick alternative to calling ``for arg in args: self.add_arg(arg)`` after initialization. N)r r:positional_argsflags inverse_flagsrr9add_arg)selfrr9r:rs r__init__zParserContext.__init__Gsf(II /1YY -/    C LL      rc(d}|jr-dd|j}|jrd|j|nd}|jrd|jnd}d||S)Nr.z ({}), z {!r}{}z: {!r}z)r9formatjoinrr:)r@r9rr:s r__repr__zParserContext.__repr__ds < >nnTYYt|%<%<==G9=J   G444/3y@ ***b%,,T4888rkwargscLt|dkr$t|dtr |d}n t|i|}|jD]/}||jvr$d}t ||0|jd}||j|<|jr|j |||j t|<|j D]T}|j |||j t|t|U|jr!|j |j||jt krD|jdur=td|}t||j|<dSdSdS)a Adds given ``Argument`` (or constructor args for one) to this context. The Argument in question is added to the following dict attributes: * ``args``: "normal" access, i.e. the given names are directly exposed as keys. * ``flags``: "flaglike" access, i.e. the given names are translated into CLI flags, e.g. ``"foo"`` is accessible via ``flags['--foo']``. * ``inverse_flags``: similar to ``flags`` but containing only the "inverse" versions of boolean flags which default to True. This allows the parser to track e.g. ``--no-myflag`` and turn it into a False value for the ``myflag`` Argument. .. versionadded:: 1.0 r rz;Tried to add an argument named {!r} but one already exists!)toTzno-{}N)r isinstancer r(r: ValueErrorrD positionalr<r/r=r nicknamesalias attr_namekindbooldefaultr>)r@r:rGrrmsgmain inverse_names rr?zParserContext.add_argls$ t99>>ja(;;>q'CCD+F++CI 3 3Dty  S D!1!1222!y| $ > -  ' ' , , ,$' 74==!M > >D IOODTO * * * J  WT]]wt}}  = = = = = 4 IOOCMdO 3 3 3 8t   t 3 3#7>>$#7#788L/6t}}D | , , ,   3 3rc$d|jDS)Nc g|] }|j | SN)valuer!s r z9ParserContext.missing_positional_args..sCCCa17????r)r<r@s rmissing_positional_argsz%ParserContext.missing_positional_argssCC4/CCCCrc`i}|jD]}|j||j<|S)a This context's arguments' values keyed by their ``.name`` attribute. Results in a dict suitable for use in Python contexts, where e.g. an arg named ``foo-bar`` becomes accessible as ``foo_bar``. .. versionadded:: 1.0 )r:valuesrYr)r@r3rs r as_kwargszParserContext.as_kwargss:9##%% & &CICMM rflagcrtt|g|j|zSrX)listsetr= aliases_of)r@r`s r names_forzParserContext.names_fors/C!6!6t!>>rcV||jvrr^r/rEr*help) r@r`errrrY full_namesrvalue_valuestrnamestrhelpstrs rhelp_forzParserContext.help_fors tz ! !TCSZZdjoo.?.?@@AA AjhU+//99 NN4(( / /D tzz#''1,,7:|NfmmE222F$||F33HH$||E22H|;#)==#:#:4-446666&--d122h77D   dXo . . . .))F:377788(.brc ttfdtjt S)a Return sorted iterable of help tuples for all member Arguments. Sorts like so: * General sort is alphanumerically * Short flags win over long flags * Arguments with *only* long flags and *no* short flags will come first. * When an Argument has multiple long or short flags, it will sort using the most favorable (lowest alphabetically) candidate. This will result in a help list like so:: --alpha, --zeta # 'alpha' wins --beta -a, --query # short flag wins -b, --argh -c .. versionadded:: 1.0 cRt|jSrX)rvrr)r#r@s rz+ParserContext.help_tuples..s$--88rri)rbmapr*r=r^r6r[s`r help_tupleszParserContext.help_tuplessN6 8888tz((**999     r.cDtjt}fd|D}|t jttj |S)z Similar to `help_tuples` but returns flag names only, no helpstrs. Specifically, all flag names, flattened, in rough order. .. versionadded:: 1.0 ric^g|])}t|j*Sr&)rerr)r"r#r@s rrZz,ParserContext.flag_names..s-@@@Q00@@@r) r*r=r^r6r/rbr>rktuple itertoolschain from_iterable)r@r=r(s` r flag_nameszParserContext.flag_namesstz((**999@@@@%@@@ T$,113344555Y_22599:::r)Nr&r&)__name__ __module__ __qualname____doc__rr)rr rArFrr?propertyrr\rr_rerrvr{rr&rrr8r8;s  #!##% sm#x   :9#9999/=S/=C/=D/=/=/=/=bDhDDDXD 4S>   X ?c?d3i????% S% U38_% % % % N  T%Xc](:";<     D ;E#s(O ; ; ; ; ; ;rr8)rtypingrrrrrrr vendor.lexiconr ImportErrorlexiconargumentr r)rrr,rlr6r8r&rrrsyDDDDDDDDDDDDDDDDDD (((((((    ::::::##77S7777(tE#s(O48O;O;O;O;O;O;O;O;O;O;s  --