o Zh@sUdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZmZmZddlZddlmZejjZejd ksYejd kr\ejd s\d Znd ZeeddZd^d_ddZd`ddZdaddZ iZ!de"d<dbd d!Z#d`d"d#Z$dcd$d%Z%dad&d'Z&dad(d)Z'dad*d+Z(erej)edd,d-*ej+Z,n(ed.ej-d/krej./d0dZ0e0ree0d gZ,ne1e ejd1d gZ,nd2d3gZ,e1e ejd1d gZ2d4e"d5<ddd7d8Z3erej4edd,d-*ej+Z5n ej-d/krej./d0dZ0e0r e1e e0d gZ5ngZ5nd9d:gZ5e1e ejd;d gZ6d4e"d<<ded=d>Z7dbd?d@Z8dfdgdDdEZ9dfdgdFdGZ:ejd kr@e9Z;ne:Z;dhdidJdKZdkdSdTZ?e@dUdVAdWvZBe d^dldZd[ZCdmd\d]ZDdS)nzPath utility functions.) annotationsN)contextmanager)Path)AnyIteratorOptional) deprecationwin32darwinz /opt/homebrewJupyterjupyter UF_HIDDENiFnamestrdefaultOptional[bool]returncCs |tjvr|Stj|dvS)a%Return the boolean value of a given environment variable. An environment variable is considered set if it is assigned to a value other than 'no', 'n', 'false', 'off', '0', or '0.0' (case insensitive) If the environment variable is not defined, the default value is returned. )nonfalseoff0z0.0)osenvironlower)rrrI/var/www/html/lang_env/lib/python3.10/site-packages/jupyter_core/paths.pyenvset)s rboolcCs tddS)zDetermine if platformdirs should be used for system-specific paths. We plan for this to default to False in jupyter_core version 5 and to True in jupyter_core version 6. ZJUPYTER_PLATFORM_DIRSF)rrrrruse_platform_dirs7s r cCstd}tt|S)z'Get the real path of the home directory~)r expanduserrresolve)homedirrrr get_home_dir@s r%zdict[str, str]_dtempspathc Cst|}|s||jkr|j}|s||jksz |tkWSty-YnwttdrKz | }|j t kWSt t fyJYnwt|tjS)z3Return whether the current user owns the given pathgeteuid)rr#existsparentownerrgetlogin Exceptionhasattrstatst_uidr(NotImplementedErrorOSErroraccessW_OK)r'pstrrr _do_i_ownKs"   r7cCsldtjvr tdStjtjkrttjrdSdtjvr4tjtjdr4tjdddkr4ttjr4dSdS)zRDetermine if environment-level paths should take precedence over user-level paths.ZJUPYTER_PREFER_ENV_PATHTZ CONDA_PREFIXZCONDA_DEFAULT_ENVbaseF) rrrsysprefix base_prefixr7 startswithgetrrrrprefer_environment_over_userfs  r>cCs:zt|WStytj|dd}t|<|YSw)zMake or reuse a temporary directory. If this is called with the same name in the same process, it will return the same directory. -)r:)r&KeyErrortempfilemkdtemp)rdrrr _mkdtemp_once|s   rDcCsNtj}|dr tdS|dr|dStrtjtddSt}t |dS)zGet the Jupyter config directory for this platform and user. Returns JUPYTER_CONFIG_DIR if defined, otherwise the appropriate directory for the platform. JUPYTER_NO_CONFIGzjupyter-clean-cfgZJUPYTER_CONFIG_DIRF appauthorz.jupyter) rrr=rDr platformdirsuser_config_dirAPPNAMEr%pjoin)envZhome_dirrrrjupyter_config_dirs   rMcCstj}|dr |dStrtjtddSt}tj dkr&t t |ddStj dkrCtjdd }|r=t t |d  St td S|d d }|sQt |d d}t |d S)zGet the config directory for Jupyter data files for this platform and user. These are non-transient, non-configuration files. Returns JUPYTER_DATA_DIR if defined, else a platform-appropriate path. ZJUPYTER_DATA_DIRFrFr Libraryr r APPDATANr data XDG_DATA_HOMEz.localshare)rrr=r rH user_data_dirrJr%r9platformrrr#rKrM)rLhomeappdataZxdgrrrjupyter_data_dirs"       rWcCs$tj}|dr |dSttdS)zReturn the runtime dir for transient jupyter files. Returns JUPYTER_RUNTIME_DIR if defined. The default is now (data_dir)/runtime on all platforms; we no longer use XDG_RUNTIME_DIR after various problems. ZJUPYTER_RUNTIME_DIRZruntime)rrr=rKrW)rLrrrjupyter_runtime_dirs  rXT)rG multipatha7Jupyter is migrating its paths to use standard platformdirs given by the platformdirs library. To remove this warning and see the appropriate new directories, set the environment variable `JUPYTER_PLATFORM_DIRS=1` and then run `jupyter --paths`. The use of platformdirs will be the default in `jupyter_core` v6ntZ PROGRAMDATArRz/usr/local/share/jupyterz/usr/share/jupyter list[str]ENV_JUPYTER_PATHsubdirscsg}tjdr|ddtjdtjDtg}tjr?t tdr)t ntj }|r?t t |dd}||vr?||ddtD}trT||||n |||||trnfd d|D}|S) aReturn a list of directories to search for data files JUPYTER_PATH environment variable has highest priority. If the JUPYTER_PREFER_ENV_PATH environment variable is set, the environment-level directories will have priority over user-level directories. If the Python site.ENABLE_USER_SITE variable is True, we also add the appropriate Python user site subdirectory to the user-level directories. If ``*subdirs`` are given, that subdirectory will be added to each element. Examples: >>> jupyter_path() ['~/.local/jupyter', '/usr/local/share/jupyter'] >>> jupyter_path('kernels') ['~/.local/jupyter/kernels', '/usr/local/share/jupyter/kernels'] Z JUPYTER_PATHcs|] }|tjVqdSNrstriprsep.0r5rrr zjupyter_path.. getuserbaserRr cSg|]}|tvr|qSr)SYSTEM_JUPYTER_PATHrcrrr z jupyter_path..csg|] }t|gRqSr)rKrcr]rrrjs)rrr=extendsplitpathseprWsiteENABLE_USER_SITEr.rg USER_BASErrappendr\r>ri)r]pathsuseruserbaseuserdirrLrrlr jupyter_paths( "      rxz/usr/local/etc/jupyterz /etc/jupyteretcENV_CONFIG_PATHcCstjdr tgSg}tjdr#|ddtjdtjDtg}tjrIt tdr3t ntj }|rIt t |dd}||vrI||dd tD}tr^||||n |||||t|S) arReturn the search path for Jupyter config files as a list. If the JUPYTER_PREFER_ENV_PATH environment variable is set, the environment-level directories will have priority over user-level directories. If the Python site.ENABLE_USER_SITE variable is True, we also add the appropriate Python user site subdirectory to the user-level directories. rEZJUPYTER_CONFIG_PATHcsr^r_r`rcrrrreHrfz&jupyter_config_path..rgryr cSrhr)SYSTEM_CONFIG_PATHrcrrrrjWrkz'jupyter_config_path..)rrr=rMrmrnrorprqr.rgrrrrrsrzr>r{)rtrurvrwrLrrrjupyter_config_path6s(  "      r|cCs&zt|WdStyYdSw)zcReplacement for `os.path.exists` which works for host mapped volumes on Windows containers FT)rlstatr2)r'rrrr)es   r)abs_pathstat_res Optional[Any]c Cst|jdr dS|dur1zt|}Wnty0}z|jtjkr+WYd}~dSd}~wwz |jtj@r;WdSWdSt yNt j dddYdSw)Is a file hidden? This only checks the file itself; it should be called in combination with checking the directory containing the file. Use is_hidden() instead to check the file and its parent directories. Parameters ---------- abs_path : unicode The absolute path to check. stat_res : os.stat_result, optional The result of calling stat() on abs_path. If not passed, this function will call stat() internally. .TNFzThidden files are not detectable on this system, so no file will be marked as hidden. stacklevel) rrr<r/r2errnoENOENTZst_file_attributesFILE_ATTRIBUTE_HIDDENAttributeErrorwarningswarnr~rerrris_file_hidden_winps4  rc Cst|jdr dS|dust|jr7zt|}Wnty6}z|jtjkr1WYd}~dSd}~wwt |jrIt |t j t j BsIdSt|ddt@rSdSdS)rrTNFst_flagsr)rrr<r/S_ISLNKst_moder2rrS_ISDIRrr3X_OKR_OKgetattrrrrrris_file_hidden_posixs"  rabs_rootcCstj|}tj|}||krdSt|rdS|s&|tjddtj}|t|d}tddt|j Dr