ó ù2¢\c@sgdZddlmZddlZddlZddlZddlZddlmZmZddl m Z ddl m Z dd l mZdd lmZmZmZdd lmZdd lmZdd lmZmZmZmZmZmZmZm Z mZm!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ej(dƒZ)defd„ƒYZ*dS(s#A base class for contents managers.iÿÿÿÿ(tfnmatchN(t HTTPErrortRequestHandleri(t FilesHandleri(t Checkpoints(tLoggingConfigurable(tsigntvalidatetValidationError(t new_notebook(t import_item( tAnytBooltDicttInstancetListt TraitErrortTypetUnicodeRtdefault(t string_types(tIPythonHandler(t_s \-Copy\d*\.tContentsManagerc BsÌeZdZeddeƒZeededdƒZe e j ƒZ d„Z eeƒdddd d d d gdedd ƒZeedƒdeddƒZeddeddƒZeddeddƒZed=dededdƒZedƒd„ƒZd„ZeedeƒZe edeƒZedeƒZe dƒd„ƒZ!e dƒd„ƒZ"ee#de$dededdƒZ%ededdƒZ&d „Z'd!„Z(d"„Z)d#d$„Z*d%„Z+ed=d=d&„Z,d'„Z-d(„Z.d)„Z/d*„Z0d+„Z1d,„Z2d-„Z3d=d.„Z4d#d#d/„Z5d0„Z6d#d#d#d1„Z7d=d#d2„Z8d=d3„Z9d4„Z:d5„Z;d#d6„Z<d#d7„Z=d8„Z>d9„Z?d:„Z@d;„ZAd<„ZBRS(>sÙBase class for serving files and directories. This serves any text or binary file, as well as directories, with special handling for JSON notebook documents. Most APIs take a path argument, which is always an API-style unicode path, and always refers to a directory. - unicode, not url-escaped - '/'-separated - leading and trailing '/' will be stripped - if unspecified, path defaults to '', indicating the root path. t/tconfigthelpsAllow access to hidden filescCstjd|ƒS(Ntparent(RtNotebookNotary(tself((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt_notary_default@su __pycache__s*.pycs*.pyos .DS_Stores*.sos*.dylibs*~sC Glob patterns to hide in file and directory listings. tUntitleds4The base name used when creating untitled notebooks.tuntitleds0The base name used when creating untitled files.sUntitled Folders6The base name used when creating untitled directories.t allow_nonesuPython callable or importstring thereof To be called on a contents model prior to save. This can be used to process the structure, such as removing notebook outputs or other side effects that should not be saved. It will be called as (all arguments passed by keyword):: hook(path=path, model=model, contents_manager=self) - model: the model to be saved. Includes file contents. Modifying this dict will affect the file that is stored. - path: the API path of the save destination - contents_manager: this ContentsManager instance t pre_save_hookcCsJ|d}t|tƒr+t|jƒ}nt|ƒsFtdƒ‚n|S(Ntvaluespre_save_hook must be callable(t isinstanceRR R"tcallableR(RtproposalR#((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt_validate_pre_save_hookjs   cKss|jroy6|jjd|ƒ|jd|d|d||Wqotk rk|jjd|dtƒqoXndS(s0Run the pre-save hook if defined, and log errorssRunning pre-save hook on %stmodeltpathtcontents_managersPre-save hook failed on %stexc_infoN(R"tlogtdebugt ExceptionterrortTrue(RR(R)tkwargs((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytrun_pre_save_hookss  # t checkpointscCs|j|jS(N(tcheckpoints_classtcheckpoints_kwargs(R((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt_default_checkpoints€sR5cCstd|d|jƒS(NRR,(tdictR,(R((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt_default_checkpoints_kwargs„stklasssvhandler class to use when serving raw file requests. Default is a fallback that talks to the ContentsManager API, which may be inefficient, especially for large files. Local files-based ContentsManagers can use a StaticFileHandler subclass, which will be much more efficient. Access to these files should be Authenticated. sÆExtra parameters to pass to files_handler_class. For example, StaticFileHandlers generally expect a `path` argument specifying the root directory from which to serve files. cCs2g}|jr.|jd|j|jfƒn|S(s[Return additional handlers Default: self.files_handler_class on /files/.* s /files/(.*)(tfiles_handler_classtappendtfiles_handler_params(Rthandlers((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytget_extra_handlers¢s  cCs t‚dS(s=Does a directory exist at the given path? Like os.path.isdir Override this method in subclasses. Parameters ---------- path : string The path to check Returns ------- exists : bool Whether the path does indeed exist. N(tNotImplementedError(RR)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt dir_exists±scCs t‚dS(s/Is path a hidden directory or file? Parameters ---------- path : string The path to check. This is an API path (`/` separated, relative to root dir). Returns ------- hidden : bool Whether the path is hidden. N(R?(RR)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt is_hiddenÄstcCstdƒ‚dS(sADoes a file exist at the given path? Like os.path.isfile Override this method in subclasses. Parameters ---------- path : string The API path of a file to check for. Returns ------- exists : bool Whether the file exists. s!must be implemented in a subclassN(R?(RR)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt file_existsÕscCs|j|ƒp|j|ƒS(s0Does a file or directory exist at the given path? Like os.path.exists Parameters ---------- path : string The API path of a file or directory to check for. Returns ------- exists : bool Whether the target exists. (RCR@(RR)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytexistsèscCstdƒ‚dS(sGet a file or directory model.s!must be implemented in a subclassN(R?(RR)tcontentttypetformat((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytgetùscCstdƒ‚dS(sí Save a file or directory model to path. Should return the saved model with no content. Save implementations should call self.run_pre_save_hook(model=model, path=path) prior to writing any data. s!must be implemented in a subclassN(R?(RR(R)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytsaveýscCstdƒ‚dS(s%Delete the file or directory at path.s!must be implemented in a subclassN(R?(RR)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt delete_filescCstdƒ‚dS(sRename a file or directory.s!must be implemented in a subclassN(R?(Rtold_pathtnew_path((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt rename_file scCsH|jdƒ}|s'tddƒ‚n|j|ƒ|jj|ƒdS(s7Delete a file/directory and any associated checkpoints.RisCan't delete rootN(tstripRRJR3tdelete_all_checkpoints(RR)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytdeletes  cCs'|j||ƒ|jj||ƒdS(s<Rename a file and any checkpoints associated with that file.N(RMR3trename_all_checkpoints(RRKRL((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytrenamescCsb|jdƒ}|jd|ƒjdƒ}||krI|j||ƒn|j|dtƒ}|S(s®Update the file's path For use in PATCH requests, to enable renaming a file without re-uploading its contents. Only used for renaming at the moment. RR)RE(RNRHRRtFalse(RR(R)RL((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytupdates  cCsdS(NsServing contents((R((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyt info_string,scCsdS(sUReturn the API path for the kernel KernelManagers can turn this value into a filesystem path, or ignore it altogether. The default value here will start kernels in the directory of the notebook server. FileContentsManager overrides this to use the directory containing the notebook. RB((RR)R(((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytget_kernel_path/s c Csª|jdƒ}|jdƒ\}}}||}xrtjƒD]d}|r_dj||ƒ} nd} djd|d| d|ƒ} |jd j|| ƒƒs>Pq>q>W| S( sÂIncrement a filename until it is unique. Parameters ---------- filename : unicode The name of a file, including extension path : unicode The API path of the target's directory insert: unicode The characters to insert after the base filename Returns ------- name : unicode A filename that is unique, based on the input filename. Rt.s{}{}RBu{basename}{insert}{suffix}tbasenametinserttsuffixu{}/{}(RNt partitiont itertoolstcountRGRD( RtfilenameR)RYRXtdottextRZtitinsert_itname((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytincrement_filename;s cCs`yt|dƒWnGtk r[}dj|jtj|jdddd„ƒƒ|d((tobj((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytbRBtmessage(t validate_nbRRGRhtjsontdumpstinstance(RR(te((sAlib/python2.7/site-packages/notebook/services/contents/manager.pytvalidate_notebook_model\s 2cCs7|jdƒ}|j|ƒs4tdd|ƒ‚ni}|rM||dþs(tanyt hide_globs(RRc((RcsAlib/python2.7/site-packages/notebook/services/contents/manager.pyt should_listüscCs|jj||ƒS(sCreate a checkpoint.(R3tcreate_checkpoint(RR)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyR—scCs|jj|||ƒdS(s' Restore a checkpoint. N(R3trestore_checkpoint(Rt checkpoint_idR)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyR˜scCs|jj|ƒS(N(R3tlist_checkpoints(RR)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyRš scCs|jj||ƒS(N(R3tdelete_checkpoint(RR™R)((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyR›sN(Ct__name__t __module__t__doc__RR0troot_dirR RSt allow_hiddenRRRR‰RRR•RRuRvRtR RzR"RR'R2RRR4R3R R5RR6R8RRR:R<R>R@RARCRDRHRIRJRMRPRRRTRURVRdRnRxRwR…R‡RR‹R‘R–R—R˜RšR›(((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyR(sv                      ! & "        (+RžRR\Rjtostret tornado.webRRtfiles.handlersRR3Rttraitlets.config.configurableRtnbformatRRRiRt nbformat.v4R tipython_genutils.importstringR t traitletsR R R RRRRRRtipython_genutils.py3compatRtnotebook.base.handlersRtnotebook.transutilsRtcompileR~R(((sAlib/python2.7/site-packages/notebook/services/contents/manager.pyts$    F