o )Ti<&@sdZddlZddlmZmZmZmZddlmZm Z m Z ddl m Z ddl mZddlmZmZdd lmZdd lmZmZgd ZeeefZeeeed ffZeeeeeefZd dZddedddde fdedeeededeeeefde de de dee fddZ!de fddZ"ddZ#d e dede de de ddf d!d"Z$de fd#d$Z%d e de de de def d%d&Z&d'd(Z'dS))z+Simple creation of command line interfaces.N)AnyCallableOptionalUnion)ActionConfigFile_ActionPrintConfigremove_actions)ArgumentParser)%deprecation_warning_cli_return_parser) Namespacedict_to_namespace)get_doc_short_description)capture_parserdefault_config_option_help)CLIauto_cli auto_parserDictComponentsTypecOst|ddi|S)zAlias of :func:`auto_cli`. _stacklevelrargskwargsrE/home/ubuntu/.local/lib/python3.10/site-packages/jsonargparse/_cli.pyrsrTF componentsr config_help set_defaults as_positionalreturn_instance fail_untyped parser_classc sz|dd} |dd} |dur6t| dd} t| fdd tD}t|dkr6td t|t rFt|dkrF|d}n|sLtd t|t rYd d |D} nt|t rlt |} d d | D} ndd |fD} | r}td| |di|}|j dt|dt|t t fst|||||||dur||| rt| |S||}||}t||St|t rdd|D}t|||||||dur||| rt| |S||}||}t |}|d}t||tr1t||dtr1|d||d}||vr|}nnt||tr1t||dts ||}t|||S)a\Simple creation of command line interfaces. Previously called ``jsonargparse.CLI``, renamed to follow the standard of functions in lowercase. Creates an argument parser from one or more functions/classes, parses arguments and runs one of the functions or class methods depending on what was parsed. If the ``components`` parameter is not given, then the components will be all the locals in the context and defined in the same module as from where ``auto_cli`` is called. Args: components: One or more functions/classes to include in the command line interface. args: List of arguments to parse or ``None`` to use ``sys.argv``. config_help: Help string for config file option in help. set_defaults: Dictionary of values to override components defaults. as_positional: Whether to add required parameters as positional arguments. return_instance: Whether class components should be instantiated directly and returned, i.e. without exposing class methods as subcommands. fail_untyped: Whether to raise exception if a required parameter does not have a type. parser_class: The :class:`ArgumentParser` subclass to use. **kwargs: Used to instantiate :class:`.ArgumentParser`. Returns: The value returned by the executed function or class method. return_parserFrNrrcs0g|]}t|s t|rt|ur|qSr)inspectisclasscallable getmodule).0vmodulerr Hs  zauto_cli..zEither components parameter must be given or there must be at least one function or class among the locals in the context where CLI is called.z-components parameter expected to be non-emptycS"g|] }t|st|s|qSrr&r'r(r*crrrr.X"cSs0g|]\}}|dst|st|s|qS)z._help)endswithr&r'r()r*kr2rrrr.[s0cSr/rr0r1rrrr.]r3z.Unexpected components, not class or function: --configactionhelpcSsi|]}|j|qSr)__name__r1rrr pszauto_cli.. subcommand.r)popr&stackr)varsvalueslen ValueError isinstancelistdictr items add_argumentr_add_component_to_parserrr parse_argsinstantiate_classes_run_component_add_subcommandsgetr str)rrrrr r!r"r#rr$ stacklevelcaller unexpectednsparsercfginit components_nsr< subsubcommand componentrr,rrsp $                 ( (rreturncstfddS)zSame as :func:`.auto_cli`, but returns the parser, doesn't parse arguments or run. This is a shorthand for ``capture_parser(lambda: auto_cli(*args, **kwargs))``. cstiSNrrrrrszauto_parser..)rrrrrrsrcCs0t|tr |dSt||d}|st|}|S)N_help)logger)rDrFrNrrO)rYr^help_strrrr get_help_strs   r`rTc Cs|jdd}|D]G\}}|dkrq t||j} t|| d} | jdt|d|j|| | dt|t r?t || ||||q t || ||||} | sQt | tt fq dS)NTrequiredr] descriptionr6r7r9)add_subcommandsrGr`r^typerHradd_subcommandrDrFrMrIr r) rrTrr r!r" subcommandsnamerYrd subparser added_argsrrrrMs"    rMcCs|t|jvSr[)r& signature parameters)rYrjrrr has_parametersrocsZ||dd}t|rddt|D}|s|s0|j|fddi|}|js.t||j|_|S|j|fi|}|jdd} |D]Rt|} t| |j} t || d} t | t st | d sg| j d t|d | j|fddi|} |fd d| D7}| st| ttf| j| t| |jd qA|S|j|fddi|}|jst||j|_|S)NT)r r" sub_configscSs2g|]\}}t|st|tr|ddkr|qS)r_)r(rDproperty)r*r5r+rrrr.s  z,_add_component_to_parser..as_groupFrarcconfigr6r7csg|] }d|qS)r=r)r*amethodrrr.sre)r&r' getmembersadd_class_argumentsrdr`r^rfgetattrrgrDrrrorHradd_method_argumentsr rrhadd_function_arguments)rYrTr r!r"rr class_methodsrlri method_objectrdrk added_subargsrrvrrIs:       rIcCs|dd|d}t|r9|r9||i}|dd|di|}tt||tr2t||St||}|}t|rJtd|di|S|di|S)Nrtr<asyncior) r>r&r'rDrzrriscoroutinefunction __import__run)rYrUr<subcommand_cfg component_objrrrrLs       rL)(__doc__r&typingrrrr_actionsrrr _corer _deprecatedr _namespacer r _optionalsr_utilrr__all__rg ComponentTyperFrOrrEComponentsTyperboolrrr`rMrorIrLrrrrs      i   '