U e(C@sdZddlZddlmZddlmZddlmZmZm Z m Z m Z m Z m Z ddlmZddlmZmZdd d d gZd Zd dZddZdddZddZddZdd Zddd ZddZdd ZdS)z^ Assembling ~~~~~~~~~~ Functions and classes to properly assemble your commands in a parser. N) OrderedDict)COMPLETION_ENABLED) ATTR_ALIASES ATTR_ARGSATTR_EXPECTS_NAMESPACE_OBJECT ATTR_NAMEDEFAULT_ARGUMENT_TEMPLATE DEST_FUNCTIONPARSER_FORMATTER)AssemblingError) get_arg_specget_subparsersSUPPORTS_ALIASESset_default_command add_commandsadd_subcommandsTc #st|tdrdSt|}ttdd|j|jp.gfD}|t|ddpLit|dg}tdd|j D}dd|j|Dtfd dt Dt fd dD}|j|D]}g}i}||kr| |} t | trtd t|j| d ||ks||krv||kr8|j| |d n |jddd|dd|f}||r||dd}n|f}t dd|D}tfd|i|Vq|jrt|jgddVdS)NFcSsg|] }t|qS)reversed.0xrrn/mounts/lovelace/software/anaconda3/envs/qiime2-amplicon-2023.9/lib/python3.8/site-packages/argh/assembling.py ;sz,_get_args_from_signature..kwonlydefaults kwonlyargscss$|]\}}t|tr||fVqdSN) isinstancestr)rkvrrr @s z+_get_args_from_signature..cSsg|] }|dqS)rr)rarrrrFsc3s|]}||fVqdSr)countrchar)charsrrr Gsc3s|]}d|kr|VqdS)Nrr#) char_countsrrr Hs zDefining argument help messages via annotations is deprecated and will be removed in Argh 0.30. Please replace `f(a:"foo")` with `@arg("-a", help="foo")(a)`.help)defaultT)requiredz-{0}rz--{0}r&css(|] }|dr|ddn|VqdS)-_N) startswithreplacerrrrr jsoption_strings*)r0nargs)getattrrr dictzipargsdefaultsupdate__annotations__itemssettuplegetrrwarningswarnDeprecationWarningformatr.varargs) functionspecr7kwonly annotationsZconflicting_optsnameflagsZakwargsvaluer)r'r%r_get_args_from_signature5sF "        rJcCsi}d}|d}|dk rnt|trD|ddkrn|r:dnd|d<n*|ddkrn|dd|krnt||d<|d rdt|t|krt|d d |d<t|f|S) z Adds types, actions, etc. to given argument specification. For example, ``default=3`` implies ``type=int``. :param arg: a :class:`argh.utils.Arg` instance )storeappendr*Naction store_false store_truetyperKchoicesr)r=rboolrPlistr4)kwargsZguessedZTYPE_AWARE_ACTIONSrIrrr_guessss   rUr,cCs6|r |dstd|ddt|r.dSdSdS)NrzExpected at least one argumentFT) ValueErrorr.r<)r6 prefix_charsrrr_is_positionals  rXcCsN|}|d}t||jdr&|j}n|j}|||}|ddd|d<|S)Nr0)rWdestr,r-)copyrXrW_get_positional_kwargs_get_optional_kwargsr/)parserargspecr6Z get_kwargsrTrrr_get_parser_param_kwargss r_cCst||}|dS)NrY)r_)r]r^rTrrr _get_dests r`c sFt|}t|tg}tt|}|r:|r:t|D]}t||d}||<q6|D]}t||}|krt|d}t|d} || krddd} t dj |j || | | |d|j f|qVt|dt|d g} | r||<qVfd d D} t d j d |d|j d dd | DdqV}|pB|} dd| D} | D]}|}d|krx|j td|d}|jrd|krdd|D}|dd}z"|j||}tr|r||_WnDtk r}z$t|dj d ||j |dW5d}~XYnXqV|jr2|js2|j|_|jft|idS)a Sets default command (i.e. a function) for given parser. If `parser.description` is empty and the function has a docstring, it is used as the description. .. note:: If there are both explicitly declared arguments (e.g. via :func:`~argh.decorators.arg`) and ones inferred from the function signature, declared ones will be merged into inferred ones. If an argument does not conform to the function signature, `AssemblingError` is raised. .. note:: If the parser was created with ``add_help=True`` (which is by default), option name ``-h`` is silently removed from any argument. rYr0 positionaloptional)TFzc{func}: argument "{dest}" declared as {kind_i} (in function signature) and {kind_d} (via decorator))funcrYZkind_iZkind_dvarkwkeywordsc3s|]}|dVqdS)r0NrrZdestsrrr sz&set_default_command..z?{func}: argument {flags} does not fit function signature: {sig}z, css|]}d|VqdS)/N)joinrrrrr s)rHrcsigcSsg|] }t|qSr)rUrrrrrsz'set_default_command..r)r(-hcSsg|]}|dkr|qS)rjrrrrrrs completerNz${func}: cannot add arg {args}: {msg}rg)r6rcmsg)r r3rrSrJrr_r`rXr rA__name__r8rhvaluesrZrpopadd_help add_argumentrrk ExceptionrP__doc__ description set_defaultsr )r]rCrDZ declared_argsZ inferred_argsr^rYZ declared_kwZdecl_positionalZinfr_positionalkindsrdZxs command_argsZdraftZdest_or_opt_stringsrkrMerrfrrs                   cCs|pi}|r tdt||d<|r8tdt||d<|rPtdt||d<t|dd}|rd|di} |j|f| } | jf|}n |rtd |D]6} t| \} } |r| ||j| f| }t || qd S) ah Adds given functions as commands to given parser. :param parser: an :class:`argparse.ArgumentParser` instance. :param functions: a list of functions. A subparser is created for each of them. If the function is decorated with :func:`~argh.decorators.arg`, the arguments are passed to :meth:`argparse.ArgumentParser.add_argument`. See also :func:`~argh.dispatching.dispatch` for requirements concerning function signatures. The command name is inferred from the function name. Note that the underscores in the name are replaced with hyphens, i.e. function name "foo_bar" becomes command name "foo-bar". :param namespace: an optional string representing the group of commands. For example, if a command named "hello" is added without the namespace, it will be available as "prog.py hello"; if the namespace if specified as "greet", then the command will be accessible as "prog.py greet hello". The namespace itself is not callable, so "prog.py greet" will fail and only display a help message. :param func_kwargs: a `dict` of keyword arguments to be passed to each nested ArgumentParser instance created per command (i.e. per function). Members of this dictionary have the highest priority, so a function's docstring is overridden by a `help` in `func_kwargs` (if present). :param namespace_kwargs: a `dict` of keyword arguments to be passed to the nested ArgumentParser instance under given `namespace`. Deprecated params that should be moved into `namespace_kwargs`: :param title: .. deprecated:: 0.26.0 This argument will be removed in Argh v.0.30. Please use `namespace_kwargs` instead. :param description: .. deprecated:: 0.26.0 This argument will be removed in Argh v.0.30. Please use `namespace_kwargs` instead. :param help: .. deprecated:: 0.26.0 This argument will be removed in Argh v.0.30. Please use `namespace_kwargs` instead. .. note:: This function modifies the parser object. Generally side effects are bad practice but we don't seem to have any choice as ArgumentParser is pretty opaque. You may prefer :meth:`~argh.helpers.ArghParser.add_commands` for a bit more predictable API. .. note:: An attempt to add commands to a parser which already has a default function (e.g. added with :func:`~argh.assembling.set_default_command`) results in `AssemblingError`. zvArgument `title` is deprecated in add_commands(), it will be removed in Argh 0.30. Please use `parser_kwargs` instead.rtzuArgument `help` is deprecated in add_commands(), it will be removed in Argh 0.30. Please use `parser_kwargs` instead.r)z|Argument `description` is deprecated in add_commands(), it will be removed in Argh 0.30. Please use `parser_kwargs` instead.T)createtitlez2`parser_kwargs` only makes sense with `namespace`.N) r>r?r@r r= add_parseradd_subparsersrV_extract_command_meta_from_funcr8r)r] functions namespacenamespace_kwargsZ func_kwargsrzrtr)Zsubparsers_actionZsubsubparser_kwZ subsubparserrccmd_namefunc_parser_kwargsZcommand_parserrrrr4sDZ    cCs:t|t|jdd}|jtd}t|tg|d<||fS)Nr-r,)r)formatter_classaliases)r3rrmr/rsr r)rcrrrrrr}s r}cKst||||ddS)a A wrapper for :func:`add_commands`. These examples are equivalent:: add_commands(parser, [get, put], namespace='db', namespace_kwargs={ 'title': 'database commands', 'help': 'CRUD for our silly database' }) add_subcommands(parser, 'db', [get, put], title='database commands', help='CRUD for our silly database') )rrN)r)r]rr~rrrrrs )r,)NNNNNN)rsr> collectionsrZargh.completionrZargh.constantsrrrrrr r Zargh.exceptionsr Z argh.utilsr r __all__rrJrUrXr_r`rrr}rrrrr s:  $   >