$TXg RdZddlmZddlZddlZddlmZmZddlm Z ddl m Z ddl m Z mZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZmZmZddlm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-m.Z.ddl/m0Z0m1Z1m2Z2ddl3m4Z4ddl5m6Z6m7Z7m8Z8ddl9m:Z:ddl;mm?Z?ddl@mAZA ddlBmCZCmBZBdd lBmDZEdd!lBmFZGe eEvr eGe d"[E[Ge"rdd%l mKZKmLZLmMZMdd&lmNZNdd'l!mOZOeePZQeBZRdld(ZSdld)ZTd*ZUGd+d,e-ZVGd-d.eVZWGd/d0eVZXGd1d2eXZYGd3d4eXZZGd5d6eXZ[Gd7d8e.eVZ\d9Z]Gd:d;e Z^Gd<d=e>Z_Gd?d@e_Z`GdAdBe_ZaGdCdDe_ZbGdEdFe_ZcGdGdHe>ZdGdIdJedZeGdKdLedZfGdMdNedZgGdOdPedZhGdQdRZiGdSdTe>ZjGdUdVejZkGdWdXejZlGdYdZejZmGd[d\ejZnGd]d^ZoGd_d`epZqdaZrdbZsedce jdde jdee jdfeezgZuif dmdhZvGdidjeq>ZwdndkZxy#eH$rdd#lImBZBdd$l/mJZCYwxYw)oz A generalized application configuration utility. Features include: - lazy eval - merges configuration files - parameter type validation, with custom validation - parameter aliases Easily extensible to other source formats, e.g. json and ini ) annotationsN)ABCMetaabstractmethod) defaultdict)Mapping)EnumEnumMetawraps)chain) getLogger)environ) expandvars)Path) IGNORECASEVERBOSEcompile)Template) TYPE_CHECKING) IndexedSet) CommentedMap CommentedSeq) ReaderError) ScannerError) CondaErrorCondaMultiError)AttrDictfirstlast)ThisShouldNeverHappenError)TypeCoercionErrortypifytypify_data_structure)unique) isiterableprimitive_types)NULL)yaml_round_trip_load) deepfreeze frozendict)getFreezeConversionMap)registerc|SNxs :lib/python3.12/site-packages/conda/common/configuration.pyr58s!)r,)make_immutable)HashableIterableSequence)Match)Anyct|s|g} djfd|DS#t$rt|gcYSwxYw)N c3,K|] }d| yw)z- Nr1).0itempaddings r4 zpretty_list..NsC($G9Btf-(s)r'join TypeError pretty_list)iterablerBs `r4rFrFJsJ h :0yyC(CCC 0H:w//0s+AAcTdjfd|jDS)Nr>c36K|]\}}|d|yw): Nr1)r@keyvaluerBs r4rCzpretty_map..Ts'UBTJCyRw/BTs)rDitems) dictionaryrBs `r4 pretty_maprOSs! 99U*BRBRBTU UUr6cHt|ttfr t|S|Sr0) isinstancestrbytesr) unexpandeds r4expand_environment_variablesrUWs!*sEl+*%%r6c eZdZy)ConfigurationErrorN)__name__ __module__ __qualname__r1r6r4rWrW^sr6rWc eZdZdfd ZxZS)ConfigurationLoadErrorc 4d}t|||zfd|i|y)Nz4Unable to load configuration file. path: %(path)s pathsuper__init__)selfr^message_additionkwargsmessage __class__s r4razConfigurationLoadError.__init__cs%J #33I$I&Ir6)rXrYrZra __classcell__rfs@r4r\r\bsJJr6r\c eZdZdfd ZxZS)ValidationErrorc P||_||_||_t||fi|yr0)parameter_nameparameter_valuesourcer`ra)rbrnrorpmsgrdrfs r4razValidationError.__init__is,,.  ''r6r0rhrjs@r4rlrlhs ((r6rlceZdZfdZxZS)MultipleKeysErrorcr||_||_d|dt|d|d}t||d||y)NzMultiple aliased keys in file z: z Must declare only one. Prefer ''rq)rpkeysrFr`ra)rbrprw preferred_keyrqrfs r4razMultipleKeysError.__init__qsS  ,VHC4 !"..;_A ? f#>r6rhrjs@r4rsrsps ??r6rsc"eZdZ dfd ZxZS)InvalidTypeErrorc ||_||_|d|d|d|d|dt| }t|||||y)N Parameter  = declared in z has type z. Valid types: rv) wrong_type valid_typesrFr`ra)rbrnrorprrrqrfs r4razInvalidTypeError.__init__}sk%& ;^,C/B-PVxWablamn!!,[!9 :<  &cJr6r0rhrjs@r4rzrz|sTX K Kr6rzceZdZfdZxZS)CustomValidationErrorc Dt||||d|d|d|d|y)Nr|r}r~z is invalid. rvr_)rbrnrorpcustom_messagerfs r4razCustomValidationError.__init__s@    ^,C/B-(.(8:  r6rhrjs@r4rrs    r6rceZdZfdZxZS)MultiValidationErrorc,t||g|i|yr0r_)rberrorsargsrdrfs r4razMultiValidationError.__init__s 1$1&1r6rhrjs@r4rrs 22r6rcD|syt|dk(r|dt|)NTr&r)lenr)rs r4 raise_errorsrs(  V Qi"6**r6cNeZdZdZdZdZdZedZedZ edZ y) ParameterFlagfinaltopbottomc|jSr0rLrbs r4__str__zParameterFlag.__str__s**r6c ||Sr0r1)clsnames r4 from_namezParameterFlag.from_names 4yr6c||Sr0r1)rrLs r4 from_valuezParameterFlag.from_values 5zr6cr |jd}|j|S#ttf$rYywxYw)Nz!#)stripr ValueErrorAttributeError)rstrings r4 from_stringzParameterFlag.from_strings; \\$'F>>&) )N+  s !$66N) rXrYrZrrrr classmethodrrrr1r6r4rrsR E C Fr6rcXeZdZdZdZedZedZedZe dZ y) RawParametercz||_||_ |jd|_y#t$r ||_YywxYw)Nzutf-8)rprKdecode _raw_valuer)rbrprK raw_values r4razRawParameter.__init__s=  ('..w7DO ('DO (s '::c*tt|Sr0)rRvarsrs r4__repr__zRawParameter.__repr__s4:r6ctr0NotImplementedErrorrb parameter_objs r4rLzRawParameter.value !##r6ctr0rrs r4keyflagzRawParameter.keyflagrr6ctr0rrs r4 valueflagszRawParameter.valueflagsrr6c T|r|Dcic]}||||||c}StScc}wr0) EMPTY_MAPrrpfrom_maprKs r4make_raw_parametersz RawParameter.make_raw_parameterss8 DLMHSCVS(3-88HM MNs%N) rXrYrZrarrrLrrrrr1r6r4rrs\($$$$$$r6r) metaclasscNeZdZdZdZdZdZedZe fdZ xZ S)EnvRawParameterenvvarsct|dr\tjtsJt |d}t fddjj |DDSjdjS)Nstring_delimiterc3lK|]+}|r'ttjj|-ywr0)rrprK)r@vrbs r4rCz(EnvRawParameter.value..s/WA  6 6!DWs14c3<K|]}|jywr0)r)r@vvs r4rCz(EnvRawParameter.value..sW/V"((*/Vr) hasattrrQrrRgetattrtuplesplit'_EnvRawParameter__important_split_valuerrbrrs` r4rLzEnvRawParameter.values} ="4 5doos3 33&}6HI Wt/D/DEU/VW  //288: :r6cVt|jdk\rtjSdSNr)rrrrrs r4rzEnvRawParameter.keyflags&&)$*F*F&G1&L}""VRVVr6ct|dr7t|d}td|jj |DS|j dj S)Nrc3 K|]}dyw)rgNr1)r@_s r4rCz-EnvRawParameter.valueflags..sM%L%L r)rrrrrrrrs r4rzEnvRawParameter.valueflagssV ="4 5&}6HI MT__%:%:;K%LMM M//288: :r6c8|jjdS)Nz !important)rrrs r4__important_split_valuez'EnvRawParameter.__important_split_values$$\22r6c  |jd}tjDcic]8\}}|j|r"|j |ddj |:}}}t |tj|Scc}}w)Nrrgr&) upperrrM startswithreplacelowerr`rrrp)rappnamekeystartkrraw_envrfs r4rz#EnvRawParameter.make_raw_parameterssmmo&a(  '1||H% IIhA & , , . 1'  w*?+A+A7KK  s=B ) rXrYrZrprLrrpropertyrrrrirjs@r4rrsB F ;W;33LLr6rc>eZdZdZdZdZdZefdZxZ S)ArgParseRawParametercmd_linec 0t|jrmg}tt|jD]?}|j t |j |j|j|At|St|jSr0) r'rrangerappendrrprKrr+)rbrchildren_valuesis r4rLzArgParseRawParameter.value su doo & O3t/0&&(dhhPQ@RS1) )doo. .r6cyr0r1rs r4rzArgParseRawParameter.keyflagr6c*t|trdSdSNr1)rQPrimitiveLoadedParameterrs r4rzArgParseRawParameter.valueflagss!-1IJtRPRRr6c@t|tj|Sr0)r`rrrp)rargs_from_argparserfs r4rz(ArgParseRawParameter.make_raw_parameters s!w* ' ');  r6) rXrYrZrprLrrrrrirjs@r4rr s, F /S  r6rceZdZfdZdZdZdZedZe dZ edZ edZ e d Z e d ZxZS) YamlRawParameterc R||_t | |||t|jt r|j |j}td|D|_g}tt|jD]C}|jt|j|j|j|||Et||_yt|jt r|j#|j}|j%D cic]\}} | |t&j)| c} }|_i}|jj%D]-\}} t|j|j| ||||</t+||_yt|jt,rd|_|j|_yt/t1|j|jt2j4t7cc} }w)Nc3FK|]}tj|ywr0)rr)r@ss r4rCz,YamlRawParameter.__init__..0s&6D ))!,n!)file) _key_commentr`rarQrr_get_yaml_list_commentsr _value_flagsrrrrrprK_valuer_get_yaml_map_commentsrMrrr,r(printtypesysstderrr!) rbrprKr key_commentvalue_commentsrrrrrfs r4razYamlRawParameter.__init__*s' i0 doo| 4!99$//JN %&6D&!D !O3t/0&&$ TXXtq/A>RSCT1  0DK  6!88IN+002!2DAq==,,Q//2!D  !O--/1%5KK1nQ.?&"0%_5DK  9 $D //DK $t'szz J,. .!!s%"H#c|jSr0rrs r4rLzYamlRawParameter.valueO {{r6c@tj|jSr0)rrrrs r4rzYamlRawParameter.keyflagRs(():):;;r6c|jSr0)rrs r4rzYamlRawParameter.valueflagsUs   r6c |jj|djjS#tt f$rYywxYwrcarMrLrrKeyError)commented_dictrKs r4_get_yaml_key_commentz&YamlRawParameter._get_yaml_key_commentXsI !$$**3/288>>@ @)  s36AAcg}tt|D]:} |j|j|jj |<t|S#t tttf$r|jdYtwxYwr0) rrr_get_yaml_list_comment_itemrrMr IndexErrorrrEr)rrL list_commentsrs r4rz(YamlRawParameter._get_yaml_list_comments_s}  s5z"A +$$S%D%DUXX^^TUEV%WX# ]###J)D +$$T* +s7A*B  B c|dr!|djjxsdS|ddjjxsdS)Nrr&)rLr)rAs r4r z,YamlRawParameter._get_yaml_list_comment_itemlsI 77==&&(0D 071:##))+3t 3r6ci}|D]>} |jj|djjxsd||<@|S#tt f$rd||<YYwxYwrr)rL map_commentsrKs r4rz'YamlRawParameter._get_yaml_map_commentsusn C )$)HHNN3$7$:$@$@$F$F$H$PD S! #H- )$( S! )s;AAAc v|r-|Dcic]!}|||||||j||#c}StScc}wr0)r rrs r4rz$YamlRawParameter.make_raw_parameterss_  $ $CSC#0I0I(TW0X$    s&6cXt|5} t|}|j||xstcdddS#t$r4}|j}t |d|j |j d}~wt$r}t |d|jd}~wwxYw#1swYyxYw)Nz: reason: invalid yaml at line %(line)s, column %(column)s)linecolumnz/ reason: invalid yaml at position %(position)s)position) openr*r problem_markr\rrrrrr)rfilepathfhyaml_objerrmarks r4make_raw_parameters_from_filez.YamlRawParameter.make_raw_parameters_from_files (^r /3**8X>K)#^  '',P;;   ,E \\ ^s7B  <B  B/A44 BBBB  B))rXrYrZrarLrr staticmethodr rrr rrrrirjs@r4rr's#/J<!  $ $44LLr6rc4eZdZdZfdZdZdZdZxZS)DefaultValueRawParameterzFWraps a default value as a RawParameter, for usage in ParameterLoader.c t ||||t|jtrYi}|jj D])\}}t |j|j|||<+t||_ yt|jrsg}tt|jD]?}|jt |j|j|j|At||_ yt|jt rx|j|_ t#|jj D]@\}} |jj%|t |j|j| Byt|jt&r|j|_ yt|jt(r|j|_ yt+r0)r`rarQrrrMr rprKr,rr'rrrrConfigurationObjectr __setattr__rr(r!) rbrprKrrrrr attr_name attr_valuerfs r4raz!DefaultValueRawParameter.__init__so i0 doow / O--/1%=dkk488UV%W"0$_5DK  ( O3t/0&&,T[[$((DOOTUDVW1 0DK )< =//DK)-doo)>)D)D)F% : '',T[[$((JO*G  .//DK  9//DK,. .r6c|jSr0rrs r4rLzDefaultValueRawParameter.valuerr6cyr0r1rs r4rz DefaultValueRawParameter.keyflagrr6c,t|jtr tSt |jryt|jt ryt|jt ryt|jtrytr) rQrrr,r'r"rr(r!rs r4rz#DefaultValueRawParameter.valueflagssd doow /<   ( )< =  .  9,. .r6) rXrYrZ__doc__rarLrrrirjs@r4r r sP/: /r6r c~eZdZdZdZd dZdZdZd dZdZ e dZ dZ e d d Ze d Ze d Zy)LoadedParameterNcJ||_||_||_||_||_y)aJ Represents a Parameter that has been loaded with configuration value. Args: name (str): name of the loaded parameter value (LoadedParameter or primitive): the value of the loaded parameter key_flag (ParameterFlag or None): priority flag for the parameter itself value_flags (Any or None): priority flags for the parameter values validation (callable): Given a parameter value as input, return a boolean indicating validity, or alternately return a string describing an invalid value. N)_namerLkey_flag value_flags _validation)rbrrLr.r/ validations r4razLoadedParameter.__init__s)    &%r6cbt|t|ur|j|jk(SyNFrrLrbothers r4__eq__zLoadedParameter.__eq__( ;$t* $::, ,r6c,t|jSr0hashrLrs r4__hash__zLoadedParameter.__hash__DJJr6c g}t||jsG|jt|j||t |j |j|S|jt|j|}|dur(|jt|j|||St|tr'|jt|j||||S)a. Validate a LoadedParameter typed value. Args: instance (Configuration): the instance object used to create the LoadedParameter. typed_value (Any): typed value to validate. source (str): string description for the source of the typed_value. F) rQ_typerrzr-rrLr0rlrRr)rbinstance typed_valuerprresults r4collect_errorszLoadedParameter.collect_errorss+tzz2 MM JJ VT$**5Etzz     )%%k2F odjj+vNO  FC( )$**k66R r6ct|jtr;t|jd|jj D}nt |jr-t|jd|jD}nt|jt rrt|jj D]@\}}t|ts|jj||jB|jSt|j}||_|S)zw Recursively expands any environment values in the Loaded Parameter. Returns: LoadedParameter c3FK|]\}}||jfywr0expand)r@rrs r4rCz)LoadedParameter.expand..s!(XEWTQ!QXXZEWrc3<K|]}|jywr0rF)r@rs r4rCz)LoadedParameter.expand..s(HZZr) rQrLrrrMr'r"rr+r#rGrU)rb new_valuer$r%s r4rGzLoadedParameter.expands djj' *(TZZ((XTZZEUEUEW(XXI  #(TZZ((HTZZ(HHI  $7 8)-djj)9)?)?)A% :j/:JJ**9j6G6G6IJ*B:: 4TZZ@I  r6ct)z Recursively merges matches into one LoadedParameter. Args: matches (List): list of matches of this parameter. Returns: LoadedParameter r)rbmatchess r4mergezLoadedParameter.merge&s "##r6c|j} tj|j||S#t$r}t |}t |trRdjtdj|jj}|d|jd|z }t|j|j||d}~wwxYw)z Recursively types a LoadedParameter. Args: source (str): string describing the source of the LoadedParameter. Returns: a primitive, sequence, or map representing the typed value. , '{}' Valid choices for rJN) _element_typer+_typify_data_structurerLr"rR issubclassrrDmapformat __members__valuesr-r)rbrp element_typeerqchoicess r4r#zLoadedParameter.typify2s))  J"99 FL ! Ja&C,-)) |'?'?'F'F'HI-djj\G9EE' AGGVSI I Js / C BCC ct|tr(t|fd|jDSt |rt|fd|DSt|t rUt |jD]7\}}t|ts|j||j9|St|tr(t|trt|tr||St||S)Nc3JK|]\}}||jfywr0r#)r@rrrps r4rCz9LoadedParameter._typify_data_structure..Ls$OA188F#34s #c3@K|]}|jywr0r])r@rrps r4rCz9LoadedParameter._typify_data_structure..Ns?Aqxx/s) rQrrrMr'r"rr+r#r#rRrS)rLrp type_hintr$r%s ` r4rRz&LoadedParameter._typify_data_structureIs eW %4;OOO O  4;??? ? 2 3)-e):):)<% :j/:%%i1B1B61JK*=L uc "9d+9c* U# #%+ +r6c:|jtjuSr0)r.rr)loaded_parameters r4_match_key_is_importantz'LoadedParameter._match_key_is_important`s((M,?,???r6cLtt|dd}||S|d|dzS)Nc2tj|dS)Nr&)r+rbr2s r4r5z:LoadedParameter._first_important_matches..hso==adCr6c |dS)Nrr1r2s r4r5z:LoadedParameter._first_important_matches..isAaDr6)applyr&)r enumerate)rKidxs r4_first_important_matchesz(LoadedParameter._first_important_matchesds6 g  C   +w=79S1W+==r6r0 <>)rXrYrZr?rQrar7r<rCrGrrLr#rrRrbrir1r6r4r+r+s EM&$  4, $ $J.,,,@@>>r6r+c8eZdZdZ dfd ZdZdZdZxZS)rz LoadedParameter type that holds a single python primitive value. The python primitive types are str, int, float, complex, bool, and NoneType. In addition, python 2 has long and unicode types. cH||_||_t| |||||y)z Args: element_type (type or tuple[type]): Type-validation of parameter's value. value (primitive value): primitive python value. N)r?rQr`ra)rbrrXrLr.r/r1rfs r4raz!PrimitiveLoadedParameter.__init__vs)" ) uh ZHr6cbt|t|ur|j|jk(Syr3r4r5s r4r7zPrimitiveLoadedParameter.__eq__r8r6c,t|jSr0r:rs r4r<z!PrimitiveLoadedParameter.__hash__r=r6c|t|tjd}||St|dd}||St )N)defaultc |duSr0r1r2s r4r5z0PrimitiveLoadedParameter.merge..sQd]r6)rr+rbr r!)rbrKimportant_match last_matchs r4rLzPrimitiveLoadedParameter.mergesK _<eZdZdZeZ dfd Zdfd ZddZxZ S)MapLoadedParameterzFLoadedParameter type that holds a map (i.e. dict) of LoadedParameters.c:||_t| |||||y)z Args: value (Mapping): Map of string keys to LoadedParameter values. element_type (Parameter): The Parameter type that is held in value. value_flags (Mapping): Map of priority value flags. NrQr`rarbrrLrXr.r/r1rfs r4razMapLoadedParameter.__init__"* uh ZHr6ct||||j}t|jtrG|jj D]*\}}|j |j||||,|Sr0)r`rCrLrQrrMextendrbr@rArprrKrLrfs r4rCz!MapLoadedParameter.collect_errorssj'+tzzJ djj' *"jj..0 U e228[=MvVW1 r6c tj|}|D]{}t|jtrt |j |j|j|jjj|jjt|Dcic]S}|jjD]4\}}|jj|tj k(r||6U}}}}i}|D]E}|jjD]&\}}|j#|gj%|(G|jDcic]\}}||dj'|}}}t)i||} t+|j,| |j.|j0|j|j2Scc}}}wcc}}wNrr1)r+rirQrLrrzrrprfrXr?reversedrMr/getrr setdefaultrrLr,rvr-rQr.r0 rb parameters parameterrKrL final_map grouped_maprW merged_map merged_values r4rLzMapLoadedParameter.merges%==jI $Iioow7&IIOO$$OO--66JJ'' $&j1 1 'oo335 U$$((-1D1DD J5 1   #I'oo335 U&&sB/66u=6$=H " JJ     MM   ''   +  s %AG Gr0rj)rzSequence[MapLoadedParameter]returnrv) rXrYrZr)r,r?rarCrLrirjs@r4rvrvs"P ELP I. r6rvc<eZdZdZeZ dfd Zdfd ZdZxZ S)SequenceLoadedParameterzKLoadedParameter type that holds a sequence (i.e. list) of LoadedParameters.c:||_t| |||||y)z Args: value (Sequence): Sequence of LoadedParameter values. element_type (Parameter): The Parameter type that is held in the sequence. value_flags (Sequence): Sequence of priority value_flags. Nrxrys r4raz SequenceLoadedParameter.__init__rzr6ct||||j}t|jD]*\}}|j |j||||,|Sr0)r`rCrLrgr|)rbr@rArprrhelementrfs r4rCz&SequenceLoadedParameter.collect_errorssV'+tzzJ%djj1LC MM'00;s;KVT U2 r6c: tdtj|D}|D]`\}}t|trt |j ||j |jj|jjd tj fd|D}ttj fdt|D}tjdt|D}ttg||}ttgt|t|} tt| } t|j| |j |j"|j$|j&S)Nc38K|]}||jfywr0r)r@matchs r4rCz0SequenceLoadedParameter.merge..s!, JEKK Jscp|r2tfdt|j|jDSdS)Nc30K|] \}}|ur|ywr0r1)r@rflagmarkers r4rCzJSequenceLoadedParameter.merge..get_marked_lines..s$&I dv~&Isr1)rziprLr/)rrs `r4get_marked_linesz7SequenceLoadedParameter.merge..get_marked_lines s? &)%++u7H7H&I  r6c3RK|]\}}|tj ywr0)rr)r@mrrs r4rCz0SequenceLoadedParameter.merge..s*( 31 Q 1 1 23$'c3RK|]\}}|tj ywr0)rr)r@rrrs r4rCz0SequenceLoadedParameter.merge.. s*  EHE1! (<(<= Erc3&K|] \}}| ywr0r1)r@rrs r4rCz0SequenceLoadedParameter.merge..(s( ?$!QA?sr)rr+rirQrzrrprfrXr?r from_iterablerr%rr-rQr.r/r0) rbrKrelevant_matches_and_valuesrrL top_lines bottom_lines all_lines top_dedupedbottom_deduped merged_valuesrs @r4rLzSequenceLoadedParameter.merges',, (AA'J, ' #8LE5eU+&IILLOO,,JJ'' 8 ''( 3(       ()D E   ''( "#>?(  F#;Y#;#;<=  DXl+Dh{.CD E h~67 & JJ     MM   ''   r6r0rj) rXrYrZr)rr?rarCrLrirjs@r4rrs#U ELP IF r6rcFeZdZdZeZ dfd Zdfd Z ddZxZ S)ObjectLoadedParameterzLLoadedParameter type that holds a mapping (i.e. object) of LoadedParameters.c:||_t| |||||y)z Args: value (Sequence): Object with LoadedParameter fields. element_type (object): The Parameter type that is held in the sequence. value_flags (Sequence): Sequence of priority value_flags. Nrxrys r4razObjectLoadedParameter.__init__Hrzr6c4t||||j}t|jtrat |jj D];\}}t|ts|j|j||||=|Sr0) r`rCrLrQr"rrMr+r|r}s r4rCz$ObjectLoadedParameter.collect_errorsTs'+tzzJ djj"5 6"4::.446 Ue_5MM,,X{37GP7  r6c tj|}t|Dcic]l}t|jj D]D\}}t |tr/|jj|tjk(r||Fn}}}}i}|D]N}t|jj D]&\}}|j|gj|(P|j Dcic]\}}||dj|}}}tj|j } i||j D]\}}| j#||t%|j&| |j |j(|j|j*Scc}}}wcc}}wr)r+rirrrLrMrQr/rrrrrrLcopydeepcopyrQr#rr-r.r0rs r4rLzObjectLoadedParameter.merge`s %==jI &j1 1 "9??399; U5/2))--c2m6I6II J; 1   #I"9??399; U&&sB/66u=<$=H% JJ     MM   ''   5  s A1F4F;r0rj)rzSequence[ObjectLoadedParameter]rr) rXrYrZr)objectr?rarCrLrirjs@r4rrCs2V ELP I * 9* * r6rceZdZdZdZy)r"zIDummy class to mark whether a Python object has config parameters within.cVi}t|jD] \}}|||< |S)zF Return a serializable object with defaults filled in )rrM)rb serializableattrrLs r4to_jsonzConfigurationObject.to_jsons6 :++-KD%!&L .r6N)rXrYrZr)rr1r6r4r"r"s S r6r"cHeZdZdZdZddZedZdZe dZ dZ y) ParameterNc ||_||_y)a The Parameter class represents an unloaded configuration parameter, holding type, default and validation information until the parameter is loaded with a configuration. Args: default (Any): the typed, python representation default value given if the Parameter is not found in a Configuration. validation (callable): Given a parameter value as input, return a boolean indicating validity, or alternately return a string describing an invalid value. N)_defaultr0)rbrqr1s r4razParameter.__init__s  %r6cTtdd|j}|jd|S)zGReturns a DefaultValueRawParameter that wraps the actual default value.rq)r rload)rbwrapped_defaults r4rqzParameter.defaults'39iWyyO44r6cg}g}|jjD]F\}}tj|||\}} ||j || s6|j | H||fS)a Finds all matches of a Parameter in a Configuration instance Args: name (str): canonical name of the parameter to search for names (tuple(str)): alternative aliases of the parameter instance (Configuration): instance of the configuration to search within Returns (List(RawParameter)): matches of the parameter found in the configuration. )raw_datarMParameterLoader!raw_parameters_from_single_sourcer) rbrnamesr@rKmultikey_exceptionsrraw_parametersrerrors r4get_all_matcheszParameter.get_all_matchess| (0(9(9(?(?(A $Hn*LLe^LE5 u%#**51)B+++r6ct)z Loads a Parameter with the value in a RawParameter. Args: name (str): name of the parameter to pass through match (RawParameter): the value of the RawParameter match Returns a LoadedParameter rrbrrs r4rzParameter.loads "##r6cL|j} t||S#t$r}t|}t |t rHdj tdj|jj}|d|d|z }t||j||d}~wwxYw)NrNrOrPrJ) rQr$r"rRrSrrDrTrUrVrWrrL)rbrrprLrXrYrqrZs r4r#zParameter.typifys))  D( = =  Da&C,-)) |'?'?'F'F'HI-dV2gY??'aggvsC C Ds  B#A;BB#r0) rXrYrZr?rQrarrqrrrr#r1r6r4rrsF EM &55 ,. $ $ Dr6rc*eZdZdZdfd ZdZxZS)PrimitiveParameterz Parameter type for a Configuration class that holds a single python primitive value. The python primitive types are str, int, float, complex, bool, and NoneType. In addition, python 2 has long and unicode types. cp| t|n||_|j|_t|||y)z Args: default (primitive value): default value if the Parameter is not found. element_type (type or tuple[type]): Type-validation of parameter's value. If None, type(default) is used. N)rr?rQr`ra)rbrqrXr1rfs r4razPrimitiveParameter.__init__s2'3&:T']  !ZZ *-r6c t||j|j|j|j |j |j|j SNr)rr?rLrQrrr0rs r4rzPrimitiveParameter.loadsQ'  JJ KK** + MMO   T// 0''   r6NN)rXrYrZr)rarrirjs@r4rrs . r6rcFeZdZdZeZedffd ZfdZdZxZ S) MapParameterzTParameter type for a Configuration class that holds a map (i.e. dict) of Parameters.Ncl||_|xr t|xs t}t| ||y)z Args: element_type (Parameter): The Parameter type held in the MapParameter. default (Mapping): The parameter's default value. If None, will be an empty dict. rN)rQr,r`rarbrXrqr1rfs r4razMapParameter.__init__ s5 *1j1AZ\ Z8r6cXt||||\}}td|D}||fS)Nc3:K|]}|j|ywr0rr@rs r4rCz/MapParameter.get_all_matches..G7aall.F7r`rrrbrrr@rK exceptionsrfs r4rzMapParameter.get_all_matches6#g5dE8LG7GG ""r6c |j|j}|Ct|t|j|j t|j St |tsAt|||j|jj|jji}|j|jjD]&\}}|jj||}|||<(t|t||j|j |j|j|j Sr)rLrQrvr,rr0rQrrzrprfrXr?rMrr)rbrrrL loaded_maprK child_valueloaded_child_values r4rzMapParameter.loads& D../ =% ""  ++  %)"eU\\5??+C+CTZZEXEX  % D,>,> ? E E G C!%!3!3!8!8{!K 0JsO!H"  z "    MMO   T// 0''   r6) rXrYrZr)r,r?rarrrirjs@r4rrs!^ E-7\d9#  r6rc8eZdZdZeZdfd ZfdZdZxZ S)SequenceParameterzYParameter type for a Configuration class that holds a sequence (i.e. list) of Parameters.cB||_||_t| ||y)a Args: element_type (Parameter): The Parameter type that is held in the sequence. default (Sequence): default value, empty tuple if not given. string_delimiter (str): separation string used to parse string into sequence. N)rQrr`ra)rbrXrqr1rrfs r4razSequenceParameter.__init__As$* 0 *-r6cXt||||\}}td|D}||fS)Nc3:K|]}|j|ywr0rrs r4rCz4SequenceParameter.get_all_matches..Qrrrrs r4rz!SequenceParameter.get_all_matchesLs8$g5dE8LG7GG ""r6c <|j|}|3t|d|j|jd|jSt |sAt |||j|jj|jjg}|D]/}|jj||}|j|1t|t||j|j|j|j|jS)Nr1r)rLrrQrr0r'rzrprfrXr?rrrr)rbrrrLloaded_sequencerrs r4rzSequenceParameter.loadTs D! =*"" ++  % "eU\\5??+C+CTZZEXEX  K!%!3!3!8!8{!K   " "#5 6!'  / "    MMO   T// 0''   r6)r1N,) rXrYrZr)rr?rarrrirjs@r4rr<sc E .# r6rcFeZdZdZeZedffd ZfdZdZ xZ S)ObjectParameterzTParameter type for a Configuration class that holds an object with Parameter fields.Nc4||_t| ||y)z Args: element_type (object): The object type with parameter fields held in ObjectParameter. default (Sequence): default value, empty tuple if not given. Nrxrs r4razObjectParameter.__init__ys * *-r6cXt||||\}}td|D}||fS)Nc3:K|]}|j|ywr0rrs r4rCz2ObjectParameter.get_all_matches..rrrrs r4rzObjectParameter.get_all_matchesrr6c |j|j}|3t|d|j|jd|jSt |t tfsAt|||j|jj|jjt |tr t|}t|jjDcic]\}}t |tr||}}}i}|jD]<\}}|j!|x}r|j#||} n |j$} | ||<>t'j(|j} |jD]\}} | j+|| t|| |j|j|j-|j|jScc}}wr)rLrQrrr0rQrr"rzrprfrXr?rrMrrrrqrrr#r) rbrrrLr$parameter_typeobject_parameter_attrs loaded_attrsraw_child_valuer object_copyloaded_child_parameters r4rzObjectParameter.loads D../ =("" ++  %'+>!?@"eU\\5??+C+CTZZEXEX  e0 1KE.2$2D2D-E-K-K-M" -M) >.)4 ~ %-M "  )?)E)E)G %I~"'))I"666%3%8%8%O"%3%;%;"&8L # *HmmD$6$67 1=1C1C1E -I-  # #I/E F2F%      MMO   T// 0''   )" s)G/) rXrYrZr)rr?r"rarrrirjs@r4rrts"^ E-@-Bt.# 0 r6rcZeZdZdZd dZdZedZedZdZ dZ e dZ y ) rzq ParameterLoader class contains the top level logic needed to load a parameter from start to finish. cJd|_d|_||_||_||_y)a Args: parameter_type (Parameter): the type of Parameter that is stored in the loader. aliases (tuple(str)): alternative aliases for the Parameter expandvars (bool): whether or not to recursively expand environmental variables. N)r-_namesraliases _expandvars)rbrrrs r4razParameterLoader.__init__s(  "  %r6cp||_tdt|j|fD}||_|S)Nc3 K|]}|ywr0r1)r@r3s r4rCz,ParameterLoader._set_name..sC&B1&Br)r- frozensetr rr)rbrrs r4 _set_namezParameterLoader._set_names4 CeDLL4'&BCC  r6cF|j t|jSr0)r-r!rs r4rzParameterLoader.names :: ,. .zzr6cF|j t|jSr0)rr!rs r4rzParameterLoader.namess ;; ,. .{{r6c|j|jvr|j|jS|jj|j|j|\}}|Dcgc](}|jj |j|*}}|r|dj |n|jj}|jr|jn|} |jd} |j|j|| dt| |j|j<| Scc}w#t$r} |j| Yd} ~ Jd} ~ wwxYw)Nrrk)r_cache_rrrrrLrqrrGr#r|rCrrr) rbr@ instance_type raw_matchesrrrKmergedexpandedrBrYs r4__get__zParameterLoader.__get__s1 99(( (##DII. .#ii77 4::xX VBMM499>>$))U3M/6!!'*499;L;L '+&6&66==?F S__\2F MM(11(FLQ RV&,# #N%  MM!   s*-D=$E E& E!!E&cXtj|j|j|Sr0)rrrr)rbrs r4"_raw_parameters_from_single_sourcez2ParameterLoader._raw_parameters_from_single_sources$@@ IItzz>  r6c |t|jz}|Dcic]}||| }}t|}|dk(ry|dk(r$tt |j dfS||vr1||t |tt |j||fSdt |tt |j||fScc}w)Nrrr&)rrwrnextiterrWrsrp)rrrrwrKrKnumkeyss r4rz1ParameterLoader.raw_parameters_from_single_sourcesy!4!4!6777;.#s/$ /a!_- KK /.0)r`rar__dict__rMparameter_names)rrbasesrrfs r4razConfigurationType.__init__s= ud+$$ <<--/$  r6)rXrYrZr)rarirjs@r4r r s%  r6r )z.condarccondarc)z.ymlz.yamlz9 # delimiter and a Python identifier \$(?Pz?) | # delimiter and a braced identifier \${(?Pz8)} | # delimiter padded identifier %(?Pz)% )flagsc Hi|dfd }tj||S)u9Expand variables in a string. Inspired by `string.Template` and modified to mirror `os.path.expandvars` functionality allowing custom variables without mutating `os.environ`. Expands POSIX and Windows CMD environment variables as follows: - $VARIABLE → value of VARIABLE - ${VARIABLE} → value of VARIABLE - %VARIABLE% → value of VARIABLE Invalid substitutions are left as-is: - $MISSING → $MISSING - ${MISSING} → ${MISSING} - %MISSING% → %MISSING% - $$ → $$ - %% → %% - $ → $ - % → % ctj|jdxs$|jdxs|jd|jS)Nnamedbracedpadded)rRrgroup)rmappings r4convertz"custom_expandvars..convertUsM KK G$V H(=VXAV    r6)rr;)_RE_CUSTOM_EXPANDVARSsub)templaterrdrs ` r4custom_expandvarsr!;s.0$#F#G  ! $ $Wh 77r6ceZdZddZe ddZe ddZddZddZ dZ ddZ d Z d Z d Zd Zed ZdZdZdZdZdZdZdZy) ConfigurationNc i|_i|_t|_t t |_|j|fi||j||j|yr0) rrr_reset_callbacksrlist_validation_errors_set_search_path _set_env_vars_set_argparse_args)rb search_pathapp_name argparse_argsrds r4razConfiguration.__init__asZ  * "-d"3k4V4 8$  .r6c+|K|D]}t|tr|}n*t|tfi|}t|j }|j r)|j tvs|jtvr|y|jsdt|jDEd{y7w)Nc3dK|](}|jr|jtvr|*ywr0)is_filesuffixYAML_EXTENSIONS)r@subpaths r4rCz4Configuration._expand_search_path..s-#9(W^^-N#9r) rQrr!r expanduserr0rCONDARC_FILENAMESr1r2is_dirsortediterdir)r+rdsearchr^r s r4_expand_search_pathz!Configuration._expand_search_pathms "F&$',VWGGH~002||~ ..$++2P #)$,,.#9"sB B<#B<2B:3B<c#K|D]} |tj|fy#t$r!}tj d||Yd}~Ed}~wwxYww)Nz1Ignoring configuration file (%s) due to error: %s)rrr\logwarning)rr+r^rs r4_load_search_pathzConfiguration._load_search_pathsY  D ,JJ4PPP *  H s*A%A AA A AAc t|j|fi||_|jt |j |j|j |Sr0)rr: _search_path _set_raw_datadictr> _reset_cache)rbr+rds r4r(zConfiguration._set_search_pathsW&'?t'?'? 'Vv'VW 4 6 6t7H7H IJK  r6c||_tj}||jvr |j|=|r"tj ||j|<|j |Sr0) _app_namerrprrrC)rbr,rps r4r)zConfiguration._set_env_varss[!!'' T]] " f% $3$G$G$QDMM& !  r6ct|drt|j}n|sd}n|j}t|Dcic]\}}|tus||c}}x|_}t j}||jvr |j|=t j||j|<|j|Scc}}w)Nrr1) rrrMrr)_argparse_argsrrprrrC)rbr-rMrrrps r4r*z Configuration._set_argparse_argss =* -'--/EE"'')E.6# 5edaq}QTe 5/  m &,, T]] " f% 4 H H W f   6s C C c\|jj||j|Sr0)rupdaterC)rbrs r4rAzConfiguration._set_raw_datas% X&  r6cDi|_|jD] }| |Sr0)rr%rbcallbacks r4rCzConfiguration._reset_caches# --H J. r6c:|jj|yr0)r%addrKs r4register_reset_callabackz&Configuration.register_reset_callabacks !!(+r6ci}g}|j|}|jD]}|jj|}|j |\}}|r|j ||y|j j||} | j|j} | j|| |j} | r|j| | ||j<||fS#t$r} |j | Yd} ~ d} ~ wwxYwr0)rrrfrrrrrr#rprCr|rKr) rbrp typed_valuesvalidation_errorsrrKrrmultikey_errorrarAcollected_errorsrYs r4 check_sourcezConfiguration.check_sources v.''C//4I$-$P$P% !E>!((8 #,>>#6#6sE#B  >"2"9"9%,,"GK(8'F'Fk5<<($()001AB2= UYY/?(@...-0%,,Q//0sC$$ D-DDcttjfdjD}t |j y)Nc3FK|]}j|dyw)r&N)rU)r@rprbs r4rCz-Configuration.validate_all..s% ;H!!&)!,=s!)r&r rrrvalidate_configuration)rbrRs` r4 validate_allzConfiguration.validate_allsD    ;?==    &' ##%r6cx ||i|y#t$r%}t|dr |jn|fcYd}~Sd}~wwxYw)Nrr1)rWrr)funcrrdrYs r4_collect_validation_errorz'Configuration._collect_validation_errorsC > $ !& !" > '8 4AHH!= = >s 9499ctjfdjD}j}t t tj||fy)Nc3TK|]}tjt|!ywr0)r#r\r)r@rrbs r4rCz7Configuration.validate_configuration..s(% ,  3 3GT4 H,s%()r rrpost_build_validationrr)rbr post_errorss` r4rXz$Configuration.validate_configurationsS$$% ,,%  002 U5.. /DEFGr6cyrr1rs r4r_z#Configuration.post_build_validationsr6c$i}i}|jD]}|j|\||<||<ttt j |j |jDcic] \}}|s || c}}Scc}}wr0)rrUrrr rrWrM)rbrQrRrprrs r4 collect_allzConfiguration.collect_alls mmF>B>O>OPV>W ;L "3F";$U5../@/G/G/IJKL!-!3!3!5;!5A1!5;;;s 8 B B c  ||jvrd|z}|jj|}|j}t |t sJ|j jd t fd|jD}|jj d}|j}t|tk(r|g}t|s|g}t |jt st |jtrtd|D}ntd|D}|jj j#j%dd |||j&j)d|j%dd j+d }t |t,r|j.|d <|S) Nrc3.K|] }|k7s |ywr0r1)r@aliasrs r4rCz3Configuration.describe_parameter..,sU+C%uPT}+Cs rgc3K|]8}|jjjjdd:yw)rrgN)rfrXrrr@_ets r4rCz3Configuration.describe_parameter..8s5"SUC &&,,.66{BGSUs>Ac34K|]}|jywr0)rXrhs r4rCz3Configuration.describe_parameter..<s!="3#,,"srz <>r> )rrr element_types default_value descriptionr)rrfrrrQrrlstriprrget_descriptionsrrQr r'r"rXrrrqr#rrr) rbrnparameter_loaderrrrnetrldetailsrs @r4describe_parameterz Configuration.describe_parameter"s !5!5 5 >1N>>22>B$)) )Y/// $$++C0U+;+C+CUU++-11$;  $ $ 8x B"~B i--y 9Z  # #%8> ""SU"M"!="!==M(11::@@BJJR*&..55nE&..tS9??A   i!2 3*3*D*DG& 'r6cLttd|jDS)Nc3>K|]}|jdyw)rN)ro)r@rs r4rCz0Configuration.list_parameters..MsN9MDKK,9Ms)rr7rrs r4list_parameterszConfiguration.list_parametersLsVN9M9MNNOOr6c||jvrd|z}|jj|}|j}t |t sJ|j |||S)Nr)rrfrrrQrr#)rbrnrLrprqrs r4typify_parameterzConfiguration.typify_parameterOs_ !5!5 5 >1N>>22>B$)) )Y///>>r6ctr0rrs r4rpzConfiguration.get_descriptionsYs !##r6)r1NN)r+Iterable[Path | str]rIterable[Path])r+r|rzIterable[tuple[Path, dict]])r+r{r0)rzMapping[Hashable, dict])rXrYrZrarr:rr>r(r)r*rArCrOrUrYr\rXr_rcrtrwryrpr1r6r4r#r#`s /) 0 #  %   :  ,&/P&H<(TP?$r6r#cfd}|S)a! Used to validate properties on :class:`Configuration` subclasses defined as a ``SequenceParameter(MapParameter())`` where the map contains a single key that should be regarded as unique. This decorator will handle removing duplicates and merging to a single sequence. c2tfd}|S)Nc 8|i|}i}|D]r}|j}|*tjd|djdd@||vr*tjd|djd|dn|||<tt |j S)NzConfiguration: skipping z for "z"; unique key "z" not present on mappingz "; value "z" already present)rr<rrXrrW)rrd sequence_mapnew_sequence_mappingrunique_key_valuer[ unique_keys r4wrapperz8unique_sequence_map..inner_wrap..wrapperfs00L#% '#*;;z#: #+II27)6$--Q&<'?A#';;II27)6$--Q,-->@9@$%56#(&-4467 7r6r )r[rrs` r4 inner_wrapz'unique_sequence_map..inner_wrapes t 8  82r6r1)rrs` r4unique_sequence_mapr]s: r6)z )r rRrzMapping[str, Any]rrR)rrR)yr) __future__rrrabcrr collectionsrcollections.abcrenumrr functoolsr itertoolsr loggingr osros.pathrpathlibrrerrrrrtypingrboltons.setutilsrruamel.yaml.commentsrrruamel.yaml.readerrruamel.yaml.scannerrrgrrauxlib.collectionrrr auxlib.exceptionsr!auxlib.type_coercionr"r#r$common.iteratorsr%compatr'r( constantsr) serializer*r,r+r-_getFreezeConversionMapr. _register ImportError_vendor.frozendictr7r8r9r:r;r<rXr<rrFrOrUrWr\rlrsrzrrrrrrrrr r+rrvrrr"rrrrrrrr r5r2 idpatternrr!r#rr1r6r4rs # '##++ ';*,*55:SS%/+A1L0 *,, $ $ << L 0V  J/J ((( ? ? K K  O  2?,>2 +D2W@)Ll)LX < :vL|vLr2/|2/jV>V>r&+&+RH H V^ o^ BG OG T  JD'JDZ  <2 92 j5 5 pD iD N^^B    ,# ##$%&&'(##$%  w   13"8"8-"8"8Jz$/z$z%C1A/@@As>)JJ&%J&