\Zi8SrSSKJr SSKrSSKJrJrJr SSKJ r SSK J r J r J r JrJr SSKJr SS KJr SS KJr SS KJrJrJr SS KJr SS KJr SSKJr \(aSSK J!r! \ "\"5r#SSSjjr$SSjr%SSjr&SSjr'SSjr(SSSjjr)SSjr*g) z&Tools for managing conda environments.) annotationsN)EACCESENOENTEROFS) getLogger)dirnameisdirisfilejoinnormpath) TYPE_CHECKING)context)is_admin)ensure_text_typeon_win open_utf8)expand) yield_lines) PrefixData)Iteratorc.[[USS55$)z Gets the path to the user's environments.txt file. :param userhome: The home directory of the user. :type userhome: str :return: Path to the environments.txt file. :rtype: str z.condazenvironments.txt)rr )userhomes 7lib/python3.13/site-packages/conda/core/envs_manager.pyget_user_environments_txt_filers $x+=> ??c[R(dg[5n[U5n[ U5n[ R "U5 SU;dSU;dU[ R:XagU[U5;ag[ RR U5n[ R "USS9 [US5nUR[U55 URS 5 SSS5 g! N=f![a%n[RSUSU35 SnAgSnAff=f!,(df  g=f![aAnUR ["[$[&4;a[RS UU5 SnAgeSnAff=f) z Registers an environment by adding it to environments.txt file. :param location: The file path of the environment to register. :type location: str :return: None N placehold_pl skeleton_T)exist_okz1Unable to register environment. Could not create z . Reason: a zlUnable to register environment. Path not writable or missing. environment location: %s registry file: %s)r register_envsrr rosmakedirsdevnullrpathOSErrorlogwarningrwritererrnorrr)locationuser_environments_txt_filefolderuser_environments_txt_directoryexcfhes r register_envr5&sh  !?!A!H X F  F (" ( " % 3 ;9::&(ggoo6P&Q# 3dC 13 72 HH%h/ 0 HHTN8 77  "   ?@Ae   8 7   77vuf- - KK&*     s_C6C=5 E,D/-E6C:= D,D''D,/ D=9E=E F  6FFF c[U5(aR[US5n[U5(a6[S[R"U555n[ U5S:ag[ [5U5 g)a Unregisters an environment by removing its entry from the environments.txt file if certain conditions are met. The environment is only unregistered if its associated 'conda-meta' directory exists and contains no significant files other than 'history'. If these conditions are met, the environment's path is removed from environments.txt. :param location: The file path of the environment to unregister. :type location: str :return: None z conda-metac38# UHoRv M g7fN)name.0entrys r !unregister_env..ns%S>RUjj>RrN)r r tupler%scandirlen_clean_environments_txtr)r.meta_dirmeta_dir_contentss runregister_envrFas] X,/ ?? %%Sbjj>R%S S $%):.sQ8Pu 8Pr?r)getpwallc38# UHoRv M g7fr8)pw_dir)r;pwentrys rr=rJsIj7jr?NzUnable to access c3J# UHn[U5(dMUv M g7fr8)r )r;envs_dirs rr=rJsO*;huX*;s# #c3x># UH/nUT;dM [U5R5(dM+Uv M1 g7fr8ris_environment)r;r( all_env_pathss rr=rJs@ D } $ *4D)9)H)H)J  :: :c3t# UH.n[R"U5Ho"Rv M M0 g7fr8)r%rAr()r;rPr<s rr=rJs' '08bjj>RUJJ>RJys68)setrrrrr@r%rApwdrKfilterrr updaterCPermissionErrorr*r+r envs_dirsadd root_prefixsorted) home_dir_dir search_dirsrKhome_direnvironments_txt_filer\rTs @rlist_all_known_prefixesrdws:EMzz 6"6#;/LQ <8PQQK $IhjIIs NKc{n 4- >x H ' ( ( I$$%<=R%ST .P'*;*;OI '0 g))* -  # I /0E/FGH Is E  "E21E2c## [5H4n[[U5RU55nU(dM/X4v M6 g7f)z Queries all known prefixes for a given specification. :param spec: The specification to query for. :type spec: str :return: An iterator of tuples containing the prefix and the query results. :rtype: Iterator[Tuple[str, Tuple]] N)rdr@rquery)specprefix prefix_recss rquery_all_prefixesrjs<*+Jv.44T:; ;% %,s 6A Ac^[U5(dgT(a [T5m[[U55n[U4SjU55nX2:wa [ X5 U$)aM Cleans the environments.txt file by removing specified locations. :param environments_txt_file: The file path of environments.txt. :param remove_location: Optional location to remove from the file. :type environments_txt_file: str :type remove_location: Optional[str] :return: A tuple of the cleaned lines. :rtype: Tuple[str, ...] c3x># UH/nUT:wdM [U5R5(dM+Uv M1 g7fr8rR)r;rhremove_locations rr=*_clean_environments_txt..s8+,F _ $ )3F);)J)J)L ,rU)r r r@r_rewrite_environments_txt)rcrnenvironments_txt_linesenvironments_txt_lines_cleaneds ` rrCrCsa ' ( ("?3";/D#EF%*+,+&" &?!"7X ))rc8[US5nURSRU55 URS5 SSS5 g!,(df  g=f![a5n[R SU5 [R SUSS9 SnAgSnAff=f)a Rewrites the environments.txt file with the specified prefixes. :param environments_txt_file: The file path of environments.txt. :param prefixes: List of prefixes to write into the file. :type environments_txt_file: str :type prefixes: List[str] :return: None wr#NzFile not cleaned: %sz%rT)exc_info)rr,r r)r*infodebug)rcprefixesr3r4s rrprpss* ,c 2b HHTYYx( ) HHTN3 2 2 * ')>? $D )*s4 A2A A AAA B$+BB)rH)rstrreturnry)r.ryrzNone)rz list[str])rgryrzzIterator[tuple[str, tuple]]r8)rcryrnz str | Nonerzztuple[str, ...])rcryrxr|rzr{)+__doc__ __future__rr%r-rrrloggingros.pathrr r r r typingr base.contextr common._osr common.compatrrr common.pathrgateways.disk.readr prefix_datarcollections.abcr__name__r*rr5rFrdrjrCrprlrrrs-" '':: "!?? ,#( @8vH,+!\ &"#'****<*r