jטUdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZddlmZmZddlZejjZejdks%ejd krejd sd Znd Zeed dZedOdPdZedQdZdOdRdZdSdZdTdZiZ de!d<dUdZ"dSd Z#dVd!Z$dTd"Z%dTd#Z&dTd$Z'ed%Z(de!d&<dZ)d'e!d(<ej*d)kre(rej+,d*dZ)erVej*d)kre(se-eejd+d gZ.nhej/edd,-0ej1Z.nZ9dYdZd?Z:ejdkre9Z;ne:Z;d[d\dBZd^dGZ?ej@dHdIAdJvZBe dOd_dMZCd`dNZDdS)azPath utility functions.) annotationsN)Iterator)contextmanager)Path)Anyoverloadwin32darwinz /opt/homebrewJupyterjupyter UF_HIDDENiFnamestrdefaultboolreturncdSNrrs _/var/www/finuniver-perm.ru/html/student/venv/lib/python3.11/site-packages/jupyter_core/paths.pyenvsetr(s69cNone bool | NonecdSrrrs rrr,s58Srcn|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)osenvironlowerrs rrr0s5 2: :d  ! ! # #+R RRrc"tddS)zcDetermine if platformdirs should be used for system-specific paths. The default is False. JUPYTER_PLATFORM_DIRSF)rrrruse_platform_dirsr(>s )5 1 11rctd}tt|S)z'Get the real path of the home directory~)r expanduserrresolve)homedirs r get_home_dirr.Fs;3ii""$$G tG}}$$&& ' ''rzdict[str, str]_dtempspathc:t|}|s1||jkr&|j}|s ||jk& |t jkS#t$rYnwxYwtt drH | }|j t j kS#ttf$rYnwxYwt j|t jS)z3Return whether the current user owns the given pathgeteuid)rr,existsparentownerr#getlogin Exceptionhasattrstatst_uidr2NotImplementedErrorOSErroraccessW_OK)r0psts r _do_i_ownrAQs  T AhhjjQ!(]] HhhjjQ!(]]  wwyyBKMM))      r9 B9 , ,#W-    D  9Q  s$((B BB7/C''C;:C;cdtjvrtdStjtjkrt tjrdSdtjvrntjtjdr?tjdddkrt tjrdSdS)zRDetermine if environment-level paths should take precedence over user-level paths.JUPYTER_PREFER_ENV_PATHT CONDA_PREFIXCONDA_DEFAULT_ENVbaseF) r#r$rsysprefix base_prefixrA startswithgetrrrprefer_environment_over_userrLls!BJ../000 zS_$$3:)>)>$t "*$$ J ! !"*^"< = = % JNN. 7 76 A A cj ! ! Bt 5rc 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. -)rH)r/KeyErrortempfilemkdtemp)rds r _mkdtemp_oncerSsU t} $,D3J????GDMs .AAc*tj}|drtdS|dr|dSt rt jtdSt}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$rKrSr( platformdirsuser_config_dirAPPNAMEr.pjoin)envhome_dirs rjupyter_config_dirr_s *C ww"##20111 ww#$$)'((F+GuEEEE~~H : & &&rctj}|dr|dStrt jt dSt}tj dkrtt|ddStj dkrmtjdd }|r/tt|d  Sttd S|d d }|st|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_DIRFrWr Libraryr r APPDATANr data XDG_DATA_HOMEz.localshare)r#r$rKr(rY user_data_dirr[r.rGplatformrrr,r\r_)r]homeappdataxdgs rjupyter_data_dirrls$ *C ww!""'%&&D)'UCCCC >>D |x4i33444 |w*..D11  ;tGY//7799:: :'))6222 ''/4 ( (C -D(G,, i  rctj}|dr|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$rKr\rl)r]s rjupyter_runtime_dirrpsC *C ww$%%*()) !##Y / //rJUPYTER_USE_PROGRAMDATA_use_programdataz str | None_win_programdatant PROGRAMDATArfT)rX multipathz/usr/local/share/jupyterz/usr/share/jupyter list[str]ENV_JUPYTER_PATHsubdirscpg}tjdrL|dtjdtjDt g}tjrmttdrtj n tj }|r7tt|dd}||vr||tt krt}ndtD}t#r+||||n*||||t D]}||vr||rfd|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_PATHc3TK|]#}|tjV$dSrrstripr#sep.0r?s r zjupyter_path..%s0\\!QXXbf%%\\\\\\r getuserbaserfr c$g|] }|tv |Sr)SYSTEM_JUPYTER_PATHrs r z jupyter_path..:s#KKKQa7J.J.Jq.J.J.Jrc*g|]}t|gRSr)r\)rr?rys rrz jupyter_path..Js)333q#7###333r)r#r$rKextendsplitpathseprlsiteENABLE_USER_SITEr8r USER_BASErrappendrxrrL)rypathsuseruserbaseuserdirr]_paths` r jupyter_pathrsVE z~~n%%] \\rz./I/O/OPRPZ/[/[\\\\\\    D  %*1})E)EY4#%%%4>  %$x)<<==Gd"" G$$$ ...KK*KKK#%% S T T S%      LL   43333U333 LretcENV_CONFIG_PATHz/usr/local/etc/jupyterz /etc/jupyterctjdrtgSg}tjdrL|dtjdtjDtg}tjrmttdrtj n tj }|r7tt|dd}||vr||tt krt}ndtD}t#r+||||n*||||tt kr|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'] rUJUPYTER_CONFIG_PATHc3TK|]#}|tjV$dSrr}rs rrz&jupyter_config_path..s0cc!QXXbf%%ccccccrrrr c$g|] }|tv |Sr)SYSTEM_CONFIG_PATHrs rrz'jupyter_config_path..s#IIIQQ6H-H-Hq-H-H-Hr)r#r$rKr_rrrrrr8rrrrrrrrL)rrrrr]s rjupyter_config_pathrgs2 z~~)**&"$$%%E z~~+,,d ccrz:O/P/V/VWYWa/b/bcccccc  !D  %*1})E)EY4#%%%4>  %$x ::;;Gd"" G$$$ ,,,II/III#%% S T T S,,, '((( LrcT tj|n#t$rYdSwxYwdS)zcReplacement for `os.path.exists` which works for host mapped volumes on Windows containers FT)r#lstatr<)r0s rr3r3s=  uu 4s  %%abs_path str | Pathstat_res Any | Nonec~t|}|jdrdS|Q t|}n.#t$r!}|jt jkrYd}~dSd}~wwxYw |jtjzrdSn&#t$rtj ddYnwxYwdS)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) rrrJr9r<errnoENOENTst_file_attributesFILE_ATTRIBUTE_HIDDENAttributeErrorwarningswarnrres ris_file_hidden_winrs H~~H}$$t H~~**,,HH   w%,&&uuuuu     '( ) 4        b        5s/!A A<A76A77A<B B:9B:ct|}|jdrdS|tj|jrD |}n.#t $r!}|jtjkrYd}~dSd}~wwxYwtj |jr.tj |tj tj zsdSt|ddtzrdSdS)rrTNFst_flagsr)rrrJr9S_ISLNKst_moder<rrS_ISDIRr#r=X_OKR_OKgetattrr rs ris_file_hidden_posixrs H~~H}$$t4<(899 }}HH   w%,&&uuuuu    |H$%%y27RW#455 4xQ'')3t 5sA B'BBBabs_rootc`ttj|}|r-ttj|}nt |jd}||krdS|sd|d}t||sd|d}t|||sd|d|d}t|t|rd S| |}td |j Drd S|jD]c}| s||krnE |}n#t$rYd SwxYwt!|d d t"zrd SddS) 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|]}|dVdS)rN)rJ)rparts rrzis_hidden..Cs. @ @D4??3   @ @ @ @ @ @rrr)rr#r0normpathlistparents is_absolute ValueErroris_relative_tois_file_hidden relative_toanypartsr3rr<rr )rr_msg relative_pathr4r@s r is_hiddenrs(BG$$X..//H.((2233())"-8u    ! !I(III    ! !I(III  " "8 , , bx b bH b b b ht((22M @ @M,? @ @ @@@t"  }}   X   E BB   444  2z1 % % 1 44  5s*E?? F Ffnamec` ddl}n#t$rt|cYSwxYwddl}ddl}||j}|d||j \}}}| ||j }| } | |j|j|jz|jz|| |j|j||d| d|||j |dS)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) rrconradminsr_domain_typesddacls rwin32_restrict_file_to_userrXs_: :::2599999:  - -m.W X XF(:: H " "8#= > >D'5  & &um.U V VB     D"  66C   ]79LfUUU  D!,,,!!%)PRTUUU 4s ##c 6%&'()*+,-ddl+ddlm-+dd*+dd,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}d;+fd }|,j_-j ,j_ +j -j -j f,j_|*j_-j *j_ -j))-jf*j_|*j_-j *j_ -j -j )-j-j -j-jf*j_|*j_-j *j_ (-j-j)f*j_|*j_-j *j_ |-j (-j f*j_|*j_-j *j_ -j-j|-j-jf*j_|*j_-j *j_ -j-j|f*j_|*j_-j *j_ ||-j(-j(-j)-j)-jf *j_|*j_-j *j_ ||-jf*j_|*j_-j *j_ (-j-jf*j_d<&*+-fd! }d='+,fd# }d>&*+-fd& }d?*fd+ }d@&*+-fd. }dA*fd0 }dB*fd4 }dC&()*+-fd6 }dD&*+-fd8 }dE%(*+fd9 }||} |d:||d}!|}"||"%|| ||"%||z|z|!|||}#||#}$||$d|"d||$}#||||#dS)FaSecure 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_errorsecur32rziiiiricdeZdZdjfdjfdjfdjfdjfgZdS)0_win32_restrict_file_to_user_ctypes..ACL AclRevisionSbz1AclSizeAceCountSbz2N)__name__ __module__ __qualname__BYTEWORD_fields_rsrrrsH HM * X] #  &  ' X] #  rrresultintfuncrargsrcZ|s'|Sr)WinErrorget_last_error)r r r ctypess r_nonzero_successz=_win32_restrict_file_to_user_ctypes.._nonzero_successs. ;//&"7"7"9"9:: : rWellKnownSidTypec jdz}} |d||ne#t$rX}|jkrj|jz}|d||Yd}~nd}~wwxYw|ddS)Nr)c_charDWORDrbyrefr<winerrorvalue)rpSidcbSidrERROR_INSUFFICIENT_BUFFERrrrs rrz?_win32_restrict_file_to_user_ctypes..CreateWellKnownSid,s! !$$   [  ' '(8$fllSXFYFY Z Z Z Z [ [ [z666/FMEK/22D  ' '(8$fllSXFYFY Z Z Z Z Z Z Z Z  [ AAAws+A B7AB22B7 NameFormatcbd} |d|n##t$r}|jkrYd}~nd}~wwxYw|jjsdS|jj}||||jSNr)pointerc_ulongGetUserNameExWr<rcontentsrcreate_unicode_buffer)rnSizer lpNameBufferERROR_MORE_DATArrs rrz:_win32_restrict_file_to_user_ctypes..GetUserNameEx9sv~~a0011   " ":tU ; ; ; ;   z_,,-,,,, ~# 433EN4HII z<???!!sA A# AA# lpSystemName lpAccountNamec 4 d} d} d} ||d |d | |n##t$r}|j krYd}~nd}~wwxYw d|j}  | j } d|jdz} ||| || | |} | s ||j|jfS)Nrrr) rLookupAccountNameWrr<rr#rcastrLPVOIDr)r'r(rcchReferencedDomainNamepeUserSidrlpReferencedDomainNamesuccessrrrrs rrz>_win32_restrict_file_to_user_ctypes..LookupAccountNameHsq!!"*.."3"3q!!   ' ' U## 455 U##       z66676666 **2u{;;{{6>>#..@@!'!=!=bBYB_bcBc!d!d--    LL   " LL0 1 1 LL     $//## #+15;>>sAB B7! B22B7pAcl dwAceRevision AccessMaskrc8||||dSr)r)r2r3r4rrs rrz@_win32_restrict_file_to_user_ctypes..AddAccessAllowedAceks% $$T=*dKKKKKr lpFileNameRequestedInformationc ld} ||dd|n##t$r}|jkrYd}~nd}~wwxYw|jsdSj|jz}||||||Sr)rGetFileSecurityWrr<rrr) r6r7nLengthrpSecurityDescriptorrrrrs rrz<_win32_restrict_file_to_user_ctypes..GetFileSecurityps..##   % %$ W%%        z66676666 } 4.SetFileSecuritys% !!*.BDWXXXXXr bDaclPresentpDaclbDaclDefaultedc8||||dSr)r)r;r>r?r@rs rrzF_win32_restrict_file_to_user_ctypes..SetSecurityDescriptorDacls' **+> eUcdddddrpSelfRelativeSecurityDescriptorcd}d}d}d}d}d}d}d}d} d} |||||||||| |  n##t$r} | jkrYd} ~ nd} ~ wwxYwj|jz}j|jz} | j}j|jz} | j}j|jz}|}j| jz}|} |||||||||| |  |Sr) rMakeAbsoluteSDrr<rrrr+r")rBpAbsoluteSecurityDescriptor"lpdwAbsoluteSecurityDescriptorSizer? lpdwDaclSizepSacl lpdwSaclSizepOwner lpdwOwnerSize pPrimaryGrouplpdwPrimaryGroupSizer pDaclData pSaclData pOwnerDatapPrimaryGroupDatarPACLPSIDrrrs rrDz;_win32_restrict_file_to_user_ctypes..MakeAbsoluteSDsz'+#-5^^A->->*~~a(( ~~a((  q))  '~~a00   # #/+ ?@@ \** \** ]++ 122       z66676666 (`x}7Y7_'_&b&b#7X]\%77::  It,,57X]\%77::  It,,59hmm&99<< Z..GX]-A-GGJJ $5t<<  + ' LL; < <  LL & &  LL & &    LL- . . +*s6A>C55 D? DDrEcVd}d} |||n##t$r}|jkrYd}~nd}~wwxYwj|jz}||||Sr)rMakeSelfRelativeSDrr<rrr)rErBlpdwBufferLengthrrrrrs rrUz?_win32_restrict_file_to_user_ctypes..MakeSelfRelativeSDs+/'#>>!,,   ' '+/ -..        z66676666 ,R8=;K;Q+Q*T*T'## ' + LL) * *   /.s*A A% A  A%cd}|}|j}|||S)Ni)create_string_bufferr+r" InitializeAcl) nAclLengthacl_datar2rrRrrs rNewAclz3_win32_restrict_file_to_user_ctypes..NewAclsN ..z::{{8T**3tZ>>> rr)r r r rr rrr)rrrr)rrrr)r'rr(rrr) r2rr3rr4rrrrr)r6rr7rrr)r6rr7rr;rrr) r;rr>rr?rr@rrr)rBrrr)rErrr)rr)rrWinDLL Structurec_void_pPOINTERrr!errcheckBOOLrestypec_intLPWSTRPULONGargtypesrrPDWORDr*LPDWORDrrr9LPCWSTRr=rDrUrY).rrrr SYNCHRONIZErSTANDARD_RIGHTS_REQUIREDSTANDARD_RIGHTS_READSTANDARD_RIGHTS_WRITEFILE_READ_DATA FILE_READ_EAFILE_READ_ATTRIBUTESFILE_WRITE_DATAFILE_APPEND_DATA FILE_WRITE_EAFILE_WRITE_ATTRIBUTESrrrrPSECURITY_DESCRIPTORrrrrrrrrrDrUr\ SidAdminsSidUserAclSelfRelativeSD AbsoluteSDrrr&rRrSrrrrs. @@@@@@@@@rrrsMMM}}Z}==HmmIdm;;G"$ !L #OK F&"#NLOM.>#  D!>>(-88 '7G#%-]G" 'G# ,??IMM2C$D$DEEaHG &((C\?IFFF ..7 %_U,EFFN//Jj!S!444'' 33NOE4nEEEEErr cxtjt|jdzS)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_moder~s0 T%[[%%''/0069rJUPYTER_ALLOW_INSECURE_WRITESr )true1binary Iterator[Any]c#K|rdnd}|rdnd}tjtjztjz} t |n#t $rYnwxYwtjdkrhtrtnRtj ||d}tj |tjtjz}t|tj tj ||d||5}tjdkrPt|}|dkr;trtn%d|d t|d }t!||VddddS#1swxYwYdS) 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-8rti)encodingz0Permissions assignment failed for secure file: 'z'. Got 'z' instead of '0o0600'.)r#O_CREATO_WRONLYO_TRUNCrunlinkr<rallow_insecure_writesissue_insecure_write_warningopencloserfdopenr~oct RuntimeError) rrmoder open_flagfdf file_modemsgs r secure_writers "44sD*tt7H R[(2:5I  U        w$ / ) * * * *  622B HRLLL bj0I ' . . . 275)V44dX N N N RS 7d??%e,,IF""(,02222H5HH!$YHHH's+++                  s$!A A%$A% A%E==FFcRd d}|t_tjdd d S) z Issue an insecure write warning.rrr rkwargsrc&t|dzS)N )r)rr rs rformat_warningz4issue_insecure_write_warning..format_warningMs3xx$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)rrr rrrrr)r formatwarningr)rs rrrJsM,H M 0 r)F)rrrrrr)rrrrrr)rrrrrr)rr)rr)r0rrr)rrrr)ryrrrw)rrwr)rrrrrr)r)rrrrrr)rrrr)rrrr )rrrrrr)rr)E__doc__ __future__rrr#rr9rGrPrcollections.abcr contextlibrpathlibrtypingrrrYr0joinr\rhrHrJr[rr rr(r.r/__annotations__rArLrSr_rlrprrrsrr$rKrr site_data_dirrrrxrrrsite_config_dirrr3rrrrrrr~getenvr%rrrrrrrs#""""" $$$$$$%%%%%%   <7LHSZ%:%:?%K%KGGG GD+u - -  9999 9 888 8 S S S S S2222((((!!!!6,    ''''*!!!!B 0 0 0 0"  9::::::#####7d??'?z~~mT::  w$/"s44 GY#G#GHHI8l8 u   %     w$  N#(5)99#E#E"F  #&3ttCJ'K'K#L#L"M   '   #s44 GY#G#GHHIIIIIUUUUp"c$$sz5)"D"DEEFFFFF w$/-QQQ/9\9 u   %   W__0!c$$'7"C"CDDE,QQQ/ ! BBBBJ+++++\&&&&&R<7'NN)NAAAAAH))))XwFwFwFwFt &" "A7KKQQSSWdd22222j      r