⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.144
Server IP:
157.245.143.252
Server:
Linux www 6.11.0-9-generic #9-Ubuntu SMP PREEMPT_DYNAMIC Mon Oct 14 13:19:59 UTC 2024 x86_64
Server Software:
nginx/1.26.0
PHP Version:
8.3.11
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
lib
/
python3
/
dist-packages
/
__pycache__
/
View File Name :
configargparse.cpython-312.pyc
:d^ d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl Z e j dk\ rddlmZ nddlmZ ej" ej$ ej& ej( ej* gZe j dk\ r ej/ ej0 d Znd Z ee Zi Zd/d Z d/d Z G d d ej< ej> ej@ Z! G d de" Z# G d de$ Z% G d de# Z& G d de# Z' G d de# Z( ejR d Z* ejR dejV Z, ejZ dd d0d Z.d0d Z/d Z0d Z1 G d! d"e# Z2 G d# d$e# Z3 G d% d&e# Z4d'Z5d(Z6d)Z7d*Z8 G d+ d,ejr Z9d- Z:d. Z;ejx jt ejx _= e:ejx _: ej| Z>ej< Z ej~ Z?ej Z@ej ZAej ZBej ZCej ZDej@ Z ej> Z ej ZEej ZFej ZGej ZHej ZIej ZJe ZKe ZLe ZMe ZNe ZOe ZPe9ZQe9ZRejx jt ejx _S ejx jt ejx _T e9j e9_V e9j e9_X e ZYe ZZe!Z[y)1z A drop-in replacement for `argparse` that allows options to also be set via config files and/or environment variables. :see: `configargparse.ArgumentParser`, `configargparse.add_argument` N) OrderedDict) r )StringIO)r c 6 t | t j S N) isinstanceargparseBooleanOptionalActionactions 0/usr/lib/python3/dist-packages/configargparse.py<lambda>r s 68CaCa0b c y)NF r s r r r ! s r c | d} | t v rt d| dt | |j dt j |j dd t di |t | < y) zCreates a global ArgumentParser instance with the given name, passing any args other than "name" to the ArgumentParser constructor. This instance can then be retrieved using get_argument_parser(..) Ndefaultz=kwargs besides 'name' can only be passed in the first time. 'z!' ArgumentParser already exists: formatter_classconflict_handlerresolver )_parsers ValueError setdefaultr ArgumentDefaultsHelpFormatterArgumentParsernamekwargss r init_argument_parserr ) sl | x (4." # # ')O)OP ()4#-f-HTNr c ` | d} t | dkD s| t vr t | fi | t | S )a Returns the global ArgumentParser instance with the given name. The 1st time this function is called, a new ArgumentParser instance will be created for the given name, and any args other than "name" will be passed on to the ArgumentParser constructor. r r )lenr r r s r get_argument_parserr# < s7 | 6{Q$h. T,V, D>r c e Zd ZdZy) ArgumentDefaultsRawHelpFormatterzCHelpFormatter that adds default values AND doesn't do line-wrappingN__name__ __module__ __qualname____doc__r r r r% r% K s Nr r% c " e Zd ZdZd Zd Zd Zy)ConfigFileParserzRThis abstract class can be extended to add support for new config file formatsc t d )z3Returns a string describing the config file syntax.z*get_syntax_description(..) not implementedNotImplementedErrorselfs r get_syntax_descriptionz'ConfigFileParser.get_syntax_descriptionW s !"NOOr c t d )aU Parses the keys and values from a config file. NOTE: For keys that were specified to configargparse as action="store_true" or "store_false", the config file value must be one of: "yes", "no", "on", "off", "true", "false". Otherwise an error will be raised. Args: stream (IO): A config file input stream (such as an open file object). Returns: OrderedDict: Items where the keys are strings and the values are either strings or lists (eg. to support config file formats like YAML which allow lists). zparse(..) not implementedr. )r1 streams r parsezConfigFileParser.parse[ s ""=>>r c t d )a Does the inverse of config parsing by taking parsed values and converting them back to a string representing config file contents. Args: items: an OrderedDict of items to be converted to the config file format. Keys should be strings, and values should be either strings or lists. Returns: Contents of config file as a string z serialize(..) not implementedr. )r1 itemss r serializezConfigFileParser.serializel s ""ABBr Nr' r( r) r* r2 r5 r8 r r r r, r, S s P?" Cr r, c e Zd ZdZy)ConfigFileParserExceptionz'Raised when config file parsing failed.Nr& r r r r; r; { s 1r r; c " e Zd ZdZd Zd Zd Zy)DefaultConfigFileParsera Based on a simplified subset of INI and YAML formats. Here is the supported syntax .. code:: # this is a comment ; this is also a comment (.ini style) --- # lines that start with --- are ignored (yaml style) ------------------- [section] # .ini-style section names are treated as comments # how to specify a key-value pair (all of these are equivalent): name value # key is case sensitive: "Name" isn't "name" name = value # (.ini style) (white space is ignored, so name = value same as name=value) name: value # (yaml style) --name value # (argparse style) # how to set a flag arg (eg. arg which has action="store_true") --name name name = True # "True" and "true" are the same # how to specify a list arg (eg. arg which has action="append") fruit = [apple, orange, lemon] indexes = [1, 12, 35 , 40] c d}|S )NzrConfig file syntax allows: key=value, flag=true, stuff=[a,b,c] (for details, see syntax at https://goo.gl/R74nmi).r r1 msgs r r2 z.DefaultConfigFileParser.get_syntax_description s E r c t }t | D ]# \ }}|j }|r|d dv s|j d r2t j d| }|r|j d }|j d }|j d }|j d } | ||d k7 rd }n|d }|j d r'|j d r t j | }| r!| j dd j } |||< t dj |t |dd | |S # t $ r?} |dd j d D cg c] } | j nc c} w }} Y d } ~ d } ~ ww xY w)Nr )#;[z---zn^(?P<key>[^:=;#\s]+)\s*(?:(?P<equal>[:=\s])\s*([\'"]?)(?P<value>.+?)?\3)?\s*(?:\s[;#]\s*(?P<comment>.*?)\s*)?$keyequalvaluecomment truerD ] ,z Unexpected line {} in {}: {}r r4 )r enumeratestrip startswithrematchgroupendswithjsonloads Exceptionsplitr; formatgetattr) r1 r4 r7 ilinerT rE rF rG rH eelems r r5 z DefaultConfigFileParser.parse s (GAt::<D47o5 9OHH FGKME kk%( G, G, ++i0=U%65C< E] "E##C(U^^C-@R $ 5 1 %mmoab 1 7 7 9G "c /0N0U0UVWFFH5t1= > >9 )< % R:?"+:K:KC:P Q:P$ :P Q QRs$ D?? FF E65FFc t }|j D ][ \ }}t |t r%ddj t t | z dz }|j dj || ] |j S )NrD , rL z{} = {} ) r r7 r listjoinmapstrwriter[ getvalue)r1 r7 rrE rG s r r8 z!DefaultConfigFileParser.serialize sl J ++-JC%&DIIc#uo 66s: GGK&&sE2 3 ( zz|r Nr9 r r r r= r= s : "H r r= c " e Zd ZdZd Zd Zd Zy) ConfigparserConfigFileParserz,parses INI files using pythons configparser.c d}|S )Na Uses configparser module to parse an INI file which allows multi-line values. Allowed syntax is that for a ConfigParser with the following options: allow_no_value = False, inline_comment_prefixes = ("#",) strict = True empty_lines_in_values = False See https://docs.python.org/3/library/configparser.html for details. Note: INI file sections names are still treated as comments. r r? s r r2 z3ConfigparserConfigFileParser.get_syntax_description s r c dd l }ddlm} |j dddddd } |j |j t }|j D ]v }|| j D ]^ \ }} | j d d j d d } d | v r.d | v r*| j d d } d| vr || ||< T| ||< Z| ||< ` x |S # t $ r}t d|z d }~ww xY w)Nr ) literal_eval)=:F)rB rC T) delimitersallow_no_valuecomment_prefixesinline_comment_prefixesstrictempty_lines_in_values Couldn't parse config file: %s rI rD rL {) configparserastrn ConfigParser read_stringreadrY r; r sectionsr7 replacerZ ) r1 r4 r{ rn configr_ resultsectionkvmultiLine2SingleLineprelist_strings r r5 z"ConfigparserConfigFileParser.parse s $ ** &$-"' + R v{{} - (G g,,.!'(yyc':'B'B4'L$..3:N3N%9%?%?%DQ%GN.0$01E$Fq $8q 4F1I / ) % R+,Lq,PQ Q Rs C C3 C..C3c dd l }dd l}|j dddd }d|i}|j | |j }|j | |j d |j S )Nr F)rB T)rr rt ru rv DEFAULT)r{ ior} read_dictr rg seekr )r1 r7 r{ r r r4 s r r8 z&ConfigparserConfigFileParser.serialize sq ** $*"' + E" V A{{} r Nr9 r r r rk rk s 6"!F r rk c * e Zd ZdZd Zd Zd ZddZy)YAMLConfigFileParserzdParses YAML config files. Depends on the PyYAML module. https://pypi.python.org/pypi/PyYAML c d}|S )NzThe config file uses YAML syntax and must represent a YAML 'mapping' (for details, see http://learn.getgrav.org/advanced/yaml).r r? s r r2 z+YAMLConfigFileParser.get_syntax_description s S r c ddl } ddl m} ddl m} |||fS # t $ r t d w xY w# t $ r ddl m} ddl m} Y 4w xY w)zjlazy-import PyYAML so that configargparse doesn't have to depend on it unless this parser is used.r NzJCould not import yaml. It can be installed by running 'pip install PyYAML') CSafeLoader)CDumper) SafeLoader)Dumper)yaml ImportErrorr; r r r r )r1 r r r s r _load_yamlz YAMLConfigFileParser._load_yaml$ sc G $ 6 . Z'' G+ -F G G G $ ' # $s 0 -AAc | j \ }}} |j || }t |t s0t dt |dd dt | j d t }|j D ], \ }} t | t r| ||< | t | ||< . |S # t $ r}t d|z d }~ww xY w)N)Loaderrw z_The config file doesn't appear to contain 'key: value' pairs (aka. a YAML mapping). yaml.load('r r4 z') returned type 'z' instead of 'dict'.) r loadrY r; r dictr\ typer' r r7 rc rf ) r1 r4 r r _ parsed_objr_ r rE rG s r r5 zYAMLConfigFileParser.parse6 s "oo /j! R 6*=J *d++ 1D4D4M4M-O P P $**,JC%& #s !%js - % R+,Lq,PQ Q Rs B4 4 C=C Cc h | j \ }}}t | }|j ||| S )N)default_flow_styler )r r dump)r1 r7 r r r r s r r8 z YAMLConfigFileParser.serializeP s7 //+a U yy3EfyUUr NF)r' r( r) r* r2 r r5 r8 r r r r r s ($4Vr r z1(^\"(?:\\.|[^\"\\])*\"$)|(^\'(?:\\.|[^\'\\])*\'$)z(^\"\"\"(\s+)?(([^\"]|\"([^\"]|\"[^\"]))*(\"\"?)?)?(\s+)?(?:\\.|[^\"\\])?\"\"\"$)|(^\'\'\'(\s+)?(([^\']|\'([^\']|\'[^\']))*(\'\'?)?)?(\s+)?(?:\\.|[^\'\\])?\'\'\'$))flags T)maxsizetypedc t t j | xs" |xr t t j | S )zu Detect whether a string is a quoted representation. :param triple: Also match tripple quoted strings. )bool_QUOTED_STR_REGEXrT _TRIPLE_QUOTED_STR_REGEX)texttriples r is_quotedr } s= !''- . @ >D177=>@r c t | | r+ t j | }t |t sJ |S | S # t $ r}t d| d| |d}~ww xY w)a Unquote a maybe quoted string representation. If the string is not detected as being a quoted representation, it returns the same string as passed. It supports all kinds of python quotes: ``"""``, ``'''``, ``"`` and ``'``. :param triple: Also unquote tripple quoted strings. @raises ValueError: If the string is detected as beeing quoted but literal_eval() fails to evaluate it as string. This would be a bug in the regex. r z+Error trying to unquote the quoted string: : N)r r| rn r rf rY r )r r sr_ s r unquote_strr ss f% _ &A a% %% K _ J4&PRSTRU VW]^ ^ _s '; AAAc g }t j | gd D ]3 }|D ], }|j t |j d . 5 t | S )u Parse a TOML section name to a sequence of strings. The following names are all valid: .. python:: "a.b.c" # this is best practice -> returns ("a", "b", "c") " d.e.f " # same as [d.e.f] -> returns ("d", "e", "f") " g . h . i " # same as [g.h.i] -> returns ("g", "h", "i") ' j . "ʞ" . "l" ' # same as [j."ʞ"."l"], double or simple quotes here are supported. -> returns ("j", "ʞ", "l") .) delimiterFr )csvreaderappendr rQ tuple) section_namer rowas r parse_toml_section_namer sO Gzz<.C8A NN;qwwy? @ 9 >r c t |t r t | n|}| j |d }|sy|dd }|r t || S t |t sy|S )z Given some TOML data (as loaded with `toml.load()`), returns the requested section of the data. Returns ``None`` if the section is not found. r NrM )r rf r getget_toml_sectionr )datar r itemdatas r r r s` 4>gs3K&w/QXHxx $H |H (33(D)r c 4 e Zd ZdZ fdZd Zd Zd Z xZS )TomlConfigParsera( Create a TOML parser bounded to the list of provided sections. Example:: # this is a comment [tool.my-software] # TOML section table. # how to specify a key-value pair format-string = "restructuredtext" # strings must be quoted # how to set an arg which has action="store_true" warnings-as-errors = true # how to set an arg which has action="count" or type=int verbosity = 1 # how to specify a list arg (eg. arg which has action="append") repeatable-option = ["https://docs.python.org/3/objects.inv", "https://twistedmatrix.com/documents/current/api/objects.inv"] # how to specify a multiline text: multi-line-text = ''' Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus tortor odio, dignissim non ornare non, laoreet quis nunc. Maecenas quis dapibus leo, a pellentesque leo. ''' Note that the config file fragment above is also valid for the `IniConfigParser` class and would be parsed the same manner. Thought, any valid TOML config file will not be necessarly parsable with `IniConfigParser` (INI files must be rigorously indented whereas TOML files). See the `TOML specification <>`_ for details. c 0 t | || _ y)zO :param sections: The section names bounded to the new parser. N)super__init__r )r1 r __class__s r r zTomlConfigParser.__init__ s r c | S r r r0 s r __call__zTomlConfigParser.__call__ r c F ddl } |j | }t }| j D ]R }t || }|s|j D ], \ }} t | t r| ||< | t | ||< . |S |S # t $ r}t d|z d}~ww xY w)z3Parses the keys and values from a TOML config file.r Nz Couldn't parse TOML file: %s) tomlr rY r; r r r r7 r rc rf ) r1 r4 r r r_ r r r rE rG s r r5 zTomlConfigParser.parse s PYYv&F }}G#FG4D #'**,JC!%.&+s &)%js #/ % + P+,JQ,NO O Ps B B BB c y)NzConfig file syntax is Tom's Obvious, Minimal Language. See https://github.com/toml-lang/toml/blob/v0.5.0/README.md for details.r r0 s r r2 z'TomlConfigParser.get_syntax_description s [r r' r( r) r* r r r5 r2 __classcell__r s @r r r s 8!:\r r c 4 e Zd ZdZ fdZd Zd Zd Z xZS )IniConfigParsera Create a INI parser bounded to the list of provided sections. Optionaly convert multiline strings to list. Example (if split_ml_text_to_list=False):: # this is a comment ; also a comment [my-software] # how to specify a key-value pair format-string: restructuredtext # white space are ignored, so name = value same as name=value # this is why you can quote strings quoted-string = ' hello mom... ' # how to set an arg which has action="store_true" warnings-as-errors = true # how to set an arg which has action="count" or type=int verbosity = 1 # how to specify a list arg (eg. arg which has action="append") repeatable-option = ["https://docs.python.org/3/objects.inv", "https://twistedmatrix.com/documents/current/api/objects.inv"] # how to specify a multiline text: multi-line-text = Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus tortor odio, dignissim non ornare non, laoreet quis nunc. Maecenas quis dapibus leo, a pellentesque leo. Example (if split_ml_text_to_list=True):: # the same rules are applicable with the following changes: [my-software] # how to specify a list arg (eg. arg which has action="append") repeatable-option = # Just enter one value per line (the list literal format can also be used) https://docs.python.org/3/objects.inv https://twistedmatrix.com/documents/current/api/objects.inv # how to specify a multiline text (you have to quote it): multi-line-text = ''' Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus tortor odio, dignissim non ornare non, laoreet quis nunc. Maecenas quis dapibus leo, a pellentesque leo. ''' c > t | || _ || _ y)z :param sections: The section names bounded to the new parser. :split_ml_text_to_list: Wether to convert multiline strings to list N)r r r split_ml_text_to_list)r1 r r r s r r zIniConfigParser.__init__2 s %:"r c | S r r r0 s r r zIniConfigParser.__call__; r r c ddl }|j } |j |j t }|j |j gz D ] }|| j vr|| j D ] \ }}|j } | s| j d r+| j d r t j | ||< Ut# | r t% | ||< p| j& rCd|j) d v r0 | j+ d D cg c] } | st% | c} ||< |||< |S # t $ r}t d|z d}~ww xY w# t $ r }t dt! | z dz |d}~ww xY w# t $ r}t t! | |d}~ww xY wc c} w # t $ r}t t! | |d}~ww xY w) z3Parses the keys and values from an INI config file.r NzCouldn't parse INI file: %srD rL zError evaluating list: z;. Put quotes around your text if it's meant to be a string.rx )r{ r} r~ r rY r; r r DEFAULTSECTr7 rQ rR rV r| rn r rf r r r rstriprZ ) r1 r4 r{ r r_ r r r r strip_vr] s r r5 zIniConfigParser.parse> s **, O v{{} - (L,D,D+EEGdmm+ g,,.!'') %%c*w/?/?/Dc$'$4$4W$=q !)K(3G(<F1I 338NKAH tAT(ZATAXYQ AT(ZF1I %&q 9 / F@ K O+,IA,MN N O" & c 78QTWXYTZ8Z ^[ 9[ \ bc cc * K";CF"C JK )[ ) K";CF"C JKsw E >E+#FG%F=- F=:G E(E##E(+ F4FF F: F55F:=G G% G G%c , d}| j r|dz }|S )NzUses configparser module to parse an INI file which allows multi-line values. See https://docs.python.org/3/library/configparser.html for details. This parser includes support for quoting strings literal as well as python list syntax evaluation. z{Alternatively lists can be constructed with a plain multiline string, each non-empty line will be converted to a list item.)r r? s r r2 z&IniConfigParser.get_syntax_descriptionl s+ v % % H IC r r r s @r r r s )V;,\r r c 4 e Zd ZdZ fdZd Zd Zd Z xZS )CompositeConfigParserz Createa a config parser composed by others `ConfigFileParser`s. The composite parser will successively try to parse the file with each parser, until it succeeds, else raise execption with all encountered errors. c ` t | |D cg c] } | c}| _ y c c}w r )r r parsers)r1 config_parser_typespr s r r z CompositeConfigParser.__init__} s+ %89%8%89 9s +c | S r r r0 s r r z CompositeConfigParser.__call__ r r c g }| j D ] } |j | c S t ddj d |D # t $ r,}|j d |j | Y d }~ld }~ww xY w)Nr zError parsing config: rb c 3 D K | ] }t t | y wr )reprrf ).0r_ s r <genexpr>z.CompositeConfigParser.parse.<locals>.<genexpr> s 2PA4A<s )r r5 rY r r r; rd )r1 r4 errorsr r_ s r r5 zCompositeConfigParser.parse s A !wwv& ((2P2P)P(QRT T ! A a !s A B "A;;B c d }d}t | j D ]? \ }}|d|dz d ||j j d|j dz }A |S )Nc | j j d j dd j dd j dd }|r|j S dS )Nr parserrJ r filez??)lowerrQ r upper) classnamerQ s r guess_format_namezGCompositeConfigParser.get_syntax_description.<locals>.guess_format_name sV OO%++C088GHb)''&"*= $)5;;= 3t 3r z2Uses multiple config parser settings (in order): rD rM z] r z )rP r r r' r2 )r1 r r@ r] r s r r2 z,CompositeConfigParser.get_syntax_description sl 4 D"4<<0IAv Qqse2 /0@0@0I0I J K2fNkNkNmMnnqr rC 1 r r r s @r r r u s : T r r command_lineenvironment_variables config_filedefaultsc e Zd ZdZd Zdddej fdZdddej dfdZd Z ddZ d Z d Z d Z d Zd Zd Zej$ fdZd Zy)r zDrop-in replacement for `argparse.ArgumentParser` that adds support for environment variables and ``.ini`` or ``.yaml-style`` config files. c |j dd }|j dd }|j dd }|j dg }|j dd }|j d t }|j d g } |j d d } |j d d } |j dg } |j dd } |j dt | _ || _ || _ || _ t j j | g|i | |t | _ n | | _ || _ || _ | r | j | d| | dd | r | j | dd| dd yy)aR Supports args of the `argparse.ArgumentParser` constructor as \*\*kwargs, as well as the following additional args. Arguments: add_config_file_help: Whether to add a description of config file syntax to the help message. add_env_var_help: Whether to add something to the help message for args that can be set through environment variables. auto_env_var_prefix: If set to a string instead of None, all config- file-settable options will become also settable via environment variables whose names are this prefix followed by the config file key, all in upper case. (eg. setting this to ``foo_`` will allow an arg like ``--my-arg`` to also be set via the FOO_MY_ARG environment variable) default_config_files: When specified, this list of config files will be parsed in order, with the values from each config file taking precedence over previous ones. This allows an application to look for config files in multiple standard locations such as the install directory, home directory, and current directory. Also, shell \* syntax can be used to specify all conf files in a directory. For example:: ["/etc/conf/app_config.ini", "/etc/conf/conf-enabled/*.ini", "~/.my_app_config.ini", "./app_config.txt"] ignore_unknown_config_file_keys: If true, settings that are found in a config file but don't correspond to any defined configargparse args will be ignored. If false, they will be processed and appended to the commandline like other args, and can be retrieved using parse_known_args() instead of parse_args() config_file_open_func: function used to open a config file for reading or writing. Needs to return a file-like object. config_file_parser_class: configargparse.ConfigFileParser subclass which determines the config file format. configargparse comes with DefaultConfigFileParser and YAMLConfigFileParser. args_for_setting_config_path: A list of one or more command line args to be used for specifying the config file path (eg. ["-c", "--config-file"]). Default: [] config_arg_is_required: When args_for_setting_config_path is set, set this to True to always require users to provide a config path. config_arg_help_message: the help message to use for the args listed in args_for_setting_config_path. args_for_writing_out_config_file: A list of one or more command line args to use for specifying a config file output path. If provided, these args cause configargparse to write out a config file with settings based on the other provided commandline args, environment variants and defaults, and then to exit. (eg. ["-w", "--write-out-config-file"]). Default: [] write_out_config_file_arg_help_message: The help message to use for the args in args_for_writing_out_config_file. add_config_file_helpTadd_env_var_helpauto_env_var_prefixNdefault_config_files ignore_unknown_config_file_keysFconfig_file_parser_class args_for_setting_config_pathconfig_arg_is_requiredconfig_arg_help_messagezconfig file path args_for_writing_out_config_file&write_out_config_file_arg_help_messagezftakes the current command line args and writes them out to a config file at the given path, then exitsconfig_file_open_funcr )destrequiredhelpis_config_file_arg"write_out_config_file_to_this_pathCONFIG_OUTPUT_PATH)r metavarr is_write_out_config_file_arg)popr= open_config_file_open_func_add_config_file_help_add_env_var_help_auto_env_var_prefixr r r _config_file_parser_default_config_files _ignore_unknown_config_file_keys add_argument)r1 argsr r r r r r r r r r r r s r r zArgumentParser.__init__ s t &zz*@$ G !::&8$? $jj)> E %zz*@" E *0** -u+6'#)::.H.E$G '-zz *B(0$!',De!L "(**-F-?#A +1:: .,4(17 4 7%2&. '-jj1H$&O#%9"!1 $7! ((??? $ +'>'@D $'?'AD $%9"0O- ' D ;-/6M#' ) , D ?9,;-1 3 ,r Nc | j ||||d \ }}|r#| j ddj | z |S )a Supports all the same args as the `argparse.ArgumentParser.parse_args()`, as well as the following additional args. Arguments: args: a list of args as in argparse, or a string (eg. "-x -y bla") config_file_contents: String. Used for testing. env_vars: Dictionary. Used for testing. Returns: argparse.Namespace: namespace F)r namespaceconfig_file_contentsenv_varsignore_help_argszunrecognized arguments: %srI )parse_known_argserrorrd )r1 r r r r argvs r parse_argszArgumentParser.parse_args sP ** !5 " + $ d JJ3chhtnD E r Fc |t j dd }n,t |t r|j }n t | }| j D ] }|j |_ |r|D cg c] }|dvs| }}t | _ |r"dt | f}d|i| j t < | j | j D ] }| j | } | s|j r$|j r1|j r>|j rKt |t" j$ rft |t" j& r| d j) | j* } | j | z j- dd j/ |_ g } d} | j D cg c]K }|j s=|j r1|j |v r#t1 ||j | j* s|M } }| D ] }|j }|| }|j2 st |t" j4 r:d } |j7 d r'|j9 d r t; j< | }| | jA ||| z } | r|| z }n| |z }| rEt | D cg c] }|j |||j ff! c} | j tB < tE d | j D }|xr d|v xs d|v }| j D ci c] }| j | D ] }|| }}}g }|tG | }d|_$ |g}n|s| jK | }tM | D ]Z } | jN jQ | }tW |d r|jY g }d} j[ D ] \ }}||v r'|| }t1 ||j | j* }n7d}| j\ xs' t1 || j_ | g| j* }|rk|| jA ||| z }t` d|jH } | | j vrt | j | < ||f| j | |< |r |j2 st |t" j4 sd } | r||z }V||z }] t } | j D ] }|j xs |j2 tb td fv } t1 ||j | j* s1| r/|jf #|jf th k( st |tj r}|j r|j d }n |jl }|t |jf f| |< | r| | j tn < t" jp js | || \ }} | j D cg c]& }tu |dd rtu ||jl d ( } }| D cg c] }|| } }| jw || d || fS c c}w c c}w # t> $ r9 |dd j d D cg c] }|j) nc c}w }}Y w xY wc c}w c c}}w # tR $ r%}| jU t | Y d}~7d}~ww xY w# tW |d r|jY w w xY wc c}w c c}w )a Supports all the same args as the `argparse.ArgumentParser.parse_args()`, as well as the following additional args. Arguments: args: a list of args as in argparse, or a string (eg. "-x -y bla") config_file_contents (str). Used for testing. env_vars (dict). Used for testing. ignore_help_args (bool): This flag determines behavior when user specifies ``--help`` or ``-h``. If False, it will have the default behavior - printing help and exiting. If True, it won't do either. Returns: tuple[argparse.Namespace, list[str]]: tuple namescpace, unknown_args NrM )-h--helprJ r -r FTrD rL rN rO c 3 V K | ]! }t |t j s | # y wr )r r _HelpActionr r s r r z2ArgumentParser.parse_known_args.<locals>.<genexpr> s$ M$! 1h6J6J(KA}s ))r! r" z method argclose|)r r r ) exit_after)<sysr r rf rZ rc _actionsoption_stringsis_positional_argr _source_to_settings_COMMAND_LINE_SOURCE_KEYr get_possible_config_keysenv_varr r r _VersionActionr% rQ prefix_charsr r already_on_command_linenargs _AppendActionrR rV rW rX rY convert_item_to_command_line_arg_ENV_VAR_SOURCE_KEYanyr r _open_config_filesreversedr r5 r; r hasattrr' r7 r 4get_command_line_key_for_unknown_config_file_setting_CONFIG_FILE_SOURCE_KEYOPTIONAL ZERO_OR_MOREr SUPPRESS#ACTION_TYPES_THAT_DONT_NEED_A_VALUEr _DEFAULTS_SOURCE_KEYr r r\ write_config_file)!r1 r r r r r r arga_v_pairconfig_file_keysstripped_config_file_key env_var_argsr5 actions_with_env_var_valuesr rE rG r` supports_help_argskip_config_file_parsing config_keyknown_config_keysconfig_streamsr4 config_itemsr_ config_argsdiscard_this_key source_keydefault_settingscares_about_default_value unknown_argsoutput_file_pathss! r r z ArgumentParser.parse_known_args( s * <88AB<D c "::<D:D A&'&6&6"6A #'G4C36F+FC4DG $/= d4j)HBDh D $ $%= > $ $ 0]]#'#@#@#C #QYY!:M:M++q/M/M q("9"9: q("6"67/?/B/H/H ))0+,!%!:!:!9":;B73;LUUW I # 26-- '\-Q&&199h9N/a6F6FHYHYZ ()-# '\ 2F..C SME||z&(2H2H I ##C(U^^C-@R $ 5 1 D A AU $ $L 2 ,&D $&D <G 8: 8 ))a!))!4 56 8:=;D $ $%8 9 M}} M M#4 $. DL ,H , ! ?Cmm EmF " ; ;F C ( / C (m E + 23F&FK $XN) ! 4 4T :N ~.F # # 7 7 = =f E 67+LLN KE * 0 0 2 U++ .s 3F'> f 3 3T5F5F(H$ "F'+'L'L (// ! V VWZ [ \ - -/ % ( 4#H#H U$, ,K+BFKK!PJ!)A)AA?J}00<AGD,,Z8= 6<<"68+A+AB $- 30 k)"T)O /T '=mmF-3-E-E)E *9 < 88 &'f.C.CTEVEVW1NN*NNh. v'JK(( //3C ++C)/V^^1D(E % $ =MD $ $%9 : #+"9"9"J"J ty #K #2 < HL}} S}! '+I5 Q %Y =} S(9 K(91Q]Q(9 K y*; M,&&g H6'\ % R:?"+:K:KC:P Q:P$ :P Q QR: E - # 3q6"" # 67+LLN ,z S Ksy , Y6Y,AY Y$$Z Z 9Z"1+[5"[:*[: Z1Z ZZ" [+[ [ [[ [2c | j S )ar If called after `parse_args()` or `parse_known_args()`, returns a dict that contains up to 4 keys corresponding to where a given option's value is coming from: - "command_line" - "environment_variables" - "config_file" - "defaults" Each such key, will be mapped to another dictionary containing the options set via that method. Here the key will be the option name, and the value will be a 2-tuple of the form (`argparse.Action` obj, `str` value). Returns: dict[str, dict[str, tuple[argparse.Action, str]]]: source to settings dict )r. r0 s r get_source_to_settings_dictz*ArgumentParser.get_source_to_settings_dict s '''r c |D ] } | j |d 5 } ddd ! |r| j | j | }| j j | }|D ]. }| j |d 5 }|j | ddd 0 t ddj | z |r| j d yyy# 1 sw Y xY w# t $ r }t dj || d}~ww xY w# 1 sw Y xY w)a4 Write the given settings to output files. Args: parsed_namespace: namespace object created within parse_known_args() output_file_paths: any number of file paths to write the config to exit_after: whether to exit the program after writing the config files wNz Couldn't open {} for writing: {}zWrote config file to rb r ) r IOErrorr r[ get_items_for_config_file_outputr. r r8 rg printrd exit) r1 parsed_namespacerW r) output_file_path output_filer_ rP file_contentss r rD z ArgumentParser.write_config_file s !2 *001A3G; H !2 @@((*: <L 4 4 > >| LM$5 001A3G; %%m4 HG %6 )DII6G,HH I ! HG * !C!J!J$a") * * * HGs9 CCC5C<C C C9C44C9<D c f |j | j }| j d dz |z }|S )aM Compute a commandline arg key to be used for a config file setting that doesn't correspond to any defined configargparse arg (and so doesn't have a user-specified commandline arg key). Args: key: The config file key that was being set. Returns: str: command line key r )rQ r3 )r1 rE key_without_prefix_charscommand_line_keys r r= zCArgumentParser.get_command_line_key_for_unknown_config_file_setting s; $'99T->->#? ,,Q/14LL r c t }|j D ] \ }}|t k( r|d \ }}| j D ] }| j | } | s|j r$t ||j | j sFt ||j d } | `t | t rt | j } | || d < |t k( rS|j D ]> \ } \ }} | j | } | s t ||j d } | 7| || d < @ |j! t" r"|j D ] \ } \ }} | || < K|t$ k( sV|j D ]> \ } \ }} | j | } | s t ||j d } | 7| || d < @ |S )a Converts the given settings back to a dictionary that can be passed to ConfigFormatParser.serialize(..). Args: source_to_settings: the dictionary described in parse_known_args() parsed_namespace: namespace object created within parse_known_args() Returns: OrderedDict: where keys are strings and values are either strings or lists rJ Nr )r r7 r/ r+ r0 r- r4 r, r3 r\ r r r rf r r8 rR r> rC ) r1 source_to_settingsr` config_file_itemssourcesettingsr existing_command_line_argsr rG rG rE s r r] z/ArgumentParser.get_items_for_config_file_output s (M 2 8 8 : FH1108 -- "mmF'+'D'DV'L$'0H0H/0J060E0E040A0AC !((8&++t L , )% 6(+E (8(8(:EJ -.>q.A B , ..,4NN,<(C &%'+'D'DV'L$' '(8&++t L ,EJ -.>q.A B -= ""#:;,4NN,<(C &%-2%c* -=//,4NN,<(C &%'+'D'DV'L$' '(8&++t L ,EJ -.>q.A B -=5 !;@ ! r c g }|| j | }nt | s|j d }|It |t r8t |t sJ d |j dv r>t | s|j |S |j |j d |S |j dv r.t | s |S |j |j d |S t |t j r]|D ]7 }t |j D cg c] }|j | c} s6d}9 ||j d gt | z z }|S | j d|d |d |S t |t ra|duxr |j duxrs t |t j xs t |t j" xr; |j d v xs+ t |j t xr |j dkD }|t |t j" rm|D ]f } |rCt | t r3|j | D ] } |j t | H|j d t | h |S |r4|j |D ] } |j t | |S | j |d |d |S t |t r|j d | |S t% dj' t) | | c c}w )a Converts a config file or env var key + value to a list of commandline args to append to the commandline. Args: action: The argparse Action object for this setting, or None if this config file setting doesn't correspond to any defined configargparse arg. key: string (config file key or env var name) value: parsed value of type string or list Returns: list[str]: args NrN zCconfig parser should convert anything that is not a list to string.)rK yeson1r )falsenooff0rM zUnexpected value for z: 'zB'. Expecting 'true', 'false', 'yes', 'no', 'on', 'off', '1' or '0')+*ro z can't be set to a list 'zS' unless its action type is changed to 'append' or nargs is set to '*', '+', or > 1z&Unexpected value type {} for value: {})r= is_boolean_optional_actionr, r rB rf r r r _CountActionr9 rR intr rc r5 _StoreActionr6 r r[ r ) r1 r rE rG r rg rE r accepts_list_and_has_nargs list_elemsub_elems r r7 z/ArgumentParser.convert_item_to_command_line_argK s/ >II#N .f5#)#8#8#< *V5X"Y eS) p+p p){{} ::1&9KK!13^ Y KK 5 5a 89X W "==1&9P K KK 5 5a 89J I FH$9$9: Cv7L7LM7L!CNN1 -7LMN ! ..q12SZ??@ = NQSX Z [< 9 t $)/t); * TX@X * fh&;&;<j 6S[SiSi@j* *bz&,,/L/aQWQ]Q]`aQa ' ~FH4J4J!K!&I1jD6Q $45(1H KKH 6 )2 0@#i.%QS "'( , -/!&IKKY 1 "' RUW\ ^ _ s # KK$4e< > E L LU U $ % %? Ns L; c g }t |dd r|S |j D ]+ t fd| j D s"|dd gz }- |S )a This method decides which actions can be set in a config file and what their keys will be. It returns a list of 0 or more config keys that can be used to set the given action's value in a config file. Returns: list[str]: keys r Nc 3 F K | ] }j d |z yw)re N)rR )r crE s r r z:ArgumentParser.get_possible_config_keys.<locals>.<genexpr> s! B0A13>>!A#&0As !re )r\ r, r9 r3 )r1 r keysrE s @r r0 z'ArgumentParser.get_possible_config_keys s] 694 @K((CB0A0ABBQR#& ) r c g }t t j t t j j | j D ]) }|D ]" }|j | j | $ + | j D cg c] }t |dd s| }}|s|S |D ] }t j | j d }|j | d } t j | | |_ |j# | } | sh| \ } } t | |j$ d } | st j j | } | j | }|gz } |S c c}w # t& $ r{}t) |j* dk( r|j* \ }}n t- | }|D ]" } |j/ # t& $ r Y w xY w | j! d| d | Y d}~d}~ww xY w) a Tries to parse config file path(s) from within command_line_args. Returns a list of opened config files, including files specified on the commandline as well as any default_config_files specified in the constructor that are present on disk. Args: command_line_args: List of all args Returns: list[IO]: open config files r F)r3 add_helpc y r r )r1 messages r error_methodz7ArgumentParser._open_config_files.<locals>.error_method s r )r Nre z Unable to open config file: z . Error: )re globospath expanduserr r r r+ r\ r r r3 _add_actiontypes MethodTyper r r rY r" r rf r' )r1 command_line_args config_filesfilesfr user_config_file_arg_actionsr arg_parserr parsed_argr r user_config_filer4 r_ errnor@ r s r r: z!ArgumentParser._open_config_files s C(:(:D<V<V$WXE ##D$?$?$BC Y }}(Q$!3G(OA} % (Q , 2F "00 ! . . J " "6 * $ / / j IJ $44:K4LJ %LIq &y&++t D # "ww 1 12B C 445EF VH $L[ 3^ k(QH qvv;!#!"JE3 a&C#/K #))+$ $0 $c sH E$E$ E)) G-28G(+F<;G(< G G(G G((G-c V t dt dt dt di}t }| j j D ] \ }}|j d }||d t |dd z }|j | |j D ] \ }\ }}|r%|j d j |d z | 0t |t r|j d |z Ut |t sf|j d d j | z |j S ) zReturns a string with all args and settings and where they came from (eg. commandline, config file, environment variable or default) Returns: str: source to settings string zCommand Line Args: zEnvironment Variables: zConfig File (%s): z Defaults: r( r rM Nz {:<19}{} rp z %s rI )r/ r8 r> rC r r. r7 rZ r rg r[ r rf rc rd rh )r1 source_key_to_display_value_mapri rk rl rE r rG s r format_valuesz ArgumentParser.format_values s %&; !; #%: - + ' J $ 8 8 > > @ FH\\#&F4VAY?%qr BSSF GGFO(0(8$_feGGN 1 1#c'5 AB!%-5 01#E40388E? :; )9 !A zz|r c B |j | j y)zBPrints the format_values() string (to sys.stdout or another file).N)rg r )r1 r s r print_valueszArgumentParser.print_values s 4%%'(r c D d}d}d}| j r;| j }d| j d z }| j D cg c]O }|j D ]> }| j | r+|j dk( s |j s|j s||f@ Q }}}| j D cg c] }t |dd r| } }|r|s| rd| _ d}|d|z z }d j d | D } | rd | z } |s| r7|d d j t | t t d | g z z z }|d | j j z z }| j r| j D cg c] }t |dd r|j |f } }| D ]^ \ } }|j" t$ k( rd| z } |j" sd|_ | |j" vsA|xj" | z c_ d}d| _ ` |s|r*dg}|rdg|z }|rdg|z }|ddj | z z }t' | j) j* d }t- j. || }t0 j2 j5 | |dk7 rdj7 | z S dz S c c}}w c c}w c c}w )NrJ Fre r r r Tz:Args that start with '%s' can also be set in a config filez or c 3 R K | ] }|j r|j d ! yw)r N)r, r& s r r z-ArgumentParser.format_help.<locals>.<genexpr>. s, 0F 0A4D4D 120@0@0C 0s %'zspecified via z (%s).rI r1 z [env var: %s]r zconfig file valueszenvironment variablesz- In general, command-line values override %s.z which override z {} ) r r r3 r+ r, r0 r r r r\ rd r filterr r2 r r1 r rA max_get_formatter_widthtextwrapfillr r format_helpr[ )r1 r@ added_config_file_helpadded_env_var_helpr ccr rE config_settable_argsconfig_path_actionsconfig_arg_stringenv_var_actionsr1 env_var_help_string value_sources text_widths r r zArgumentParser.format_help s !& " % %#'#=#= 4$$Q''B6:mm $2m IL$($A$A!$D6!Q%9%9// &)!H %-m $2 #J *+!(,@%!H $% #J $)=)<-2*)-& (+-. .$*KK 0F 00F %F!$(8;L(L%'+<8fkk%8L2M27tFWEX8Y2Z3[ '\ \ \CsT 5 5 L L NNN ! !7;}} ?}!")!Y"= !" 1~}O ? - 66X% &87&B#vv AF&aff4FF 11F)-&-2D* . !7 'LM%!5 6 F !!8 9M I B"'' 68 8C ,,.55r: mmC,''33D9), %< =8:< =c$2#J( ?s AJ&J)"J r )r' r( r) r* r r environr r rY rD r= r] r7 r0 r: r r* stdoutr r r r r r r s h3T !%$*.2::4 !%ZZ " s'j($ : -!^KZ(I V < #&** )9=r r c , |j dd }|j dd xs |j dd }|j dd } | j |i |}|j |_ ||_ ||_ ||_ |j r |r t d |j r%t |t j s t d |j r:d}t |t j st |d z |rt |d z |S ) aH This method supports the same args as ArgumentParser.add_argument(..) as well as the additional args below. Arguments: env_var: If set, the value of this environment variable will override any config file or default values for this arg (but can itself be overridden on the commandline). Also, if auto_env_var_prefix is set in the constructor, this env var name will be used instead of the automatic name. is_config_file_arg: If True, this arg is treated as a config file path This provides an alternative way to specify config files in place of the ArgumentParser(fromfile_prefix_chars=..) mechanism. Default: False is_write_out_config_file_arg: If True, this arg will be treated as a config file path, and, when it is specified, will cause configargparse to write all current commandline args to this file as config options and then exit. Default: False Returns: argparse.Action: the new argparse action r1 Nr is_config_filer z*env_var can't be set for a positional arg.z9arg with is_config_file_arg=True must have action='store'z+arg with is_write_out_config_file_arg=True zmust have action='store'z'can't also have is_config_file_arg=True) r original_add_argument_methodr, r- r1 r r r r r r{ )r1 r r r1 r r r error_prefixs r r r U s. 2 jjD)G d$ '-zz$( $*::&$. /T . . ? ?F#)#8#8 8F FN 2F *FF' GEFF FH<Q<Q)R * + + **D &("7"78 \,F FG G 1J "J K K Mr c g | D ]G }|r2|d |v r+d|v r'|j dd \ }}j | 7j | I t fd|D S )zUtility method for checking if any of the potential_command_line_args is already present in existing_args. Returns: bool: already on command line? r ro rM c 3 & K | ] }|v y wr r )r potential_arg arg_namess r r z*already_on_command_line.<locals>.<genexpr> s 8S} "8Ss )rZ r r9 )existing_args_listpotential_command_line_argsr3 arg_string option_string explicit_argr s @r r4 r4 sx I( *Q-<7C:<M*4*:*:3*B 'M< ] + Z ( ) 8S r r )T)\r* r r| r functoolsrW r r rS r* r collectionsr r version_infor r _StoreTrueAction_StoreFalseActionry _StoreConstAction_AppendConstActionrB r r rx r r r r# r RawTextHelpFormatterRawDescriptionHelpFormatterr% objectr, rY r; r= rk r compiler DOTALLr lru_cacher r r r r r r r/ r8 r> rC r r r4 _ActionsContainerr Action ArgumentErrorArgumentTypeErrorFileType HelpFormatterMetavarTypeHelpFormatter Namespace ONE_OR_MOREr? PARSER REMAINDERrA r@ initArgumentParsergetArgumentParser getArgParser getParserget_arg_parser get_parser ArgParserParseradd_argaddr r5 r parse_known RawFormatterDefaultsFormatterDefaultsRawFormatterr r r <module>r s # v ! (0'@'@ 5 5 ; ;'= # v '..x/M/MN!b !5 &+,O&P # .& ** !! (( %Cv %CP2 2O . O dF #3 F R>V+ >VB2 BJJ ; < &2:: '{ CE CL CL M S-@ .@&&"F\' F\Pm& m^# , #L * - ' ! q =X,, q =h6r, ;C:T:T:a:a 7*6 ' ( F F && .. && #<< & B B 44 "" $$ * ' " % %-%?%?%L%L "!)!;!;!H!H %00 + < < * 1 7 r