XhUdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZmZmZmZmZddlZddlmZej.j0Zej4d k(s*ej4d k(rej6j9d sd Znd ZeeddZed?d@dZ edAdZ d?dBdZ dCdZ!dDdZ"iZ#de$d<dEdZ%dCdZ&dFdZ'dDdZ(dDdZ)dDdZ*e dZ+de$d <dZ,d!e$d"<ejZd#k(re+rej\j_d$dZ,e!r\ejZd#k(re+se0e ej6d%d gZ1nsejdedd&'jgejhZ1nDed(ejZd#k(r)e,r ee,d gZ1n e0e ej6d%d gZ1nd)d*gZ1e0e ej6d%d gZ5d+e$d,<dGd-Z6e0e ej6d.d gZ7d+e$d/<e!rFejZd#k(re+se7ddZ8n[ejredd&'jgejhZ8n,ejZd#k(re,re0e e,d gZ8n e7ddZ8nd0d1gZ8dHd2Z:dEd3Z;dIdJd4Zne=Z>dKdLd6Z?dMd7Z@dMd8ZAdNd9ZBejd:d;jdZGy)QzPath utility functions.) annotationsN)contextmanager)Path)AnyIteratorLiteralOptionaloverload) deprecationwin32darwinz /opt/homebrewJupyterjupyter UF_HIDDENiFboolcyNnamedefaults F/var/www/html/myenv/lib/python3.12/site-packages/jupyter_core/paths.pyenvsetr)s69cyrrrs rrr-sADrcp|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 rrr1s3 2:: ::d  ! ! #+R RRrctddS)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. 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/Hs.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-existsparentownerr#getlogin Exceptionhasattrstatst_uidr2NotImplementedErrorOSErroraccessW_OK)pathpsts r _do_i_ownrBSs 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) r#r$rsysprefix base_prefixrB startswithgetrrrprefer_environment_over_userrMns!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. -)rI)r0KeyErrortempfilemkdtemp)rds r _mkdtemp_oncerTsB 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) r#r$rLrTr( 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_DIRFrXrLibraryrr APPDATANrdata XDG_DATA_HOMEz.localshare)r#r$rLr(rZ user_data_dirr\r/rHplatformr,rr-r]r`)r^homeappdataxdgs rjupyter_data_dirrms **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)r#r$rLr]rm)r^s rjupyter_runtime_dirrqs7 **C ww$%()) !#Y //rJUPYTER_USE_PROGRAMDATA_use_programdataz str | None_win_programdatant PROGRAMDATArgT)rY 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` v6z/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%ywrrstripr#sep.0r@s r zjupyter_path..+s\!QXXbff%\)+ getuserbasergr)r#r$rLextendsplitpathseprmsiteENABLE_USER_SITEr8r USER_BASEr,rappendrySYSTEM_JUPYTER_PATHrMr])subdirspathsuseruserbaseuserdirr^r@_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'] rVJUPYTER_CONFIG_PATHc3ZK|]#}|jtj%ywrr}rs rrz&jupyter_config_path..sc!QXXbff%crrrr)r#r$rLr`rrrrrr8rrr,rrrSYSTEM_CONFIG_PATHrM)rrrrr^r@s rjupyter_config_pathrmsJ2 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)r#lstatr<)r?s rr3r3s+   s  $$czt|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) rrrKr9r<errnoENOENTst_file_attributesFILE_ATTRIBUTE_HIDDENAttributeErrorwarningswarnabs_pathstat_reses ris_file_hidden_winrs  H~%%c* H~**,H   ' '(( ) ) ) ww%,,&      b  s/A#B# B,BBB B:9B:ct|jjdry|tj|j r t|j}tj|j r6tj|tjtjzsyt|ddtzryy#t $r(}|jtjk(rYd}~yd}~wwxYw)rrTNFst_flagsr)rrrKr9S_ISLNKst_moder<rrS_ISDIRr#r=X_OKR_OKgetattrrrs ris_file_hidden_posixrs  H~%%c*4<<(8(89 H~**,H ||H$$%yy277RWW#45xQ')3  ww%,,&  sC C=C87C88C=c6tjj|}tjj|}||k(ryt|ry|s4|j tj ddtj z}|t |d}tdt|jDrytt|j}|r|j|r||k7rt|jstt|j}P tj|}t!|ddt"zrytt|j}|r|j|r||k7ry#t$rYywxYw)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 : unicode The absolute path to check for hidden directories. abs_root : unicode The absolute path of the root directory in which hidden directories should be checked for. FTr rNc3>K|]}|jdyw)rN)rK)rparts rrzis_hidden..8s DD4??3  Dsr)r#r?normpathis_file_hiddenrrlenanyrpartsr,r4rKr3rr<rr)rabs_root inside_rootr?rAs r is_hiddenrsQ(ww)Hww)H8h >>"&&!,Q/"&&83x=?+K DD,=,C,C DD tH~$$ %D 4??8,1ADz  "tDz(()D  $B 2z1 % 14:$$% 4??8,1A    s*F FFcn 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 rNr )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_userrNs :  - -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_errorsecur32rziiiir iceZdZdWjfdWjfdWjfdWjfdWjfgZy)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_charDWORDrbyrefr<winerrorvalue)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_ulongGetUserNameExWr<r contentsr create_unicode_buffer) NameFormatnSizer lpNameBufferERROR_MORE_DATArrs rrz:_win32_restrict_file_to_user_ctypes..GetUserNameEx/sv~~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 ) rLookupAccountNameWrr<r rr castrLPVOIDr) lpSystemName lpAccountNamer cchReferencedDomainNamepeUserSidr lpReferencedDomainNamesuccessrrrrs rrz>_win32_restrict_file_to_user_ctypes..LookupAccountName>s[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 AccessMaskr rs rrz@_win32_restrict_file_to_user_ctypes..AddAccessAllowedAceas $$T=*dKrc ^jd} j||ddj||j syj |j z}j||||j||S#t$r}|jk7rYd}~od}~wwxYwr)rGetFileSecurityWrr<r r r) lpFileNameRequestedInformationnLengthrpSecurityDescriptorrrrrs rrz<_win32_restrict_file_to_user_ctypes..GetFileSecurityfs..#   % %$ W%  }}.SetFileSecuritys !!*.BDWXrc.j||||yr)r)r. 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) rMakeAbsoluteSDrr<r rr rr)pSelfRelativeSecurityDescriptorpAbsoluteSecurityDescriptor"lpdwAbsoluteSecurityDescriptorSizer3 lpdwDaclSizepSacl lpdwSaclSizepOwner lpdwOwnerSize pPrimaryGrouplpdwPrimaryGroupSizer pDaclData pSaclData pOwnerDatapPrimaryGroupDatarPACLPSIDrrrs rr6z;_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)rMakeSelfRelativeSDrr<r rr )r8r7lpdwBufferLengthrrrrrs rrHz?_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_bufferrr InitializeAcl) nAclLengthacl_datar&rrErrs rNewAclz3_win32_restrict_file_to_user_ctypes..NewAclsE ..z:{{8T*33tZ> rr)rintrrrrreturnr)r rrQr)rrrQr)rrrrrQr) r&rr'rr(rr rrQr)r+rr,rrQr)r+rr,rr.rrQr) r.rr2rr3rr4rrQr)r7rrQr)r8rrQr)rQr)rrWinDLL Structurec_void_pPOINTERrrerrcheckBOOLrestypec_intLPWSTRPULONGargtypesrrPDWORDrLPDWORDrrr*LPCWSTRr0r6rHrL).rrrr SYNCHRONIZErSTANDARD_RIGHTS_REQUIREDSTANDARD_RIGHTS_READSTANDARD_RIGHTS_WRITEFILE_READ_DATA FILE_READ_EAFILE_READ_ATTRIBUTESFILE_WRITE_DATAFILE_APPEND_DATA FILE_WRITE_EAFILE_WRITE_ATTRIBUTESrrrrPSECURITY_DESCRIPTORrrrrrrrrr6rHrO SidAdminsSidUserAclSelfRelativeSD AbsoluteSDrrrrErFrrrrs. @@@@@@@@@rrrzs}}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 )r9S_IMODErr)rs r get_file_moderss- 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-8rui)encodingz0Permissions assignment failed for secure file: 'z'. Got 'z' instead of '0o0600'.)r#O_CREATO_WRONLYO_TRUNCrunlinkr<rallow_insecure_writesissue_insecure_write_warningopencloserfdopenrsoct RuntimeError) rbinarymoderz open_flagfdf file_modemsgs r secure_writer sH4sDt7H 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_warningCs3x$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,rrrrrQr,)r formatwarningr)rs rrr@s',H MM 0 r)F)rr,rrrQr)rr,rz Literal[None]rQOptional[bool])rr,rrrQr)rQr)rQr,)r?r,rQr)rr,rQr,)rr,rQrx)rQrxr)rr,rz Optional[Any]rQr)r)rr,rr,rQr)rr,rQNone)rr,rQrP)rr,rrrQz Iterator[Any])rQr)H__doc__ __future__rrr#rr9rHrQr contextlibrpathlibrtypingrrrr r rZutilsr r?joinr]rirIrKr\rrrr(r/r0__annotations__rBrMrTr`rmrqrsrtrr$rLr,r site_data_dirrrryrrrsite_config_dirrr3rrrrrrrsgetenvr%rrrrrrrs8# %==  <<7LLHSZZ%:%:?%KGG D+u -  9 9 D D S2(!6, '*!> 0" 9:$:#*#77d?'zz~~mT: ww$/"4 GY#GHI8l88 u %   K ww$ #()99#E"F #&tCJJ'K#L"M  '   #4 GY#GHI)IUp"$szz5)"DEFF ww$/-Q/9\99 u %  WW_!$'7"CDE,Q/ ! BJ*Z%P<<7'N)N3l)XwFt &" "A7KQQSWdd22j r