o Th@s*ddlmZmZmZmZGdddZdS))AnyIterableOptionalTuplec@seZdZdZddeddddddf deedeededeed eed ed ed ed eeddfddZ defddZ e deefddZ e de edffddZe defddZe defddZejdeddfddZd%ded eddfd!d"Ze defd#d$ZdS)&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 Cs|r|rtd|s|std|rt||_n|r |s |f|_||_d} |tur+g} |r/|} | |_|_||_||_||_ ||_ ||_ | |_ 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 r r rrr) selfrr r r r r rrr initial_valuerrI/var/www/html/venv/lib/python3.10/site-packages/invoke/parser/argument.py__init__*s.    zArgument.__init__cCsd}|jrdd|j}d}|js|jrd}|jr|d7}|jr&|d7}d}|jtkr4d|jj}d|jj|j |||S) Nz ({})z,  *?z [{}]z<{}: {}{}{}{}>) nicknamesformatjoinr rr str__name__ __class__r)rnicksflagsr rrr__repr__Ps   zArgument.__repr__cCs|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 rrrrrds z Argument.name.cCs|jddSN)r r(rrrrpszArgument.nicknamescCs|jturdS|jr dSdS)NFT)r boolrr(rrr takes_valuets zArgument.takes_valuecCs|jdur|jS|jSN)rr r(rrrvalue|szArgument.valueargcCs|j|dddS)NT)cast) set_value)rr/rrrr.sTr.r0csN|_dd}|r j}jturfdd}jr fdd}||_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 cSs|Sr-rxrrrsz$Argument.set_value..cs j|gSr-r.r2r(rrr4s cs jdSr)r5r2r(rrr4s N)rr rrr)rr.r0funcrr(rr1s   zArgument.set_valuecCs|jtur t|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 rr+rr(rrr got_values  zArgument.got_value)T)r# __module__ __qualname____doc__r"rrrr+rr'propertyrrrr,r.setterr1r7rrrrrs\$   &  rN)typingrrrrrrrrrs