o i @sUdZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z mZmZmZmZddlZddlmZejjZejdvrNd nd Zeed d ZdSdedeedeefddZdefddZdefddZ iZ!eeefe"d<dedefddZ#defddZ$dedefddZ%defdd Z&defd!d"Z'defd#d$Z(erej)ed d%d&*ej+Z,n(ed'ej-d(krej./d)dZ0e0ree0d gZ,nejej1d*d gZ,nd+d,gZ,ejej1d*d gZ2eee"d-<d.edeefd/d0Z3erej4ed d%d&*ej+Z5n ej-d(kr,ej./d)dZ0e0r)eje0d gZ5ngZ5nd1d2gZ5ejej1d3d gZ6eee"d4<deefd5d6Z7dedefd7d8Z8dTd9ed:ee defd;d<Z9dTd9ed:ee defd=d>Z:ejd?krwe9Z;ne:Z;dUd9edAedefdBdCZdDede?fdIdJZ@eAdKdLBdMvZCe dSdDedNedee fdOdPZDdVdQdRZEdS)WzPath utility functions.N)contextmanager)Path)AnyDictIteratorListOptional) deprecation)win32darwinJupyterjupyter UF_HIDDENiFnamedefaultreturncCs |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)rrrM/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/jupyter_core/paths.pyenvset$s rcCs 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. JUPYTER_PLATFORM_DIRSF)rrrrruse_platform_dirs2s rcCs tjd}tt|}|S)z'Get the real path of the home directory~)rpath expanduserstrrresolve)homedirrrr get_home_dir;s r&_dtempsr!c 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_ownGs"   r7cCsldtjvr tdStjtjkrttjrdSdtjvr4tjtjdr4tjdddkr4ttjr4dSdS)zRDetermine if environment-level paths should take precedence over user-level paths.JUPYTER_PREFER_ENV_PATHT CONDA_PREFIXCONDA_DEFAULT_ENVbaseF) rrrsysprefix base_prefixr7 startswithgetrrrrprefer_environment_over_userbs  rAcCs: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_oncexs   rGcCsNtj}|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) rrr@rGr platformdirsuser_config_dirAPPNAMEr&pjoin)envhome_dirrrrjupyter_config_dirs   rRcCstj}|dr |dStrtjtddSt}tj dkr&tj |ddStj dkrCtjdd }|r=t t|d Sttd 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_DIRFrJr Libraryr ntAPPDATANrdata XDG_DATA_HOMEz.localshare)rrr@rrL user_data_dirrNr&r<platformr!joinrr#rr$rOrR)rPhomeappdataxdgrrrjupyter_data_dirs"       r`cCs$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)rrr@rOr`)rPrrrjupyter_runtime_dirs  rcT)rK 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` v6rU PROGRAMDATArYz/usr/local/share/jupyterz/usr/share/jupyterENV_JUPYTER_PATHsubdirscsg}tjdr|ddtjdtjDtg}tjr?t tdr)t ntj }|r?tj |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'] JUPYTER_PATHcs|] }|tjVqdSNrstriprsep.0r5rrr zjupyter_path.. getuserbaserYrcSg|]}|tvr|qSr)SYSTEM_JUPYTER_PATHrnrrr z jupyter_path..csg|] }t|gRqSr)rOrnrgrrrus)rrr@extendsplitpathsepr`siteENABLE_USER_SITEr.rr USER_BASEr!r\appendrfrArt)rgpathsuseruserbaseuserdirrPrrwr jupyter_paths( "      rz/usr/local/etc/jupyterz /etc/jupyteretcENV_CONFIG_PATHcCstjdr tgSg}tjdr#|ddtjdtjDtg}tjrIt tdr3t ntj }|rItj |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. rHJUPYTER_CONFIG_PATHcsrirjrkrnrrrrpFrqz&jupyter_config_path..rrrrcSrsr)SYSTEM_CONFIG_PATHrnrrrruUrvz'jupyter_config_path..)rrr@rRrxryrzr{r|r.rrr}r!r\r~rrAr)rrrrrPrrrjupyter_config_path4s(  "      rcCs&zt|WdStyYdSw)zcReplacement for `os.path.exists` which works for host mapped volumes on Windows containers FT)rlstatr2)r!rrrr)cs   r)abs_pathstat_resc Cstj|dr dS|dur1zt|}Wnty0}z|jtjkr+WYd}~dSd}~wwz |jtj @r;WdSWdSt yLt dYdSw)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.) rr!basenamer?r/r2errnoENOENTst_file_attributesFILE_ATTRIBUTE_HIDDENAttributeErrorwarningswarnrrerrris_file_hidden_winns.   rc Cstj|dr dS|dust|jr7zt|}Wnty6}z|jtj kr1WYd}~dSd}~wwt |jrIt |tj tj BsIdSt|ddt@rSdSdS)rrTNFst_flagsr)rr!rr?r/S_ISLNKst_moder2rrS_ISDIRr3X_OKR_OKgetattrrrrrris_file_hidden_posixs"  rr abs_rootcCstj|}tj|}||krdSt|rdS|s&|tjddtj}|t|d}tdd|tjDr=dStj|}|r| |r||krt |sYtj|}qCzt |}Wn t yjYdSwt |ddt@rudStj|}|r| |r||ksNdS) 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 rNcss|]}|dVqdS)rN)r?)ropartrrrrpszis_hidden..r)rr!normpathis_file_hiddenryrmlenanydirnamer?r)rr2rr)rr inside_rootr!r6rrr is_hiddens4       rfnamec Cszddl}Wn tyt|YSwddl}ddl}||j}|d||j \}}}| ||j }| } | |j|j|jB|jB|| |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 rNrr )win32api ImportError#_win32_restrict_file_to_user_ctypes ntsecuritycon win32securityCreateWellKnownSidWinBuiltinAdministratorsSidLookupAccountName GetUserNameExNameSamCompatibleGetFileSecurityDACL_SECURITY_INFORMATIONACLAddAccessAllowedAce ACL_REVISIONFILE_GENERIC_READFILE_GENERIC_WRITEDELETEFILE_ALL_ACCESSSetSecurityDescriptorDaclSetFileSecurity) rrconradminsr_domain_typesddaclrrrwin32_restrict_file_to_users*      rc% sddlddlmjdddjdddd}d }d }dd d d }d}d}d}d}d} d} d} d} d } d}d}||BdB}|| B| B| B|B}|| B|B|B| B|B}Gfdddj}j|j}fdd}|j_j j_ j j j fj_|j_j j_ jjfj_|j_j j_ j j jj jjfj_|j_j j_ jjfj_|j_j j_ |j j fj_|j_j j_ jj|jjfj_|j_j j_ jj|fj_|j_j j_ ||jjjjjf j_|j_j j_ ||jfj_|j_j j_ jjfj_fdd}fdd}fdd }fd!d"}fd#d$}fd%d&}fd'd(}fd)d*}fd+d,}fd-d.}||} |d/||d}!|}"||"|| ||"||B|B|!|||}#||#}$||$d|"d||$}#||||#dS)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_errorsecur32ziiiir ics8eZdZdjfdjfdjfdjfdjfgZdS)z0_win32_restrict_file_to_user_ctypes..ACL AclRevisionSbz1AclSizeAceCountSbz2N)__name__ __module__ __qualname__BYTEWORD_fields_rrrrr\srcs|s |Srj)WinErrorget_last_error)resultfuncargs)ctypesrr_nonzero_successisz=_win32_restrict_file_to_user_ctypes.._nonzero_successc sjd}}z |d||Wn*tyA}z|jkr%j|j}|d||WYd}~nd}~ww|ddS)Nr )c_charDWORDrbyrefr2winerrorvalue)WellKnownSidTypepSidcbSidrERROR_INSUFFICIENT_BUFFERrrrrrrs  " z?_win32_restrict_file_to_user_ctypes..CreateWellKnownSidc sd}z |d|Wnty)}z |jkrWYd}~nd}~ww|jjs0dS|jj}||||jSNr)pointerc_ulongGetUserNameExWr2rcontentsrcreate_unicode_buffer) NameFormatnSizer lpNameBuffer)ERROR_MORE_DATArrrrrs  z:_win32_restrict_file_to_user_ctypes..GetUserNameExc sd}d}d}z||d|d||Wnty=}z |jkr3WYd}~nd}~wwd|j}|j }d|jd}|||||||} | sr ||j|jfS)Nrrr ) rLookupAccountNameWrr2rrrcastrLPVOIDr) lpSystemName lpAccountNamercchReferencedDomainNamepeUserSidrlpReferencedDomainNamesuccessrrrrsD      z>_win32_restrict_file_to_user_ctypes..LookupAccountNamec||||dSrj)r)pAcl dwAceRevision AccessMaskrrrrrsz@_win32_restrict_file_to_user_ctypes..AddAccessAllowedAcec sd}z||dd|Wnty+}z |jkr!WYd}~nd}~ww|js1dSj|j}||||||Sr)rGetFileSecurityWrr2rrr) lpFileNameRequestedInformationnLengthrpSecurityDescriptorrrrrs4   z<_win32_restrict_file_to_user_ctypes..GetFileSecuritycs|||dSrj)SetFileSecurityW)r r rr rrr-sz<_win32_restrict_file_to_user_ctypes..SetFileSecuritycrrj)r)r bDaclPresentpDaclbDaclDefaultedr rrr1szF_win32_restrict_file_to_user_ctypes..SetSecurityDescriptorDaclcsld}d}d}d}d}d}d}d}d} d} z |||||||||| |  Wnty[} z | jkrQWYd} ~ nd} ~ wwj|j}j|j} | j}j|j} | j}j|j}|}j| j}|} |||||||||| |  |Sr) rMakeAbsoluteSDrr2rrrrr)pSelfRelativeSecurityDescriptorpAbsoluteSecurityDescriptor"lpdwAbsoluteSecurityDescriptorSizer lpdwDaclSizepSacl lpdwSaclSizepOwner lpdwOwnerSize pPrimaryGrouplpdwPrimaryGroupSizer pDaclData pSaclData pOwnerDatapPrimaryGroupData)rPACLPSIDrrrrrr5sj          z;_win32_restrict_file_to_user_ctypes..MakeAbsoluteSDc s~d}d}z |||Wnty+}z |jkr!WYd}~nd}~wwj|j}||||Sr)rMakeSelfRelativeSDrr2rrr)rrlpdwBufferLengthrrrrr%ks*   z?_win32_restrict_file_to_user_ctypes..MakeSelfRelativeSDcs.d}|}|j}|||S)Ni)create_string_bufferrr InitializeAcl) nAclLengthacl_datar)rr#rrrrNewAcls  z3_win32_restrict_file_to_user_ctypes..NewAclr)rrWinDLL Structurec_void_pPOINTERrrerrcheckBOOLrestypec_intLPWSTRPULONGargtypesrrPDWORDrLPDWORDrrr LPCWSTRrrr%r()%rrrr SYNCHRONIZErSTANDARD_RIGHTS_REQUIREDSTANDARD_RIGHTS_READSTANDARD_RIGHTS_WRITEFILE_READ_DATA FILE_READ_EAFILE_READ_ATTRIBUTESFILE_WRITE_DATAFILE_APPEND_DATA FILE_WRITE_EAFILE_WRITE_ATTRIBUTESrrrrPSECURITY_DESCRIPTORrrrrrrrrrr%r+ SidAdminsSidUserAclSelfRelativeSD AbsoluteSDr) rrrr#r$rrrrrr's                   #  6  rcCstt|jd@S)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 )r/S_IMODErr)rrrr get_file_modesrLJUPYTER_ALLOW_INSECURE_WRITESr)true1binaryc cs|rdnd}|r dnd}tjtjBtjB}zt|Wn ty&YnwtjdkrHtr2tnt ||d}t |tjtjB}t |tj t ||d||d,}tjdkrvt |}|dkrvtritn dj|t|d }t||VWddS1swYdS) 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)encodingzaPermissions assignment failed for secure file: '{file}'. Got '{permissions}' instead of '0o0600'.)file permissions)rO_CREATO_WRONLYO_TRUNCremover2rallow_insecure_writesissue_insecure_write_warningopencloserfdopenrLformatoct RuntimeError) rrPmoderS open_flagfdf file_modemsgrrr secure_writes<       "rhcCsdd}|t_tddS)z Issue an insecure write warning.c_s t|dS)N )r#)rgrkwargsrrrformat_warnings z4issue_insecure_write_warning..format_warningzWARNING: 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'.N)r formatwarningr)rkrrrr[s r[)Frj)r)rN)F__doc__rrr{r/r<rDr contextlibrpathlibrtypingrrrrrrLutilsr r!r\rOr[rNrrr#boolrrr&r'__annotations__r7rArGrRr`rc site_data_dirryrzrtrrr@ programdatar=rfrsite_config_dirrrrr)rrrrrrintrLgetenvrrZrhr[rrrrs         !  ;  / * (6+x7