o !wiט@s\UdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZddlmZmZddlZejjZejdksWejd krZejd sZd Znd Zeed dZedcddddZededdZdcdfddZdgddZdhddZiZ de!d <did"d#Z"dgd$d%Z#djd&d'Z$dhd(d)Z%dhd*d+Z&dhd,d-Z'ed.Z(de!d/<dZ)d0e!d1<ej*d2kre(rej+,d3dZ)erej*d2kre(se-eejd4d gZ.n*ej/edd5d60ej1Z.nej*d2kre)ree)d gZ.ne-eejd4d gZ.nd7d8gZ.e-eejd4d gZ2d9e!d:<dkdd gZ4d9e!d?<erBej*d2kr5e(s5e4ddZ5n*ej6edd5d60ej1Z5nej*d2kr[e)rTe-ee)d gZ5n e4ddZ5nd@dAgZ5dldBdCZ7didDdEZ8dmdndJdKZ9dmdndLdMZ:ejdkr~e9Z;ne:Z;dodpdPdQZdrdXdYZ?e@dZd[Ad\vZBe dcdsd_d`ZCdtdadbZDdS)uzPath utility functions.) annotationsN)Iterator)contextmanager)Path)Anyoverloadwin32darwinz /opt/homebrewJupyterjupyter UF_HIDDENiFnamestrdefaultboolreturncCdSNr rrrO/home/ubuntu/sommelier/.venv/lib/python3.10/site-packages/jupyter_core/paths.pyenvset(rNone bool | NonecCrrrrrrrr,rcCs |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)osenvironlowerrrrrr0s cCs tddS)zcDetermine if platformdirs should be used for system-specific paths. The default is False. JUPYTER_PLATFORM_DIRSF)rrrrruse_platform_dirs>s r$cCstd}tt|S)z'Get the real path of the home directory~)r expanduserrresolve)homedirrrr get_home_dirFs 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'existsparentownerr getlogin Exceptionhasattrstatst_uidr,NotImplementedErrorOSErroraccessW_OK)r+pstrrr _do_i_ownQs"   r;cCsldtjvr tdStjtjkrttjrdSdtjvr4tjtjdr4tjdddkr4ttjr4dSdS)zRDetermine if environment-level paths should take precedence over user-level paths.JUPYTER_PREFER_ENV_PATHT CONDA_PREFIXCONDA_DEFAULT_ENVbaseF) r r!rsysprefix base_prefixr; startswithgetrrrrprefer_environment_over_userls  rEcCs: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. -)rA)r*KeyErrortempfilemkdtemp)r drrr _mkdtemp_onces   rKcCsNtj}|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-cfgJUPYTER_CONFIG_DIRF appauthorz.jupyter) r r!rDrKr$ platformdirsuser_config_dirAPPNAMEr)pjoin)envhome_dirrrrjupyter_config_dirs   rVcCstj}|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. JUPYTER_DATA_DIRFrNr Libraryr rAPPDATANr data XDG_DATA_HOMEz.localshare)r r!rDr$rP user_data_dirrRr)r@platformrrr'rSrV)rThomeappdataxdgrrrjupyter_data_dirs"       rbcCs$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. JUPYTER_RUNTIME_DIRruntime)r r!rDrSrb)rTrrrjupyter_runtime_dirs  reJUPYTER_USE_PROGRAMDATA_use_programdataz str | None_win_programdatant PROGRAMDATAr\T)rO multipathz/usr/local/share/jupyterz/usr/share/jupyter list[str]ENV_JUPYTER_PATHsubdirscsg}tjdr|ddtjdtjDtg}tjr?t tdr)t ntj }|r?t t |dd}||vr?||ttkrFt}nddtD}tr[||||n ||||tD] }||vrr||qgr~fd d|D}|S) ayReturn a list of directories to search for data files. There are four sources of paths to search: - $JUPYTER_PATH environment variable (always highest priority) - user directories (e.g. ~/.local/share/jupyter) - environment directories (e.g. {sys.prefix}/share/jupyter) - system-wide paths (e.g. /usr/local/share/jupyter) JUPYTER_PATH environment variable has highest priority, if defined, and is purely additive. If the JUPYTER_PREFER_ENV_PATH environment variable is set, the environment-level directories will have priority over user-level directories. You can also set JUPYTER_PREFER_ENV_PATH=0 to explicitly prefer user directories. If Jupyter detects that you are in a virtualenv or conda environment, environment paths are also preferred to user paths, otherwise user paths are preferred to environment paths. If the Python site.ENABLE_USER_SITE variable is True, we also add the appropriate Python user site subdirectory to the user-level directories. Finally, system-wide directories, such as `/usr/local/share/jupyter` are searched. If ``*subdirs`` are given, that subdirectory will be added to each element. .. versionchanged:: 5.8 On Windows, %PROGRAMDATA% will be used as a system-wide path only if the JUPYTER_USE_PROGRAMDATA env is set. By default, there is no default system-wide path on Windows and the env path is used instead. Examples: >>> jupyter_path() ['~/.local/jupyter', '/usr/local/share/jupyter'] >>> jupyter_path('kernels') ['~/.local/jupyter/kernels', '/usr/local/share/jupyter/kernels'] JUPYTER_PATHcs|] }|tjVqdSrrstripr sep.0r9rrr %zjupyter_path.. getuserbaser\r cSg|]}|tvr|qSr)SYSTEM_JUPYTER_PATHrtrrr :z jupyter_path..csg|] }t|gRqSr)rSrtrnrrr{Js)r r!rDextendsplitpathseprbsiteENABLE_USER_SITEr2rx USER_BASErrappendrmrzrE)rnpathsuseruserbaseuserdirrT_pathrr}r jupyter_paths2+ "      retcENV_CONFIG_PATHz/usr/local/etc/jupyterz /etc/jupytercCstjdr tgSg}tjdr#|ddtjdtjDtg}tjrIt tdr3t ntj }|rIt t |dd}||vrI||ttkrPt}ndd tD}tre||||n ||||ttkrx|t|S) a+Return 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. Finally, system-wide directories such as `/usr/local/etc/jupyter` are searched. .. versionchanged:: 5.8 On Windows, %PROGRAMDATA% will be used as a system-wide path only if the JUPYTER_USE_PROGRAMDATA env is set. By default, there is no system-wide config path on Windows. Examples: >>> jupyter_config_path() ['~/.jupyter', '~/.local/etc/jupyter', '/usr/local/etc/jupyter', '/etc/jupyter'] rLJUPYTER_CONFIG_PATHcsrprrqrtrrrrvrwz&jupyter_config_path..rxrr cSryr)SYSTEM_CONFIG_PATHrtrrrr{r|z'jupyter_config_path..)r r!rDrVr~rrrrr2rxrrrrrrrE)rrrrrTrrrjupyter_config_pathgs.  "      rcCs&zt|WdStyYdSw)zcReplacement for `os.path.exists` which works for host mapped volumes on Windows containers FT)r lstatr6)r+rrrr-s   r-abs_path str | Pathstat_res Any | Nonec Cst|}|jdr dS|dur3zt|}Wnty2}z|jtjkr-WYd}~dSd}~wwz |jtj@r=WdSWdSt yPt 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) rr rCr3r6errnoENOENTst_file_attributesFILE_ATTRIBUTE_HIDDENAttributeErrorwarningswarnrrerrris_file_hidden_wins6   rc Cst|}|jdr dS|dust|jr7z|}Wnty6}z|jtjkr1WYd}~dSd}~wwt |jrIt |t j t j BsIdSt|ddt@rSdSdS)rrTNFst_flagsr)rr rCr3S_ISLNKst_moder6rrS_ISDIRr r7X_OKR_OKgetattrr rrrris_file_hidden_posixs$    rabs_rootc Cs,ttj|}|rttj|}nt|jd}||kr dS|s.d|d}t||s