o i/@sdZddlZddlmZmZddlmZmZmZzddl m Z Wne y/ddl m Z Ynwddl mZmZmZdd ZGd d d eZGd d d eZGdddeZGdddeZGdddeZdZdedefdedeefdedefdeefdefgZdS)zTornado handlers for the contents web service. Preliminary documentation at https://github.com/ipython/ipython/wiki/IPEP-27%3A-Contents-Service N)genweb) maybe_future url_path_join url_escape) json_default) date_default)IPythonHandler APIHandler path_regexcshd}|t}|rtdd|ddg}|r3fdd|D}|r1tdd|d Sfd d |D}|rGtdd |d S) z Validate a model returned by a ContentsManager method. If expect_content is True, then we expect non-null entries for 'content' and 'format'. > namepathtypeformatcontentcreatedmimetypewritable last_modifiedizMissing Model Keys: rrcsg|] }|dur|qSN.0keymodelr^/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/notebook/services/contents/handlers.py 5sz"validate_model..zKeys unexpectedly None: cs"i|] }|dur||qSrrrrrr <s  z"validate_model..zKeys unexpectedly not None: N)setkeysr HTTPError)rexpect_content required_keysmissingmaybe_none_keyserrorsrrrvalidate_models2  r'c@seZdZddZdddZejejdddZ ejejdd d Z ejdd d Z ejddZ ejdddZ ejddZejejdddZejejdddZejejdddZd S)ContentsHandlercCst|jddt|S)zReturn the full URL location of a file. Parameters ---------- path : unicode The API path of the file, such as "foo/bar.txt". apicontents)rbase_urlrselfr rrr location_urlJszContentsHandler.location_urlTcCsR|r||d}|d||d|d|dd|tj|tddS) zBFinish a JSON request with a model, setting relevant headers, etc.r Locationz Last-Modifiedrz Content-Typezapplication/jsondefaultN)r. set_headerfinishjsondumpsr)r-rlocationrrr _finish_modelVs   zContentsHandler._finish_modelccs|pd}|j}|jddd}|dvrtdd|d|jd dd}|d vr2tdd |d|jd d d}|dvrGtdd|dt|}||r]|js]tdd|dt|jj||||dV}t ||d|j |dddS)zReturn a model for a file or directory. A directory model contains a list of models (without content) of the files and directories it contains. r8rNr0>Nfilenotebook directoryzType z is invalidr>Ntextbase64zFormat r1>0r?zContent zfile or directory z does not exist)r rrrr"F)r6) contents_managerget_query_argumentrr!int is_hidden allow_hiddenrgetr'r7)r-r cmrrrrrrrrH_s( zContentsHandler.getccs|j}|}|d}|r%||s||r%|js%tdd||dur/tddt|||V}t |dd| |dS)z?PATCH renames a file or directory without re-uploading content.r r<z Cannot rename file or directory NzJSON body missingFrB) rC get_json_bodyrHrFrGrr!rupdater'r7)r-r rIrold_pathrrrpatch|s   zContentsHandler.patchNccsV|jd|d|p dt|j||V}|dt|dd||dS)z6Copy a file, optionally specifying a target directory.zCopying z to r8FrBN)loginforrCcopy set_statusr'r7)r- copy_fromcopy_torrrr_copys   zContentsHandler._copyccsH|jd|t|j||V}|dt|dd||dS)z#Handle upload of a new file to pathzUploading file to %srNFrBN)rOrPrrCnewrRr'r7)r-rr rrr_uploads   zContentsHandler._uploadccsR|jd|pd|t|jj|||dV}|dt|dd||dS)z#Create a new, empty untitled entityzCreating new %s in %sr9)r rextrNFrBN)rOrPrrC new_untitledrRr'r7)r-r rrXrrrr _new_untitleds   zContentsHandler._new_untitledccsV|dd}|r |dkr|jd|t|j||V}t|dd||dS)zSave an existing file.chunkNzSaving file at %sFrB)rHrOrPrrCsaver'r7)r-rr r[rrr_saves   zContentsHandler._savec cs|j}t||V}|rtddt||V}|s'tdd||}|d}|rH||s<||rH|j sHtdd||durs|d}|dd }|d d }|rh| ||VdS|j |||d VdS| |VdS) aZCreate a new file in the specified path. POST creates new files. The server always decides on the name. POST /api/contents/path New untitled, empty file or directory. POST /api/contents/path with body {"copy_from" : "/path/to/OtherNotebook.ipynb"} New copy of OtherNotebook in path r<z&Cannot POST to files, use PUT instead.rAzNo such directory: rSzCannot copy file or directory NrXr8r)rrX) rCr file_existsrr! dir_existsrJrHrFrGrUrZ) r-r rIr_r`rrSrXrrrrposts(     zContentsHandler.postccs|}|j}|rT|drtdd|dr3||s'||dr3|js3tdd|t|j|V}|rIt| ||VdSt| ||VdSt| |VdS)aSaves the file in the location specified by name and path. PUT is very similar to POST, but the requester specifies the name, whereas with POST, the server picks the name. PUT /api/contents/path/Name.ipynb Save notebook at ``path/Name.ipynb``. Notebook structure is specified in `content` key of JSON request body. If content is not specified, create a new empty notebook. rSr<zCannot copy with PUT, only POSTr z Cannot create file or directory N) rJrCrHrr!rFrGrr_r^rWrZ)r-r rrIexistsrrrputs   *zContentsHandler.putccs^|j}||r|jstdd||jd|t||V| d| dS)zdelete a file in the given pathr<z Cannot delete file or directory z delete %sN) rCrFrGrr!rOwarningrdeleterRr3r-r rIrrrrfs  zContentsHandler.delete)Tr8r)r8r8)__name__ __module__ __qualname__r.r7r authenticatedr coroutinerHrMrUrWrZr^rarcrfrrrrr(Hs4       &r(c@s8eZdZejejdddZejejdddZdS)CheckpointsHandlerr8ccs4|j}t||V}tj|td}||dS)z get lists checkpoints for a filer0N)rCrlist_checkpointsr4r5rr3)r-r rI checkpointsdatarrrrHs zCheckpointsHandler.getccsh|j}t||V}tj|td}t|jdt|dt|d}| d|| d| |dS)zpost creates a new checkpointr0 api/contentsrpidr/rNN) rCrcreate_checkpointr4r5rrr+rr2rRr3)r-r rI checkpointrqr6rrrras  zCheckpointsHandler.postNrh) rirjrkrrlrrmrHrarrrrrnsrnc@s4eZdZejejddZejejddZdS)ModifyCheckpointsHandlercc0|j}t|||V|d|dS)z&post restores a file from a checkpointrdN)rCrrestore_checkpointrRr3r-r checkpoint_idrIrrrra   zModifyCheckpointsHandler.postccrw)z+delete clears a checkpoint for a given filerdN)rCrdelete_checkpointrRr3ryrrrrf'r{zModifyCheckpointsHandler.deleteN) rirjrkrrlrrmrarfrrrrrvs rvc@s,eZdZdZdZddZeZZZZ dS)NotebooksRedirectHandlerz(Redirect /api/notebooks to /api/contents)GETPUTPATCHPOSTDELETEcCs$|jd|t|jd|dS)Nz//api/notebooks is deprecated, use /api/contentsrr)rOreredirectrr+r,rrrrH5s  zNotebooksRedirectHandler.getN) rirjrk__doc__SUPPORTED_METHODSrHrcrMrarfrrrrr}1s r}c@s&eZdZdZejejdddZdS)TrustNotebooksHandlerz$ Handles trust/signing of notebooks r8ccs.|j}t||V|d|dS)NrN)rCrtrust_notebookrRr3rgrrrraCs   zTrustNotebooksHandler.postNrh) rirjrkrrrlrrmrarrrrr@s rz(?P[\w-]+)z /api/contentsz /checkpointsz /checkpoints/z/trustz/api/notebooks/?(.*))rr4tornadorrnotebook.utilsrrrjupyter_client.jsonutilr ImportErrorrnotebook.base.handlersr r r r'r(rnrvr}r_checkpoint_id_regexdefault_handlersrrrrs4 .<