HR-eq+dZddlZddlZddlZddlmZgdZdZddZddZ Gd d Z Gd d e Z Gd de Z ddZ dS)zwThis module contains functions to determine where configuration and data/cache files used by Astropy should be placed. Nwraps)get_config_dir get_cache_dirset_temp_configset_temp_cachecP tjd}n#t$rtjdkr1dtjvrtjd}nt dtjdkrpdtjvr3tjdrtjd}n_dtjvrPdtjvrBtjtjdtjd}nd tjvr0tjtjd }n d d l }d }| |j |}| |d d }| np#t$r3dtjvrtjd}nt dYn4wxYwdtjvrtjd}nt dYnwxYw|S)a'Locates and return the home directory (or best approximation) on this system. Raises ------ OSError If the home directory cannot be located - usually means you are running Astropy on some obscure platform that doesn't have standard home directories. ~posixHOMEzCCould not find unix home directory to search for astropy config dirntMSYSTEM HOMEDRIVEHOMEPATH USERPROFILErNz@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell FoldersPersonalzFCould not find windows home directory to search for astropy config dirzfCould not find a home directory to search for astropy config dir - are you on an unsupported platform?)ospath expanduser ExceptionnameenvironOSErrorgetjoinwinregOpenKeyHKEY_CURRENT_USER QueryValueExClose)homedirwreg shell_folderskeys 4lib/python3.11/site-packages/astropy/config/paths.py _find_homer&s2'$$S)) 000 7g  ##*V,)W__BJ&&2:>>&+A+A&*V, **zRZ/G/G',,rz+'> :@VWW"*,,',,rz-'@AA))))$gM,,t'=}MMC"//Z@@CGIIKKKK ++"$*V"4%< ##*V, Y0b Ns5#D:H#AF0/H#0:G-*H#,G--3H#"H#astropycd}tj~tj}tj||}tj|stj|tj|Stj d}|tj|rtj||}tj |s@tj|rtj|S|}tjtd||S)a Determines the package configuration directory name and creates the directory if it doesn't exist. This directory is typically ``$HOME/.astropy/config``, but if the XDG_CONFIG_HOME environment variable is set and the ``$XDG_CONFIG_HOME/astropy`` directory exists, it will be that directory. If neither exists, the former will be created and symlinked to the latter. Parameters ---------- rootname : str Name of the root configuration directory. For example, if ``rootname = 'pkgname'``, the configuration directory would be ``/.pkgname/`` rather than ``/.astropy`` (depending on platform). Returns ------- configdir : str The absolute path to the configuration directory. NXDG_CONFIG_HOMEconfig) r _temp_pathrrrexistsmkdirabspathrrislink_find_or_create_root_dir)rootnamelinktoxch config_pathxchpths r%rrOs0F!-(gll311 w~~k** " H[ ! ! !w{+++ *..* + +C 27>>#..c8,,w~~f%% w~~f%% wv... 7??3HfhOO P PPcd}tj~tj}tj||}tj|stj|tj|Stj d}|tj|rtj||}tj |s@tj|rtj|S|}tjtd||S)a Determines the Astropy cache directory name and creates the directory if it doesn't exist. This directory is typically ``$HOME/.astropy/cache``, but if the XDG_CACHE_HOME environment variable is set and the ``$XDG_CACHE_HOME/astropy`` directory exists, it will be that directory. If neither exists, the former will be created and symlinked to the latter. Parameters ---------- rootname : str Name of the root cache directory. For example, if ``rootname = 'pkgname'``, the cache directory will be ``/.pkgname/``. Returns ------- cachedir : str The absolute path to the cache directory. NXDG_CACHE_HOMEcache) rr+rrrr,r-r.rrr/r0)r1r2r3 cache_pathr5s r%rr~s0F ,'W\\#x00 w~~j)) ! HZ wz*** *..) * *C 27>>#..c8,,w~~f%% w~~f%% wv... 7??3GVXNN O OOr6c0eZdZdZdZddZdZdZdZdS) _SetTempPathNFc|tj|}||_||_|jj|_dSN)rrr._path_delete __class__r+ _prev_path)selfrdeletes r%__init__z_SetTempPath.__init__s9  7??4((D  .3r6c|j|j_ |dS#t$r|j|j_wxYw)Nr')r?rAr+_default_path_getterrrB)rCs r% __enter__z_SetTempPath.__enter__sQ$(J! ,,Y77 7   (,DN %  s (Ac~|j|j_|jr"|jt j|jdSdSdSr>)rBrAr+r@r?shutilrmtree)rCargss r%__exit__z_SetTempPath.__exit__sG$(O! < &DJ2 M$* % % % % % & &22r6c@tfd}|S)zImplements use as a decorator.cN5|i|ddddS#1swxYwYdSr>)rLkwargsfuncrCs r%wrapperz&_SetTempPath.__call__..wrappers & &d%f%%% & & & & & & & & & & & & & & & & & &s r)rCrRrSs`` r%__call__z_SetTempPath.__call__s; t & & & & &  &r6)NF) __name__ __module__ __qualname__r+rGrErHrMrTrPr6r%r<r<s`J4444&&& r6r<cBeZdZdZeeZfdZfdZxZ S)ra Context manager to set a temporary path for the Astropy config, primarily for use with testing. If the path set by this context manager does not already exist it will be created, if possible. This may also be used as a decorator on a function to set the config path just within that function. Parameters ---------- path : str, optional The directory (which must exist) in which to find the Astropy config files, or create them if they do not already exist. If None, this restores the config path to the user's default config path as returned by `get_config_dir` as though this context manager were not in effect (this is useful for testing). In this case the ``delete`` argument is always ignored. delete : bool, optional If True, cleans up the temporary directory after exiting the temp context (default: False). cddlm}||_|t SN)_cfgobjs) configurationr\copy _cfgobjs_copyclearsuperrH)rCr\rAs r%rHzset_temp_config.__enter__sM ,+++++%]]__ww  """r6cddlm}|||j|`t j|dSrZ)r]r\r`updater_rarM)rCrLr\rAs r%rMzset_temp_config.__exit__sZ++++++*+++  $r6) rUrVrW__doc__ staticmethodrrGrHrM __classcell__)rAs@r%rrsm2(<77 # # # # #         r6rc(eZdZdZeeZdS)ra. Context manager to set a temporary path for the Astropy download cache, primarily for use with testing (though there may be other applications for setting a different cache directory, for example to switch to a cache dedicated to large files). If the path set by this context manager does not already exist it will be created, if possible. This may also be used as a decorator on a function to set the cache path just within that function. Parameters ---------- path : str The directory (which must exist) in which to find the Astropy cache files, or create them if they do not already exist. If None, this restores the cache path to the user's default cache path as returned by `get_cache_dir` as though this context manager were not in effect (this is useful for testing). In this case the ``delete`` argument is always ignored. delete : bool, optional If True, cleans up the temporary directory after exiting the temp context (default: False). N)rUrVrWrdrerrGrPr6r%rrs,6(< 66r6rc  tjtd|}tjtd||}tj|s9tj|sF tj|nh#t $r#tj|sYn>G 7>>' " " w~~h''  """"   w}}X.. x(( UGUUeUUUUU   HW       7==))      ''.. ("GNN6**# Jw ' ' ' W]]7 # #  Q Q Q% Q QG Q Q Q    7??7 # ##s$ B55*C"!C"D33*E E )r')rdrrJrm functoolsr__all__r&rrr<rrr0rPr6r%rws'  R R R>>>B,Q,Q,Q,Q^-P-P-P-P`""""""""J- - - - - l- - - `77777\777>#$#$#$#$#$#$r6