a lc{@sdZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z m Z m Z mZmZmZddlmZmZGdddeZGdd d eZGd d d eZGd d d eZGdddZeZGdddejZddZGdddeZddZGdddeZ GdddZ!Gddde"e!Z#Gddde$e!Z%Gd d!d!Z&Gd"d#d#e&Z'Gd$d%d%e'Z(Gd&d'd'e'Z)Gd(d)d)e&Z*e+d*Z,d+Z-d,Z.Gd-d.d.ej/Z0Gd/d0d0eZ1Gd1d2d2ejZ2Gd3d4d4e*Z3Gd5d6d6ej/Z4Gd7d8d8e3Z5Gd9d:d:e5Z6d;d<Z7dS)=zA simple configuration system.N)Any ContainerDict HasTraitsList Undefined) cast_unicodefilefindc@s eZdZdS) ConfigErrorN__name__ __module__ __qualname__rrS/var/www/html/django/DPS/env/lib/python3.9/site-packages/traitlets/config/loader.pyr sr c@s eZdZdS)ConfigLoaderErrorNr rrrrrsrc@s eZdZdS)ConfigFileNotFoundNr rrrrr src@s eZdZdS) ArgumentErrorNr rrrrr$src@seZdZddZddZdS) _SentinelcCsdS)Nzrselfrrr__repr__4sz_Sentinel.__repr__cCsdS)Nz rrrrr__str__7sz_Sentinel.__str__N)r rrrrrrrrr3srcs.eZdZdZdfdd Zejjje_ZS)ArgumentParserz?Simple argparse subclass that prints help to stdout by default.Ncs|durtj}t|SN)sysstdoutsuper print_help)rfile __class__rrrAszArgumentParser.print_help)N)r rr__doc__rargparser __classcell__rrr!rr>srcCsFt|d(}tt||d||Wdn1s80YdS)Nrbexec)openr'compileread)fnameglobfrrrexecfileNs r.c@s|eZdZdZdZeZeZeZddZ ddZ ddZ d d Z d d Z eZd dZddZddZddZddZdS)LazyConfigValueaProxy object for exposing methods on configurable containers These methods allow appending/extending/updating to add to non-empty defaults instead of clobbering them. Exposes: - append, extend, insert on lists - update on dicts - update, add on sets NcCs|j|dS)zAppend an item to a ListN)_extendappendrobjrrrr1gszLazyConfigValue.appendcCs|j|dS)z Extend a listN)r0extendrotherrrrr4kszLazyConfigValue.extendcCs||jdd<dS)z#like list.extend, but for the frontNr)_prependr5rrrprependoszLazyConfigValue.prependcCspt|trb|j|j|j|_|j|j|j|j|j|_|jr^||j|j|_|S||SdS)a Merge with another earlier LazyConfigValue or an earlier container. This is useful when having global system-wide configuration files. Self is expected to have higher precedence. Parameters ---------- other : LazyConfigValue or container Returns ------- LazyConfigValue if ``other`` is also lazy, a reified container otherwise. N) isinstancer/r0r4r7_inserts_updateupdate get_valuer5rrr merge_intoss  zLazyConfigValue.merge_intocCs&t|tstd|j||fdS)NzAn integer is required)r9int TypeErrorr:r1)rindexr6rrrinserts zLazyConfigValue.insertcCs4|jdur$t|tri|_nt|_|j|dS)zUpdate either a set or dictN)r;r9dictsetr<r5rrrr<s   zLazyConfigValue.updatecCs||hdS)zAdd an item to a setN)r<r2rrraddszLazyConfigValue.addcCs|jdur|jSt|}t|tr\|jD]\}}|||q*|j|dd<||j n:t|t rz|j r| |j nt|t r|j r| |j ||_|S)znconstruct the value from the initial one after applying any insert / extend / update changes Nr)_valuecopydeepcopyr9listr:rBr7r4r0rCr;r<rD)rinitialvalueidxr3rrrr=s       zLazyConfigValue.get_valuecCsJi}|jr|j|d<|jr$|j|d<|jr6|j|d<n|jrF|j|d<|S)zreturn JSONable dict form of my data Currently update as dict or set, extend, prepend as lists, and inserts as list of tuples. r<r4r8inserts)r;r0r7r:)rdrrrto_dicts    zLazyConfigValue.to_dictcCs@|jdur"d|jjd|jdSd|jjd|dSdS)N )rFr"r rOrrrrrs zLazyConfigValue.__repr__)r rrr#rFrr0r7r:r1r4r8r>rBrr;r<rEr=rOrrrrrr/Ss  ! r/cCs.|r&|d|dkr&|ds&dSdSdS)z>Is a Config key a section name (does it start with a capital)?r_TFN)upper startswith)keyrrr_is_section_keys"rWcseZdZdZddZddZddZdd Zdej e ej fd d d Z fd dZ e ZddZddZddZddZddZddZddZddZdd ZZS)!ConfigaAn attribute-based dict that can do smart merges. Accessing a field on a config object for the first time populates the key with either a nested Config object for keys starting with capitals or :class:`.LazyConfigValue` for lowercase keys, allowing quick assignments such as:: c = Config() c.Class.int_trait = 5 c.Class.list_trait.append("x") cOs$tj|g|Ri||dSr)rC__init___ensure_subconfig)rargskwdsrrrrYszConfig.__init__cCsB|D]8}||}t|rt|trt|tst||t|qdS)zensure that sub-dicts that should be Config objects are casts dicts that are under section keys to Config objects, which is necessary for constructing Config objects from dict literals. N)rWr9rCrXsetattr)rrVr3rrrrZszConfig._ensure_subconfigcCs||dS)z$deprecated alias, use Config.merge()N)merger5rrr_mergesz Config._mergecCsi}|D]h\}}||vr&|||<q t|trNt||trN|||q t|trl|||||<q |||<q ||dS)z)merge another config object into this oneN)itemsr9rXr^r/r>r<)rr6Z to_updatekvrrrr^s   z Config.merge)r6returncCsxi}|D]j}||vrq||}||}|D]F}||vr*||||kr*||i||d|||||<q*q|S)zCheck for collisions between two config objects. Returns a dict of the form {"Class": {"trait": "collision message"}}`, indicating which values have been ignored. An empty dict indicates no collisions. z ignored, using ) setdefault)rr6 collisionssectionZmineZtheirsrVrrrres "zConfig.collisionscs<d|vr0|dd\}}||vr$dS|||vSt|S)N.F)splitr __contains__)rrVfirst remainderr!rrrj(s  zConfig.__contains__cCst|o||vSr)rWrrVrrr _has_section5szConfig._has_sectioncCst|t|Sr)typerCrGrrrrrG8sz Config.copycCs|Sr)rGrrrr__copy__;szConfig.__copy__cCsbt|}|D]J\}}t|ttfr6t||}nt|ttt t hvrTt|}|||<q|Sr) ror`r9rXr/rGrHrCrIrDtuple)rmemoZ new_configrVrKrrr __deepcopy__>s   zConfig.__deepcopy__cCstzt||WStynt|r@t}t||||YS|dsft}t||||YStYn0dS)NrS)rC __getitem__KeyErrorrWrX __setitem__rUr/)rrVcrbrrrrtJs  zConfig.__getitem__cCs4t|r"t|ts"td||ft|||dS)NzOvalues whose keys begin with an uppercase char must be Config instances: %r, %r)rWr9rX ValueErrorrCrv)rrVrKrrrrvZs zConfig.__setitem__c CsT|drt||Sz ||WStyN}zt|WYd}~n d}~00dSN__)rUrC __getattr__rtruAttributeErrorrrVerrrr{cs    zConfig.__getattr__c CsZ|drt|||Sz|||Wn,tyT}zt|WYd}~n d}~00dSry)rUrC __setattr__rvrur|)rrVrKr~rrrrks  zConfig.__setattr__c CsX|drt||Szt||Wn,tyR}zt|WYd}~n d}~00dSry)rUrC __delattr__ __delitem__rur|r}rrrrss   zConfig.__delattr__)r rrr#rYrZr_r^trstrrrerjZhas_keyrnrGrprsrtrvr{rrr%rrr!rrXs"     rXcs(eZdZdZddZfddZZS)DeferredConfigz0Class for deferred-evaluation of config from CLIcCs tddS)NzImplement in subclassesNotImplementedError)rtraitrrrr=szDeferredConfig.get_valuecst|j|Sr)rr"rrr!rr _super_reprszDeferredConfig._super_repr)r rrr#r=rr%rrr!rr|src@s eZdZdZddZddZdS)DeferredConfigStringaConfig value for loading config from a string Interpretation is deferred until it is loaded into the trait. Subclass of str for backward compatibility. This class is only used for values that are not listed in the configurable classes. When config is loaded, `trait.from_string` will be used. If an error is raised in `.from_string`, the original string is returned. .. versionadded:: 5.0 cCs0t|}z ||WSty*|YS0dS)#Get the value stored in this stringN)r from_string Exception)rrsrrrr=s   zDeferredConfigString.get_valuecCs|jjd|dSN()r"r rrrrrrszDeferredConfigString.__repr__Nr rrr#r=rrrrrrs rc@s eZdZdZddZddZdS)DeferredConfigListaConfig value for loading config from a list of strings Interpretation is deferred until it is loaded into the trait. This class is only used for values that are not listed in the configurable classes. When config is loaded, `trait.from_string_list` will be used. If an error is raised in `.from_string_list`, the original string list is returned. .. versionadded:: 5.0 cCs|t|drt|}|j}n>> cl = ConfigLoader() >>> config = cl.load_config() >>> config {} NzUsing default logger)clearrlogdebug)rrrrrrYs  zConfigLoader.__init__cCs t|_dSr)rXconfigrrrrrszConfigLoader.clearcCs||jS)aLoad a config from somewhere, return a :class:`Config` instance. Usually, this will cause self.config to be set and then returned. However, in most cases, :meth:`ConfigLoader.clear` should be called to erase any previous state. )rrrrrr load_configszConfigLoader.load_config)N)r rrr#rrYrrrrrrrs  rcs*eZdZdZdfdd ZddZZS)FileConfigLoaderzA base class for file based configurations. As we add more file based config loaders, the common logic should go here. Nc s(tjfi|||_||_d|_dS)a.Build a config loader for a filename and path. Parameters ---------- filename : str The file name of the config file. path : str, list, tuple The path to search for the config file on, or a sequence of paths to try in order. N)rrYfilenamepath full_filename)rrrkwr!rrrYs zFileConfigLoader.__init__cCst|j|j|_dS)z,Try to find the file by searching the paths.N)r rrrrrrr _find_file'szFileConfigLoader._find_file)N)r rrr#rYrr%rrr!rrsrc@s8eZdZdZddZddZddZdd Zd d Zd S) JSONFileConfigLoaderaA JSON file loader for config Can also act as a context manager that rewrite the configuration file to disk on exit. Example:: with JSONFileConfigLoader('myapp.json','/home/jupyter/configurations/') as c: c.MyNewConfigurable.new_value = 'Updated' c Cs`|z |Wn0tyD}ztt|WYd}~n d}~00|}|||_|jSz=Load the config from a file and return it as a Config object.N)rrOSErrorrr_read_file_as_dict_convert_to_configr)rr~dctrrrr8s " z JSONFileConfigLoader.load_configcCs8t|j}t|WdS1s*0YdSr)r(rjsonload)rr-rrrrCs z'JSONFileConfigLoader._read_file_as_dictcCs:d|vr|d}nd}|dkr(t|Std|dS)Nversionrhz%Unknown version of JSON config file: )poprXrx)r dictionaryrrrrrGs  z'JSONFileConfigLoader._convert_to_configcCs||jSr)rrrrrr __enter__RszJSONFileConfigLoader.__enter__cCsRd|j_tj|jdd}t|jd}||Wdn1sD0YdS)z Exit the context manager but do not handle any errors. In case of any error, we do not want to write the potentially broken configuration to disk. rhr)indentwN)rrrdumpsr(rwrite)rexc_type exc_value tracebackZ json_configr-rrr__exit__VszJSONFileConfigLoader.__exit__N) r rrr#rrrrrrrrrr,s    rc@s*eZdZdZddZd ddZddZdS) PyFileConfigLoaderzA config loader for pure python files. This is responsible for locating a Python config file by filename and path, then executing it to construct a Config object. c CsT|z |Wn0tyD}ztt|WYd}~n d}~00||jSr)rrrrrrr)rr~rrrrjs "zPyFileConfigLoader.load_configNcCsJ|dur|j}|||}z |}Wnty8Yn0|j|dS)z5Injected into config file namespace as load_subconfigN)rr"rrrr^)rr+rloaderZ sub_configrrrload_subconfigts   z!PyFileConfigLoader.load_subconfigcsnfdd}tjj|jd}j}t|d(}tt||d||Wdn1s`0YdS)z>Load the config file into self.config, with recursive loading.csjS)zKUnnecessary now, but a deprecation warning is more trouble than it's worth.rrrrr get_configsz9PyFileConfigLoader._read_file_as_dict..get_config)rwrr__file__r&r'N)rCrrrr(r'r)r*)rr namespaceZ conf_filenamer-rrrrs  z%PyFileConfigLoader._read_file_as_dict)N)r rrr#rrrrrrrrcs rc@s"eZdZdZdddZddZdS)CommandLineConfigLoaderzA config loader for command line arguments. As we add more command line based loaders, the common logic should go here. Nc Cs|}t|trJ|r||}qbt|trbt|dkrbttj|d}n|rZ| |}nt|}| d^}}|j }|D] }||}q||||<dS)zexecute self.config. = * expands ~ with expanduser * interprets value with trait if available rhrrgN) r9rr=rrrosr expanduserrrir) rlhsrhsrrKrrVrfpartrrr_exec_config_strs    z(CommandLineConfigLoader._exec_config_strcCsBt|ttfr2|D]\}}|j||qn td|dS)z=update self.config from a flag, which can be a dict or ConfigzInvalid flag: %rN)r9rCrXr`rr<r@)rcfgsecrwrrr _load_flagsz"CommandLineConfigLoader._load_flag)N)r rrr#rrrrrrrs rz^\-?\-[A-Za-z][\w]*(\.[\w]+)*$Z__DOT__Z__DASH__c@seZdZdZdddZdS) _KVActionzDCustom argparse action for handling --Class.trait=x Always NcCs`t|tr|g}dd|D}t||jd}|durz&_KVAction.__call__..)r9rgetattrdestrr4r])rparserrvalues option_stringr`rrr__call__s  z_KVAction.__call__)N)r rrr#rrrrrrsrcs>eZdZdZddZfddZfddZd d d ZZS) _DefaultOptionDictz_Like the default options dict but acts as if all --Class.trait options are predefined cCs,t|g|ddt|dd||<dS)Nrrg)option_stringsrmetavar)rlstripreplace_DOT_REPLACEMENTrmrrr_add_kv_actions z!_DefaultOptionDict._add_kv_actioncsBd|vr dSt|rdS|dr>t|r>||dSdS)N=FTr)rrjrUclass_trait_opt_patternmatchrrmr!rrrjs  z_DefaultOptionDict.__contains__cs ||vrt|St|dSr)rrtrurmr!rrrts z_DefaultOptionDict.__getitem__NcCs&z ||WSty |YS0dSr)ru)rrVdefaultrrrgets  z_DefaultOptionDict.get)N) r rrr#rrjrtrr%rrr!rrs  rcs"eZdZdZdfdd ZZS) _KVArgParserzOsubclass of ArgumentParser where any --Class.trait option is implicitly definedNcs*||jfD]}t|j|_q t||Sr) _optionalsr_option_string_actionsrparse_known_args)rr[r containerr!rrr sz_KVArgParser.parse_known_args)NN)r rrr#rr%rrr!rrsrc seZdZdZeZejeej edffZ dej ej eej ej e efej ej e efejej ej ejejejejddfdd ZddedfddZd d Zd d Zd dZddZddZZS)ArgParseConfigLoaderzEA loader that uses the argparse module to load from the command line..N)argvaliasesflagsrclasses parser_args parser_kwrcc s|pg}tt|j|d||dur8tjdd}||_|pDi|_|pNi|_||_||_ | dd|_ t t jd}||||_dS)a>Create a config loader for use with argparse. Parameters ---------- classes : optional, list The classes to scan for *container* config-traits and decide for their "multiplicity" when adding them as *argparse* arguments. argv : optional, list If given, used to read command-line arguments from, otherwise sys.argv[1:] is used. *parser_args : tuple A tuple of positional arguments that will be passed to the constructor of :class:`argparse.ArgumentParser`. **parser_kw : dict A tuple of keyword arguments that will be passed to the constructor of :class:`argparse.ArgumentParser`. aliases : dict of str to str Dict of aliases to full traitlets names for CLI parsing flags : dict of str to str Dict of flags to full traitlets names for CLI parsing log Passed to `ConfigLoader` Returns ------- config : Config The resulting Config object. )rNrhr)argument_default)rrrYrrrrrrrrrrCr$SUPPRESSr<r) rrrrrrrrkwargsr!rrrYs&    zArgParseConfigLoader.__init__cCsv|tur$tjdt|dtdd||dur:|j}|durH||_|durV||_| | || |j S)aParse command line arguments and return as a Config object. Parameters ---------- argv : optional, list If given, a list with the structure of sys.argv[1:] to parse arguments from. If not given, the instance's self.argv attribute (given at construction time) is used. flags Deprecated in traitlets 5.0, instanciate the config loader with the flags. zjThe `flag` argument to load_config is deprecated since Traitlets 5.0 and will be ignored, pass flags the `z` constructor.r stacklevelN) _deprecatedwarningswarnroDeprecationWarningrrrr_create_parser _parse_argsrr)rrrrrrrrrNs& z ArgParseConfigLoader.load_configcCst|dr|jSgSdS)N extra_args)rrrrrrget_extra_argsps z#ArgParseConfigLoader.get_extra_argscCs.|j|ji|j|_||j|j|jdSr) parser_classrrr_add_argumentsrrrrrrrrvs z#ArgParseConfigLoader._create_parsercCs tddS)Nz(subclasses must implement _add_argumentsr)rrrrrrrr|sz#ArgParseConfigLoader._add_argumentsc sdd|D}i|jri|jD]Z\}}||jvr:q&t|tsJ|f}|D]0}t|dkrnd|d|<d|d|<qNq&fddd|vr|d}||dd}|d|}ng}|}fd d|D}|j||_ ||_ dS) zself.parser->self.parsed_datacSsg|] }t|qSr)r rarrrrrz4ArgParseConfigLoader._parse_args..rh--rcs`|dkr tSD]F\}}||kr,|S||dr|d|t|ddSq|S)Nrrrh)rr`rUr)argrarb)unpacked_aliasesrr_replaces"z2ArgParseConfigLoader._parse_args.._replaceNcsg|] }|qSrrr)rrrrr) rr`rr9rqrrAr parse_args parsed_datar) rr[ZuargsaliasZ alias_targetalrLrZto_parser)rrrrs.     z ArgParseConfigLoader._parse_argscCsPt|jD]<\}}|d^}}|j}|D] }||}q0t|||qdS)zself.parsed_data->self.configrgN)varsr r`rirr])rrarbrrVrfprrrrs  z'ArgParseConfigLoader._convert_to_config)NNNNN)r rrr#rrrUnionrTupleFlagsOptionalrrrTyperYrrrrrrrr%rrr!rrs06"'rcs*eZdZdZfddZdddZZS) _FlagActionz ArgParse action to handle a flagcsF|d|_|dd|_t|d<|js0d|d<tj|i|dS)Nflagr constrnargs)rrr rrrYrr[rr!rrrYs  z_FlagAction.__init__NcCsD|jdks|tur2t|ds"g|_|j|jnt||j|dS)Nr_flags)rrrrr1rr]r )rrrrrrrrrs  z_FlagAction.__call__)N)r rrr#rYrr%rrr!rrs rc@s$eZdZdZeZddZddZdS)KVArgParseConfigLoaderznA config loader that loads aliases and flags with argparse, as well as arbitrary --Class.trait value cCsi}|jj}|jjgd|dddi|_}|D]x}|jddD]b\}} |jd|} dti} t| t t fr| j d d } | d kr| | d <n| | d <| | f|| <qHq4|D]t\} \}}t| t s| f} | D]R}||vr||||<qt|d krd|d|fnd|f} || t|dqq|D]\} }t| t sN| f} | D]}t|dt|d} ||vr| ||d d | vr||vrtd||f||vr| d dt| d <||| d<|| d<t|d krd|d|fnd|f} || i| qRq4dS)N)rr*)rTrrgro multiplicityr1actionrrhrr)rr)rorrzRThe alias `%s` for the 'append' sequence config-trait `%s` cannot be also a flag!'?rr )r add_argument set_defaultsargparse_traitsZ class_traitsr`r rr9rrmetadatarrqrrrrr<rrd)rrrrZ alias_flagsZpaar!clsZ traitnamerargnameZ argparse_kwdsrkeysrKrSrVrrrrs^     (      (z%KVArgParseConfigLoader._add_argumentsc Cs0|j}t|jD]\}}|dkrself.config, parse unrecognized extra args via KVLoader.rcSsg|]}|tkrdn|qSrrrrrrrrz=KVArgParseConfigLoader._convert_to_config..rrgz1Unrecognized alias: '%s', it will have no effect.NrzError loading argument rz, )rr r r`rrrwarningr9rIrrrr!rrrrrrrr)rrrrrr~Zsubcrrrrs4      2 z)KVArgParseConfigLoader._convert_to_configN)r rrr#rrrrrrrrrsBrcs eZdZdZfddZZS)KeyValueConfigLoaderz@Deprecated in traitlets 5.0 Use KVArgParseConfigLoader cs&tjdtddtj|i|dS)Nz[KeyValueConfigLoader is deprecated since Traitlets 5.0. Use KVArgParseConfigLoader instead.rr)rrrrrYrr!rrrY=s zKeyValueConfigLoader.__init__)r rrr#rYr%rrr!rr'7sr'c Cs\t}|D]L}t||d}z |}Wn$ty8Yq tyJYq 0||q |S)aLoad multiple Python config files, merging each of them in turn. Parameters ---------- config_files : list of str List of config files names to load and merge into the config. path : unicode The full path to the location of the config files. )r)rXrrrrr^) config_filesrrcfrZ next_configrrrload_pyconfig_filesGs      r*)8r#r$rGrrrertypingrrZtraitlets.traitletsrrrrrrutilsr r rr rrrrrrr.r/rWrCrXrrrrIrrrrrrr)rrrActionrrrrrrr'r*rrrrsV  !/7723 & s