biטUdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZddlmZmZddlZej(j*Zej.dk(s*ej.d k(rej0j3d sd Znd Zeed dZed=d>dZed?dZd=d@dZdAdZdBdZiZ de!d<dCdZ"dAdZ#dDdZ$dBdZ%dBdZ&dBdZ'edZ(de!d<dZ)d e!d!<ejTd"k(re(rejVjYd#dZ)er\ejTd"k(re(se-eej0d$d gZ.nkej^edd%&jaejbZ.ndLd7Z?ejd8d9jd:vZBe d=dMd;ZCdNd<ZDy)OzPath utility functions.) annotationsN)Iterator)contextmanager)Path)Anyoverloadwin32darwinz /opt/homebrewJupyterjupyter UF_HIDDENiFboolcyNnamedefaults M/home/cdr/jupyterlab/.venv/lib/python3.12/site-packages/jupyter_core/paths.pyenvsetr(s69cyrrrs rrr,s58rcp|tjvr|Stj|jdvS)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)osenvironlowerrs rrr0s3 2:: ::d  ! ! #+R RRrctddS)zcDetermine if platformdirs should be used for system-specific paths. The default is False. JUPYTER_PLATFORM_DIRSF)rrrruse_platform_dirsr$>s )5 11rcxtdj}tt|jS)z'Get the real path of the home directory~)r expanduserstrresolve)homedirs r get_home_dirr+Fs.3i""$G tG}$$& ''rzdict[str, str]_dtempsc*t|j}|js;||jk7r,|j}|js||jk7r, |j t j k(S#t$rYnwxYwtt drG |j}|jt jk(S#ttf$rYnwxYwt j|t jS)z3Return whether the current user owns the given pathgeteuid)rr)existsparentownerrgetlogin Exceptionhasattrstatst_uidr.NotImplementedErrorOSErroraccessW_OK)pathpsts r _do_i_ownr>Qs T AhhjQ!((] HHhhjQ!((]  wwyBKKM))    r9 B99 , ,#W-    99Q  s$&$B BB+0CC.-C.cdtjvr tdStjtj k7rt tjrydtjvrmtjjtjdr=tjjdddk7rt tjryy)zRDetermine if environment-level paths should take precedence over user-level paths.JUPYTER_PREFER_ENV_PATHT CONDA_PREFIXCONDA_DEFAULT_ENVbaseF) rr rsysprefix base_prefixr> startswithgetrrrprefer_environment_over_userrIls!BJJ./00 zzS__$3::)> "**$ JJ ! !"**^"< = JJNN. 76 A cjj ! rc| t|S#t$r'tj|dzx}t|<|cYSwxYw)zMake or reuse a temporary directory. If this is called with the same name in the same process, it will return the same directory. -)rE)r,KeyErrortempfilemkdtemp)rds r _mkdtemp_oncerPsB t} $,,D3J??GDMs  -;;ctj}|jdr tdS|jdr|dSt rt j tdSt}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) rr rHrPr$ platformdirsuser_config_dirAPPNAMEr+pjoin)envhome_dirs rjupyter_config_dirr\sl **C ww"#011 ww#$'((++GuEE~H : &&rc0tj}|jdr|dStrt j t dSt}tjdk(rtt|ddStjdk(rYtjjdd }|r#tt|d jSttd S|jd d }|s t|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_DIRFrTr Libraryr r APPDATANr data XDG_DATA_HOMEz.localshare)rr rHr$rV user_data_dirrXr+rDplatformr(rr)rYr\)rZhomeappdataxdgs rjupyter_data_dirris **C ww!"%&&))'UCC >D ||x4i344 ||w**..D1 tGY/779: :')622 ''/4 (C D(G, i  rcvtj}|jdr|dStt dS)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)rr rHrYri)rZs rjupyter_runtime_dirrms7 **C ww$%()) !#Y //rJUPYTER_USE_PROGRAMDATA_use_programdataz str | None_win_programdatant PROGRAMDATArcT)rU multipathz/usr/local/share/jupyterz/usr/share/jupyter list[str]ENV_JUPYTER_PATHcVg}tjjdrF|jdtjdj tj Dt g}tjrattdrtjntj}|r+tt|dd}||vr|j|tt k(rt}ntDcgc] }|t vs |}}t#r#|j||j|n"|j||j|t D]}||vs|j||r|Dcgc]}t%|g|}}|Scc}wcc}w)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_PATHc3ZK|]#}|jtj%ywrrstriprsep.0r<s r zjupyter_path..%s\!QXXbff%\)+ getuserbasercr )rr rHextendsplitpathseprisiteENABLE_USER_SITEr4r USER_BASEr(rappendruSYSTEM_JUPYTER_PATHrIrY)subdirspathsuseruserbaseuserdirrZr<_paths r jupyter_pathrs`VE zz~~n% \rzz./I/O/OPRPZPZ/[\\   D *1})E4##%4>> $x)<=Gd" G$ ..*KQa7J.JqKK#% S T T S%    LL  -23q#7#33 L#L 4s F!F! F&etcENV_CONFIG_PATHz/usr/local/etc/jupyterz /etc/jupytercltjjdr tgSg}tjjdrF|j dtjdj tj Dtg}tjrattdrtjntj}|r+tt|dd}||vr|j|tt k(rt}ntDcgc] }|t vs |}}t#r#|j ||j |n"|j ||j |tt k7r|j t |Scc}w)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'] rRJUPYTER_CONFIG_PATHc3ZK|]#}|jtj%ywrryr|s rr~z&jupyter_config_path..sc!QXXbff%crrrr )rr rHr\rrrrrr4rrr(rrrSYSTEM_CONFIG_PATHrI)rrrrrZr<s rjupyter_config_pathrgsJ2 zz~~)*"$%%E zz~~+, crzz:O/P/V/VWYWaWa/bcc  !D *1})E4##%4>> $x :;Gd" G$ ,,)IQQ6H-HqII#% S T T S,, '( LJs * F18F1cN tj|y#t$rYywxYw)zcReplacement for `os.path.exists` which works for host mapped volumes on Windows containers FT)rlstatr8)r;s rr/r/s+   s  $$c~t|}|jjdry| t|j} |jtjzry y#t$r(}|j t j k(rYd}~yd}~wwxYw#t$rtjddYywxYw)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) rrrGr5r8errnoENOENTst_file_attributesFILE_ATTRIBUTE_HIDDENAttributeErrorwarningswarnabs_pathstat_reses ris_file_hidden_winrs H~H}}$ H~**,H   ' '(( ) ) ) ww%,,&      b  s/A%B% B.BBB B<;B<ct|}|jjdry|tj|j r |j}tj|j r6tj|tjtjzsyt|ddtzryy#t $r(}|jtjk(rYd}~yd}~wwxYw)rrTNFst_flagsr)rrrGr5S_ISLNKst_moder8rrS_ISDIRrr9X_OKR_OKgetattrr rs ris_file_hidden_posixrs H~H}}$4<<(8(89 }}H ||H$$%yy277RWW#45xQ')3  ww%,,&  s C C6C10C11C6cttjj|}|r)ttjj|}nt |j d}||k(ry|j sd|d}t||j sd|d}t||j|sd|d|d}t|t|ry |j|}td |jDry |j D]A}|js||k(ry |j}t!|d d t"zsAy y#t$rYy wxYw) aIs a file hidden or contained in a hidden directory? This will start with the rightmost path element and work backwards to the given root to see if a path is hidden or in a hidden directory. Hidden is determined by either name starting with '.' or the UF_HIDDEN flag as reported by stat. If abs_path is the same directory as abs_root, it will be visible even if that is a hidden folder. This only checks the visibility of files and directories *within* abs_root. Parameters ---------- abs_path : str or Path The absolute path to check for hidden directories. abs_root : str or Path The absolute path of the root directory in which hidden directories should be checked for. Fz abs_path=z, is not absolute. abs_path must be absolute.z abs_root=z, is not absolute. abs_root must be absolute.z# is not a subdirectory of abs_root=z#. abs_path must be within abs_root.Tc3>K|]}|jdyw)rN)rG)r}parts rr~zis_hidden..Cs @D4??3  @srr)rrr;normpathlistparents is_absolute ValueErroris_relative_tois_file_hidden relative_toanypartsr/rr8rr )rabs_root_msg relative_pathr0r=s r is_hiddenrs(BGG$$X./H((23(()"-8    !(HI    !(HI  " "8 ,xk=H;>a b h((2M @M,?,? @@"" }}  X    B 2z1 % 1     s;E$$ E10E1cn ddl}ddl}ddl}|j |j }|jd|j|j\}}}|j||j}|j} | j|j|j|j z|j"z|| j|j|j$||j'd| d|j)||j|y#t$rt|cYSwxYw)aSecure a windows file to read-only access for the user. Follows guidance from win32 library creator: http://timgolden.me.uk/python/win32_how_do_i/add-security-to-a-file.html This method should be executed against an already generated file which has no secrets written to it yet. Parameters ---------- fname : unicode The path to the file to secure rN)win32api ImportError#_win32_restrict_file_to_user_ctypes ntsecuritycon win32securityCreateWellKnownSidWinBuiltinAdministratorsSidLookupAccountName GetUserNameExNameSamCompatibleGetFileSecurityDACL_SECURITY_INFORMATIONACLAddAccessAllowedAce ACL_REVISIONFILE_GENERIC_READFILE_GENERIC_WRITEDELETEFILE_ALL_ACCESSSetSecurityDescriptorDaclSetFileSecurity) fnamerconradminsr_domain_typesddacls rwin32_restrict_file_to_userrXs :  - -m.W.W XF(:: H " "8#=#= >D'5  & &um.U.U VB    D""  6 66C   ]779L9LfU  D!,!!%)P)PRTU 3 :2599:sDD43D4c  %&'()*+,-ddl+ddlm-+jdd*+jdd,d}d }d }d%d &d 'd }d}d}d}d}d} d} d} d} d } d}d}||zdz}|| z| z| z|z}|| z|z|z| z|z}G-fdd+j}+j)+j |(+j -j }d%+fd }|,j_-j,j_ +j-j-jf,j_|*j_-j*j_ -j ))-j"f*j_|*j$_-j*j$_ -j-j)-j&-j-j&-j&f*j$_|*j(_-j*j(_ (-j -j )f*j(_|*j*_-j*j*_ |-j(-jf*j*_|*j,_-j*j,_ -j.-j |-j -j&f*j,_|*j0_-j*j0_ -j.-j |f*j0_|*j2_-j*j2_ ||-j&(-j&(-j&)-j&)-j&f *j2_|*j4_-j*j4_ ||-j&f*j4_|*j6_-j*j6_ (-j -j f*j6_d&&*+-fd }d''+,fd }d(&*+-fd }d)*fd }d*&*+-fd } d+*fd } d,*fd }d-&()*+-fd! }d.&*+-fd" }d/%(*+fd# }||} |d$||d}!|}"||"%|| ||"%||z|z|!|||}#||#}$||$d|"d||$}#||||#y)0aSecure a windows file to read-only access for the user. Follows guidance from win32 library creator: http://timgolden.me.uk/python/win32_how_do_i/add-security-to-a-file.html This method should be executed against an already generated file which has no secrets written to it yet. Parameters ---------- fname : unicode The path to the file to secure rNwintypesadvapi32T)use_last_errorsecur32rziiiiriceZdZdWjfdWjfdWjfdWjfdWjfgZy)0_win32_restrict_file_to_user_ctypes..ACL AclRevisionSbz1AclSizeAceCountSbz2N)__name__ __module__ __qualname__BYTEWORD_fields_rsrrrsF HMM * X]] #  &  ' X]] #  rrcJ|sjj|Sr)WinErrorget_last_error)resultfuncargsctypess r_nonzero_successz=_win32_restrict_file_to_user_ctypes.._nonzero_successs#//&"7"7"9: : rc ljdz}j} j|d|j||ddS#t$r[}|j k7rj|j z}j|d|j|Yd}~dd}~wwxYw)Nr)c_charDWORDrbyrefr8winerrorvalue)WellKnownSidTypepSidcbSidrERROR_INSUFFICIENT_BUFFERrrrs rrz?_win32_restrict_file_to_user_ctypes..CreateWellKnownSid,s! !$  [  ' '(8$fllSXFY Z Aw  [zz66/FMMEKK/2D  ' '(8$fllSXFY Z Z  [s#A B3AB..B3cnjjd} j|d||j j syj|j j }j||||j S#t$r}|jk7rYd}~yd}~wwxYwNr)pointerc_ulongGetUserNameExWr8r contentsrcreate_unicode_buffer) NameFormatnSizer lpNameBufferERROR_MORE_DATArrs rrz:_win32_restrict_file_to_user_ctypes..GetUserNameEx9sv~~a01   " ":tU ;~~##33ENN4H4HI z<?!!! zz_,- sB B4B//B4c  jd} jd} jd} j||d j|d j| j| j d|j } j j| j} j d|j dz} j||| j|| j| j|} | s j||j |j fS#t$r}|j k7rYd}~d}~wwxYw)Nrrr) r LookupAccountNameWr r8r rrcastrLPVOIDr) lpSystemName lpAccountNamercchReferencedDomainNamepeUserSidrlpReferencedDomainNamesuccessrrrrs rrz>_win32_restrict_file_to_user_ctypes..LookupAccountNameHs[q!"*.."3q!   ' ' U# 45 U# **2u{{;{{6>>#.@!'!=!=bBYB_B_bcBc!d--    LL  " LL0 1 LL  //# #+115;;>># zz667 sAE E2E--E2c.j||||yr)r)pAcl dwAceRevision AccessMaskrrs rrz@_win32_restrict_file_to_user_ctypes..AddAccessAllowedAceks $$T=*dKrc ^jd} j||ddj||j syj |j z}j||||j||S#t$r}|jk7rYd}~od}~wwxYwr)r GetFileSecurityWr r8r rr) lpFileNameRequestedInformationnLengthrpSecurityDescriptorrrrrs rrz<_win32_restrict_file_to_user_ctypes..GetFileSecurityps..#   % %$ W%  }}.SetFileSecuritys !!*.BDWXrc.j||||yr)r)r2 bDaclPresentpDaclbDaclDefaultedrs rrzF_win32_restrict_file_to_user_ctypes..SetSecurityDescriptorDacls **+> eUcdrctd}jd}d}jd}d}jd}d}jd}d} jd} j||j||j||j||j|| j|  j |j z}j |j z} j| j}j |j z} j| j}j |j z}j|}j | j z}j|} j||j||j||j|||| j|  |S#t$r} | jk7rYd} ~ jd} ~ wwxYwr) r MakeAbsoluteSDr r8r rrr r)pSelfRelativeSecurityDescriptorpAbsoluteSecurityDescriptor"lpdwAbsoluteSecurityDescriptorSizer7 lpdwDaclSizepSacl lpdwSaclSizepOwner lpdwOwnerSize pPrimaryGrouplpdwPrimaryGroupSizer pDaclData pSaclData pOwnerDatapPrimaryGroupDatarPACLPSIDrrrs rr:z;_win32_restrict_file_to_user_ctypes..MakeAbsoluteSDs'+#-5^^A->*~~a( ~~a(  q)  '~~a0   # #/+ ?@ \* \* ]+ 12  (`x}}7Y7_7_'_&b#7X]]\%7%77:  It,557X]]\%7%77:  It,559hmmm&9&99< Z.GX]]-A-G-GGJ $5t<  + ' LL; <  LL &  LL &    LL- . +*3 zz667 s"A&H H7H22H7c@d}jd} j||j|j |j z}j||j||S#t$r}|jk7rYd}~`d}~wwxYwr)r MakeSelfRelativeSDr r8r rr)r<r;lpdwBufferLengthrrrrrs rrLz?_win32_restrict_file_to_user_ctypes..MakeSelfRelativeSDs+/'#>>!,   ' '+/ -. ,R8==;K;Q;Q+Q*T'## ' + LL) * /. zz667 s"A:: BBBcd}j|}j|j}j|||S)Ni)create_string_bufferr r InitializeAcl) nAclLengthacl_datar*rrIrrs rNewAclz3_win32_restrict_file_to_user_ctypes..NewAclsE ..z:{{8T*33tZ> rr)rintrrrrreturnr)rrrUr)rrrUr)r"rr#rrUr) r*rr+rr,rrrrUr)r/rr0rrUr)r/rr0rr2rrUr) r2rr6rr7rr8rrUr)r;rrUr)r<rrUr)rUr)rrWinDLL Structurec_void_pPOINTERrrerrcheckBOOLrestypec_intLPWSTRPULONGargtypesrr PDWORDrLPDWORDrrr.LPCWSTRr4r:rLrP).rrrr SYNCHRONIZErSTANDARD_RIGHTS_REQUIREDSTANDARD_RIGHTS_READSTANDARD_RIGHTS_WRITEFILE_READ_DATA FILE_READ_EAFILE_READ_ATTRIBUTESFILE_WRITE_DATAFILE_APPEND_DATA FILE_WRITE_EAFILE_WRITE_ATTRIBUTESrrrrPSECURITY_DESCRIPTORrrrrrrrrr:rLrS SidAdminsSidUserAclSelfRelativeSD AbsoluteSDrrrrIrJrrrrs. @@@@@@@@@rrrs}}Z}=HmmIdm;G"$ !L #OK F&"#NLOM.># D!>>(--8 '7G#%-]]G" 'G# ,?IM2C$DEaHG (C\?IF ..7 %U,EFN/Jj!S!4' 3NE4nErcttjt|jjdzS)zRetrieves the file mode corresponding to fname in a filesystem-tolerant manner. Parameters ---------- fname : unicode The path to the file to get mode from i )r5S_IMODErr)rs r get_file_moderws- T%[%%'//069rJUPYTER_ALLOW_INSECURE_WRITESr)true1c#K|rdnd}|rdnd}tjtjztjz} t |j tjdk(ritr tnXtj||d}tj|tjtjz}t|tjtj||d||5}tjdk7r>t|}|dk7r.tr tnd|d t|d }t!||dddy#t $rYwxYw#1swYyxYww) aDOpens a file in the most restricted pattern available for writing content. This limits the file mode to `0o0600` and yields the resulting opened filed handle. Parameters ---------- fname : unicode The path to the file to write binary: boolean Indicates that the file is binary wbwNzutf-8rqi)encodingz0Permissions assignment failed for secure file: 'z'. Got 'z' instead of '0o0600'.)rO_CREATO_WRONLYO_TRUNCrunlinkr8rallow_insecure_writesissue_insecure_write_warningopencloserfdopenrwoct RuntimeError) rbinarymoder~ open_flagfdf file_modemsgs r secure_writersH4sDt7H R[[(2::5I  U   ww$  ) *  62B HHRL bjj0I ' . 2775)V4dX N RS 77d?%e,IF"(02K5'R!!$Y 00FH's++  %    $  sC?E?E#B)E?AE3 E?# E0,E?/E00E?3E<8E?cPdd}|t_tjddy)z Issue an insecure write warning.ct|dzS)N )r()rrkwargss rformat_warningz4issue_insecure_write_warning..format_warningMs3x$rzWARNING: Insecure writes have been enabled via environment variable 'JUPYTER_ALLOW_INSECURE_WRITES'! If this is not intended, remove the variable or set its value to 'False'.rrN)rr(rrrrrUr()r formatwarningr)rs rrrJs',H MM 0 r)F)rr(rrrUr)rr(rNonerU bool | None)rr(rrrUr)rUr)rUr()r;r(rUr)rr(rUr()rr(rUrt)rUrtr)r str | Pathrz Any | NonerUr)r)rrrrrUr)rr(rUr)rr(rUrT)rr(rrrUz Iterator[Any])rUr)E__doc__ __future__rrrrr5rDrMrcollections.abcr contextlibrpathlibrtypingrrrVr;joinrYrerErGrXrr rr$r+r,__annotations__r>rIrPr\rirmrorprr rHr(r site_data_dirrrrurrrsite_config_dirrr/rrrrrrrwgetenvr!rrrrrrrs'# $%   <<7LLHSZZ%:%:?%KGG D+u -  9 9 8 8 S2(!6, '*!B 0" 9:$:#*#77d?'zz~~mT: ww$/"4 GY#GHI8l88 u %    ww$ #()99#E"F #&tCJJ'K#L"M  '   #4 GY#GHI)IUp"$szz5)"DEFF ww$/-Q/9\99 u %  WW_!$'7"CDE,Q/ ! BJ+\&R<<7'N)NAH)XwFt &" "A7KQQSWdd22j r