si7N*SrSSKJr SSKrSSKrSSKJr SSKJr SSK J r SSK J r SSK Jr S S KJr \(aSS KJr SS K Jr S S KJr \ "\5rSSjr\"5 "SS5r\"5r"SS5rSSjr"SS5rg)z Configuration file manipulation utilities for conda. This module provides classes and functions for working with conda configuration files (.condarc), including reading, writing, and validating configuration keys. ) annotationsN)Sequence)cached_property) getLogger)Path) TYPE_CHECKING)DEFAULT_CONDARC_FILENAME)Callable)Any) ConfigurationcvSSKJn SSKJnJnJnJnJnJn SnUUUUUU4HnURX5 M g)a6Register YAML representers for conda enum types. This function registers custom YAML representers for all conda enum types to ensure they are serialized as strings rather than complex objects. This is called once at module load time to ensure representers are available before any YAML serialization occurs. r)RoundTripRepresenterr )ChannelPriority DepsModifier PathConflict SafetyChecksSatSolverChoiceUpdateModifierc6UR[U55$N) represent_strstr)dumperdatas 1lib/python3.13/site-packages/conda/cli/condarc.pyenum_representer5_register_enum_representers..enum_representer3s##CI..N) ruamel.yaml.representerrbase.constantsrrrrrradd_representer) rrrrrrrr enum_classs r_register_enum_representersr$sF=/    ,,ZJrc0\rSrSrSrSrSrSrSrSr g) _MissingSentinelFzSentinel value to indicate a missing configuration key. This is used by ConfigurationFile.get_key() to distinguish between a key that doesn't exist and a key that exists but has a None value. cg)Nz selfs r__repr___MissingSentinel.__repr__Msrcg)NFr)r*s r__bool___MissingSentinel.__bool__Psrc"[U[5$r) isinstancer&)r+others r__eq___MissingSentinel.__eq__Ss%!122rc [[5$r)hashr&r*s r__hash___MissingSentinel.__hash__Vs$%%rr)N) __name__ __module__ __qualname____firstlineno____doc__r,r/r4r8__static_attributes__r)rrr&r&Fs 3&rr&cr\rSrSrSrS Sjr\S Sj5r\S Sj5r\S Sj5r \S Sj5r Sr g ) ParameterTypeGroups]aY Groups configuration parameters by their parameter type. Organizes configuration parameters from a Configuration instance into sequence and map parameters, handling both regular and plugin parameters separately. This is primarily used by ConfigurationFile to efficiently determine which operations are valid for different configuration keys. c^SSKJn U"U4SjTR55Ul[ TS5(a+U"U4SjTR R55Ulg0Ulg)z Initialize ParameterTypeGroups by grouping parameters by type. :param context: Configuration instance containing configuration parameters. r )groupby_to_dictc,>TRU5S$Nparameter_type)describe_parameterpcontexts r.ParameterTypeGroups.__init__..qsg0034DErpluginsc@>TRRU5S$rF)rNrHrIs rrLrMxs'//<rVrr\r`rdrgr?r)rrrArA]s^1,;;CC66>>rrAclSSKJn SSKJn UR SS9n[ US5(aUR R 5nO/n[U5[U5- n[U5[U5- nU(dU(a*UV s1sHn SU 3iM nn Xx-n U"SU"U 535eg s sn f) a Validate that provided parameters exist in the configuration context. Compares the provided parameters with the available parameters in the context and raises an error if any are invalid. :param parameters: Regular parameter names to validate. :param plugin_parameters: Plugin parameter names to validate. :param context: Configuration instance containing available parameters. :raises ArgumentError: If any provided parameters are not valid. r )dashlist) ArgumentErrorT)aliasesrNzplugins.z"Invalid configuration parameters: N) common.iorl exceptionsrmrQrSrNset) parametersplugin_parametersrKrlrm all_namesall_plugin_names not_paramsnot_plugin_paramsname error_paramss rvalidate_provided_parametersrzs %*'''5Iw """??::<Z3y>1J-.5E1FF&;LM;L4xv.;LM!5 0,1G0H I  'Ms B1c\rSrSrSrSSSjjr\SSSjj5r\SSSjj5r\SSSjj5r SSjr SS jr \ S S j5r \ RS!S j5r \ S"S j5r\ S#S j5r\ S$Sj5rSS%SjjrSS&SjjrS'SjrS(S)SjjrS*SjrS+SjrS+SjrS,SjrSrg)-ConfigurationFilea Represents and manipulates a conda configuration (.condarc) file. Provides methods to read, write, and modify configuration files while validating keys and maintaining proper structure. Can be used as a context manager for atomic edits: with ConfigurationFile.from_user_condarc() as config: config.set_key("channels", ["conda-forge"]) config.add("channels", "defaults") # File is automatically written when exiting the context NcXXlX0lX lSUlU=(d SUlg)Ncgrr)msgs rrL,ConfigurationFile.__init__..str)_path_content_context_context_paramswarning_handler)r+pathrKcontentrs rrVConfigurationFile.__init__s)   ;?.D3CrcSSKJn U"X!S9$)z Create a ConfigurationFile instance for the default user .condarc file. :param context: Optional Configuration instance. If None, uses the global context. :returns: ConfigurationFile instance configured for the user's .condarc file. r ) user_rc_pathrrK) base.contextr)clsrKrs rfrom_user_condarc#ConfigurationFile.from_user_condarcs 0 66rcSSKJn U"X!S9$)z Create a ConfigurationFile instance for the system .condarc file. :param context: Optional Configuration instance. If None, uses the global context. :returns: ConfigurationFile instance configured for the system .condarc file. r ) sys_rc_pathr)rr)rrKrs rfrom_system_condarc%ConfigurationFile.from_system_condarcs / 55rcUc.[RRS[R5nU"[ U5[ - US9$)a Create a ConfigurationFile instance for an environment-specific .condarc file. Environment-specific .condarc files are located at `{prefix}/.condarc` and allow per-environment configuration overrides. :param prefix: Path to the conda environment. If None, uses $CONDA_PREFIX or sys.prefix. :param context: Optional Configuration instance. If None, uses the global context. :returns: ConfigurationFile instance configured for the environment's .condarc file. CONDA_PREFIXr)osenvironr[sysprefixrr )rrrKs rfrom_env_condarc"ConfigurationFile.from_env_condarcs8 >ZZ^^NCJJ?FV '??QQrcU$)zEnter the context manager.r)r*s r __enter__ConfigurationFile.__enter__s rc,UcUR5 gg)zDExit the context manager and write changes if no exception occurred.N)write)r+exc_typeexc_valexc_tbs r__exit__ConfigurationFile.__exit__ s   JJL rcJURc [S5eUR$)z Get the path to the configuration file. :returns: Path to the configuration file. :raises AttributeError: If path has not been set. z(Configuration file path has not been set)rAttributeErrorr*s rrConfigurationFile.paths$ ::  !KL LzzrcXlg)zW Set the path to the configuration file. :param path: Path to the configuration file. N)r)r+rs rrrs  rcLURc SSKJn XlUR$)z Get the context instance. If no context was provided during initialization, falls back to the global conda context singleton. This lazy import is necessary to avoid circular dependencies at module load time. :returns: Configuration instance. r )rK)rrrK)r+rKs rrKConfigurationFile.context's" ==  /#M}}rchURc[UR5UlUR$r)rrArKr*s rcontext_params ConfigurationFile.context_params;s+    '#6t||#DD ###rcTURcUR5 UR$)zu Get the configuration content, reading from file if needed. :returns: Dictionary containing configuration content. )rreadr*s rrConfigurationFile.contentAs! == IIK}}rcSSKJn [U=(d UR5nUR US9=(d 0UlUR $![ a 0UlUR $f=f)z Read configuration content from file. :param path: Optional path to read from. If None, uses the instance path. :returns: Dictionary containing configuration content. r yamlr)common.serializerrrrrFileNotFoundError)r+rrs rrConfigurationFile.readMsd ,D&DJJ'  II4I06BDM}}! DM}} sAA.-A.cSSKJn SSKJn [ U=(d UR 5nUR URUS9 g![anU"SUSU<35eSnAff=f)z Write configuration content to file. :param path: Optional path to write to. If None, uses the instance path. :raises CondaError: If the file cannot be written. r ) CondaErrorrrz Cannot write to condarc file at z Caused by N) rrrrrrrOSError)r+rrres rrConfigurationFile.write_sd "+$,$**- Y JJt||$J / Y?v\RSQVWX X YsA A%A  A%cURS5tp#US:XaV[U5S:aG[URS5(a,USURRR 5;agX RR 5;aB[ URRU55nU(dURSU<35 U$g)z Check if a configuration key is valid. :param key: Configuration key to check. :returns: True if the key is valid, False otherwise. .rNrTz Unknown key: ) splitlenrSrKrNrQboolname_for_aliasr)r+keyfirstrestexistss r key_existsConfigurationFile.key_existsosyy~  Y D A  i00Q4<<//??AA  446 6$,,55e<=F$$}SG%<=MrcSSKJnJn SU;aURSS5OUS4upXRR ;aUR RU/5nOUS:XaFX`RR;a-UR RS05RU/5nOXRR;a-UR RU05RU/5nORXRR;a-UR RS05RU05nO U"SUS35e[U[5(a[U[5(a3UR URRnU"S U<S US35eX';aU(aS OS n UbUS-U-OUn S USU SU 3n Uc)UV s/sH oU:wdM U PM sn =opR U'O+UV s/sH oU:wdM U PM sn =opR UU'UR!U S9 UR#U(aSO [%U5U5 gs sn fs sn f)ax Add an item to a sequence configuration parameter. :param key: Configuration key name (may contain dots for nested keys). :param item: Item to add to the sequence. :param prepend: If True, add to the beginning; if False, add to the end. :raises CondaValueError: If the key is not a known sequence parameter. :raises CouldntParseError: If the key should be a list but isn't. r )CondaValueErrorCouldntParseErrorrNrNzKey 'z$' is not a known sequence parameter.zkey z should be a list, not topbottomz Warning: 'z' already in 'z' list, moving to the rr)rprrrrr\r setdefaultr`rdrgr2rr __class__r:rinsertr) r+ritemprependrrsubkeyarglistbadlocation message_keymessagerJs raddConfigurationFile.adds D+.#:ciiQ'C;  %%99 9ll--c26G 9 --HHHll--i<GGPRSG ''66 6ll--c26AA&"MG ''== =ll--i<GGPRSG!E#.R"ST T7H--j#6N6N,,s#--66C#d3'1HQ$OP P ? 'uXH060B#)f,K"4&{mCYZbYcdG~:A.O'Q$Yq'.OO,,s+BI6W'QRVYq'6WW,,s+F3  W -GqWt< /P6Ws II6 IIc2URS5nURU5(dU[4$URR U5=n(aUnURS5nUR nUHnXEnM X4$![ a U[4$f=f)z Get a configuration value by key. :param key: Configuration key name (may contain dots for nested keys). :returns: Tuple of (key, value) or (key, MISSING) if key doesn't exist. r)rrMISSINGrKrrKeyError)r+r key_partsalias sub_configparts rget_keyConfigurationFile.get_keysIIcN s##< LL//4 45 4C C(I\\  #!'- " ? "  G|  s2 B BBcSSKJn URU5(d U"US5eURR U5=n(a[ R SX5 UnURS5tpVUS:XaQ[URS5(a6URRnURRS05nUtpOURnURnUn URU 5Sn U S:Xa$[U5S :XaURXS 5X'gU S :Xa'[U5S :XaX(RU 05US 'gU"US 5e)z Set a configuration value for a primitive or map parameter. :param key: Configuration key name (may contain dots for nested keys). :param item: Value to set. :raises CondaKeyError: If the key is unknown or invalid. r  CondaKeyErrorunknown parameterz3Key %s is an alias of %s; setting value with latterrrNrG primitiverz--set parameterrcrinvalid parameterN)rprrrKrlogwarningrrSrNrrrHrtypify_parameter) r+rrraliasedrr base_context base_configparameter_namerGs rset_keyConfigurationFile.set_keysE /s##%89 9ll11#6 67 6 KKEs Cyy~  I '$,, "B"B<<//L,,11)R@K$( !NT<2 6tAw ? %89 9rclSSKJn URS5tpEUS:XaU[URS5(a:URR nUR RS05nUSn/nOURnUR nUnURU5Sn U S:Xah[U5S:XaYX;aUS :wa U"US 5eS /UR U'X'U;aU"US U<S 35eXxV s/sH oU:wdM U PM sn Xx'gU"US5e![a U"US5ef=fs sn f)z Remove an item from a sequence configuration parameter. :param key: Configuration key name. :param item: Item to remove from the sequence. :raises CondaKeyError: If the key is unknown, undefined, or the item is not present. r rrrNrrGrrYchannelsundefined in configdefaultszvalue z not present in configrN) rprrrSrKrNrrrHrr) r+rrrrrrrrrGis r remove_itemConfigurationFile.remove_itemsU /yy~  I '$,, "B"B<<//L,,11)R@K!!WND<rV classmethodrrrrrpropertyrsetterrKrrrrrrrrrrr?r)rrr|r|s  6:(,)-8< E2 E& E' E 6 E  E-1 7* 7  7 7-1 6* 6  6 68<(,R4R&R  RR(    [[&$$   $Y 4-=^  ,<+:Z,:\ __future__rrrcollections.abcr functoolsrloggingrpathlibrtypingrcommon.configurationr r r r r:rr$r&rrArzr|r)rrrs# $% ;(4 KH&&(  3>3>l# # $# #  # LO<O