xj8ddlmZmZmZmZGddZdS))AnyIterableOptionalTupleceZdZdZddeddddddf deedeededeed eed ed ed ed eeddfdZ defdZ e deefdZ e de edffdZe defdZe defdZejdeddfdZddededdfdZe defdZdS)Argumenta\ A command-line argument/flag. :param name: Syntactic sugar for ``names=[]``. Giving both ``name`` and ``names`` is invalid. :param names: List of valid identifiers for this argument. For example, a "help" argument may be defined with a name list of ``['-h', '--help']``. :param kind: Type factory & parser hint. E.g. ``int`` will turn the default text value parsed, into a Python integer; and ``bool`` will tell the parser not to expect an actual value but to treat the argument as a toggle/flag. :param default: Default value made available to the parser if no value is given on the command line. :param help: Help text, intended for use with ``--help``. :param positional: Whether or not this argument's value may be given positionally. When ``False`` (default) arguments must be explicitly named. :param optional: Whether or not this (non-``bool``) argument requires a value. :param incrementable: Whether or not this (``int``) argument is to be incremented instead of overwritten/assigned to. :param attr_name: A Python identifier/attribute friendly name, typically filled in with the underscored version when ``name``/``names`` contain dashes. .. versionadded:: 1.0 NFnamenameskinddefaulthelp positionaloptional incrementable attr_namereturnc 8|r|rtd|s|std|rt||_n |r |s|f|_||_d} |turg} |r|} | x|_|_||_||_||_ ||_ ||_ | |_ dS)Nz8Cannot give both 'name' and 'names' arguments! Pick one.z(An Argument must have at least one name.) TypeErrortupler r list raw_value_valuer rrrrr) selfr r r r rrrrr initial_values GC:\Projects\Historical\venv\Lib\site-packages\invoke/parser/argument.py__init__zArgument.__init__*s  E J  H HFGG G  !uDJJ  !% !DJ '+ 4<<M  $#M'44  $  *"ctd}|jr-dd|j}d}|js|jrd}|jr|dz }|jr|dz }d}|jt krd|jj}d|jj|j |||S) Nz ({})z,  *?z [{}]z<{}: {}{}{}{}>) nicknamesformatjoinrrr str__name__ __class__r )rnicksflagsr s r__repr__zArgument.__repr__Ps > >NN499T^#<#<==E ? dm E ?  SLE =  SLE 9  >>$)"455D&& N #TYtU   rc*|jp |jdS)z The canonical attribute-friendly name for this argument. Will be ``attr_name`` (if given to constructor) or the first name in ``names`` otherwise. .. versionadded:: 1.0 r)rr rs rr z Argument.nameds~.A.r.c |jddSN)r r.s rr$zArgument.nicknamespsz!""~rc8|jturdS|jrdSdS)NFT)r boolrr.s r takes_valuezArgument.takes_valuets) 9  5   5trc,|j|jn|jSN)rr r.s rvaluezArgument.value|s#k5t{{4<Grargc4||ddS)NT)cast) set_value)rr8s rr7zArgument.values s&&&&&rTr7r:c|_d}|rj}jturfd}jrfd}||_dS)a! Actual explicit value-setting API call. Sets ``self.raw_value`` to ``value`` directly. Sets ``self.value`` to ``self.kind(value)``, unless: - ``cast=False``, in which case the raw value is also used. - ``self.kind==list``, in which case the value is appended to ``self.value`` instead of cast & overwritten. - ``self.incrementable==True``, in which case the value is ignored and the current (assumed int) value is simply incremented. .. versionadded:: 1.0 c|Sr6r )xs rz$Argument.set_value..srcj|gzSr6r7r>rs rr?z$Argument.set_value..sTZ1#-rcjdzSr0rArBs rr?z$Argument.set_value..s TZ!^rN)rr rrr)rr7r:funcs` rr;zArgument.set_valuesk {  9D 9  ----D   ,,+++Dd5kk rcX|jturt|jS|jduS)a/ Returns whether the argument was ever given a (non-default) value. For most argument kinds, this simply checks whether the internally stored value is non-``None``; for others, such as ``list`` kinds, different checks may be used. .. versionadded:: 1.3 N)r rr3rr.s r got_valuezArgument.got_values. 9   $$ ${$&&r)T)r( __module__ __qualname____doc__r'rrrr3rr,propertyr rr$r4r7setterr;rFr rrrrs  H#!!%" ##'$#$#sm$#}$# $# # $# sm $#$#$#$#C=$# $#$#$#$#L #    ( /hsm / / /X /5c?XTXHsHHHXH \'''''\'""s"$"$""""@ '4 ' ' 'X ' ' 'rrN)typingrrrrrr rrrMse111111111111 k'k'k'k'k'k'k'k'k'k'r