KeddZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl m Z ddlZddlmZddlmZmZmZddlmZddlmZdd lmZmZmZmZmZmZdd lm Z!dd l"m#Z#dd l$m%Z%dd l&m'Z'ddl(m)Z)m*Z*ddl+m,Z,m-Z-ddl.m/Z/m0Z0m1Z1 ddl2m3Z3n#e4$r ddl&m5Z3YnwxYwdZ6Gdde-e0Z7Gdde7e,e/Z8dS)z?A contents manager that uses the local file system for storage.N)datetime)Path)run_sync)existsis_file_hidden is_hidden) send2trash)web)BoolInt TraitErrorUnicodedefaultvalidate)_tzAuthenticatedFileHandler)_i18n) to_api_path)AsyncFileCheckpointsFileCheckpoints)AsyncFileManagerMixinFileManagerMixin)AsyncContentsManagerContentsManagercopy_pat)samefile)samefile_simplec4eZdZdZedZedddZeddZ e dd Z ed d Z e d fd Z ed dZedddZedddZeddZeddZdZdZdZdZdZdZd.dZd/dZd.dZd0d Zd1d"Zd1d#Zd$Z d%Z!d&Z"d2d'Z#d2fd( Z$d)Z%d*Z&d3d,Z'd-Z(xZ)S)4FileContentsManagerzA file contents manager.T)configz&The max folder size that can be copied)r"helproot_dircN|jstjS|jjSN)parentosgetcwdr%selfs Llib/python3.11/site-packages/jupyter_server/services/contents/filemanager.py_default_root_dirz%FileContentsManager._default_root_dir1s#{ 9;; {##c|d}tj|stj|}tj|st d|z|S)Nvaluez%r is not a directory)r)pathisabsabspathisdirr )r,proposalr1s r-_validate_root_dirz&FileContentsManager._validate_root_dir7sd!w}}U## +GOOE**Ew}}U## >4u<== = r/ preferred_dircn|jsdS |jj}||jjkrd}|ytjdt d t |}||jS#t$rtd|zdwxYwn#t$rYnwxYwdS)NzqServerApp.preferred_dir config is deprecated in jupyter-server 2.0. Use FileContentsManager.preferred_dir instead) stacklevelz%%s is outside root contents directory) r(r8r%warningswarn FutureWarningr relative_toas_posix ValueErrorr AttributeError)r,r1r2s r-_default_preferred_dirz*FileContentsManager._default_preferred_dirAs{ 2 `K-E ,,,  H!  `;;D++DM::CCEEE!```$%Lu%TUU[__`!    D rsB%:BB!% B21B2ct|d|j|d<t|S)Nr1)rr%super_validate_preferred_dir)r,r6 __class__s r-rGz+FileContentsManager._validate_preferred_dirYs8((94=IIww..x888r/checkpoints_classctSr')rr+s r-_checkpoints_class_defaultz.FileContentsManager._checkpoints_class_default_sr/zIf True (default), deleting files will send them to the platform's trash/recycle bin, where they can be recovered. If False, deleting files really deletes them.FaIf True, deleting a non-empty directory will always be allowed. WARNING this may result in files being permanently removed; e.g. on Windows, if the data size is too big for the trash/recycle bin the directory will be permanently deleted. If False (default), the non-empty directory will be sent to the trash only if safe. And if ``delete_to_trash`` is True, the directory won't be deleted.files_handler_classctSr'rr+s r-_files_handler_class_defaultz0FileContentsManager._files_handler_class_defaultus''r/files_handler_paramscd|jiS)Nr2)r%r+s r-_files_handler_params_defaultz1FileContentsManager._files_handler_params_defaultys &&r/c|d}||}t||jS)aTDoes the API style path correspond to a hidden directory or file? Parameters ---------- path : str The path to check. This is an API path (`/` separated, relative to root_dir). Returns ------- hidden : bool Whether the path exists and is hidden. /r2strip _get_os_pathrr%r,r2os_paths r-rzFileContentsManager.is_hidden}s;zz####..$-000r/c|d}||} tj|tjS#t $r|jd|YdSwxYw)aXDoes the API style path correspond to a writable directory or file? Parameters ---------- path : str The path to check. This is an API path (`/` separated, relative to root_dir). Returns ------- hidden : bool Whether the path exists and is writable. rSrTz'Failed to check write permissions on %sF)rVrWr)accessW_OKOSErrorlogerrorrXs r- is_writablezFileContentsManager.is_writables{zz####.. 9Wbg.. .    HNNDg N N N55 sA %A54A5c|d}||}tj|S)aCReturns True if the file exists, else returns False. API-style wrapper for os.path.isfile Parameters ---------- path : str The relative path to the file (with '/' as separator) Returns ------- exists : bool Whether the file exists. rSrVrWr)r2isfilerXs r- file_existszFileContentsManager.file_existss:zz###D))w~~g&&&r/c|d}||}tj|S)avDoes the API-style path refer to an extant directory? API-style wrapper for os.path.isdir Parameters ---------- path : str The path to check. This is an API path (`/` separated, relative to root_dir). Returns ------- exists : bool Whether the path is indeed a directory. rSrTrVrWr)r2r5rXs r- dir_existszFileContentsManager.dir_existss= zz####..w}}W%%%r/cv|d}||}t|S)a@Returns True if the path exists, else returns False. API-style wrapper for os.path.exists Parameters ---------- path : str The API path to the file (with '/' as separator) Returns ------- exists : bool Whether the target exists. rSrT)rVrWrrXs r-rzFileContentsManager.existss5zz####..gr/c ||}tj|}d|z}|jsEt ||jr0|jd|tj d| |j }n3#ttf$r|j dd}YnwxYw tj|j}nW#ttf$rC|j d|j|t#dddd d tj }YnwxYw tj|j}nW#ttf$rC|j d |j|t#dddd d tj }YnwxYwi}|d dd |d<||d<||d<||d<d|d<d|d<d|d<||d<|||d<|S)z)Build the common base of a contents model$file or directory does not exist: %r