o i3@s2dZddlZzddlmZWneyddlmZYnwddlmZddlm Z ddl m Z ddl m Z mZmZdd lmZmZd Zd d ZGd dde ZGdddeZGdddeZGdddeZGdddeZGdddeZdZdeefdedeefdeefdeefdefgZdS) zTornado handlers for the contents web service. Preliminary documentation at https://github.com/ipython/ipython/wiki/IPEP-27%3A-Contents-Service N) json_default) date_default) ensure_async)web) authorized) APIHandlerJupyterHandler path_regex) url_escape url_path_joincontentscshd}|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.0keymodelrd/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/jupyter_server/services/contents/handlers.py 3sz"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_models. r(c@seZdZdZeZdS)ContentsAPIHandlerzA contents API handler.N)__name__ __module__ __qualname____doc__ AUTH_RESOURCE auth_resourcerrrrr)Bsr)c@seZdZdZddZdddZejeddd Z ejedd d Z dd dZ ddZ dddZ ddZejedddZejedddZejedddZd S)ContentsHandlerzA contents handler.cCst|jddt|S)zReturn the full URL location of a file. Parameters ---------- path : unicode The API path of the file, such as "foo/bar.txt". apir )r base_urlr selfrrrr location_urlKszContentsHandler.location_urlTcCsR|r||d}|d||d|d|dd|tj|tddS) zBFinish a JSON request with a model, setting relevant headers, etc.rLocationz Last-Modifiedrz Content-Typezapplication/jsondefaultN)r5 set_headerfinishjsondumpsr)r4rlocationrrr _finish_modelUs   zContentsHandler._finish_modelcs|pd}|j}|jddd}|dvrd}|jddd}|dvr(td d ||jd d d}|d vr;td d|t|p?d}|jsXt||IdHrXtdd|dt|jj||||dIdH}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. r?rNr7>Nfilenotebook directoryr@r>Ntextbase64zFormat %r is invalidr1>0rFzContent %r is invalidizfile or directory z does not exist)rrrrr#F)r=) contents_managerget_query_argumentrr"int allow_hiddenr is_hiddengetr(r>)r4rcmrr content_strrrrrrrN^s2  zContentsHandler.getcs|j}|}|durtdd|d}|r9|js9t||IdHs0t||IdHr9tdd|t|||IdH}t |dd| |dS)z?PATCH renames a file or directory without re-uploading content.NrEzJSON body missingrz Cannot rename file or directory FrH) rI get_json_bodyrr"rNrLrrMupdater(r>)r4rrOrold_pathrrrpatchs$   zContentsHandler.patchNcsX|jdj||p ddt|j||IdH}|dt|dd||dS)z6Copy a file, optionally specifying a target directory.z Copying {copy_from} to {copy_to}r?) copy_fromcopy_toNFrH) loginforrrIcopy set_statusr(r>)r4rUrVrrrr_copys  zContentsHandler._copycsL|jd|t|j||IdH}|dt|dd||dS)z#Handle upload of a new file to pathzUploading file to %sNrWFrH)rXrYrrInewr[r(r>)r4rrrrr_uploads   zContentsHandler._uploadcsV|jd|pd|t|jj|||dIdH}|dt|dd||dS)z#Create a new, empty untitled entityzCreating new %s in %sr@)rrextNrWFrH)rXrYrrI new_untitledr[r(r>)r4rrr_rrrr _new_untitleds  zContentsHandler._new_untitledcsZ|dd}|r |dkr|jd|t|j||IdH}t|dd||dS)zSave an existing file.chunkNzSaving file at %sFrH)rNrXrYrrIsaver(r>)r4rrrbrrr_saves   zContentsHandler._savecs|j}t||IdH}|rtdd|}|rm|d}|rN|jsCt||IdHs:t||IdHrCtdd|| ||IdHdS|dd}|dd}|d vr`d }|j |||d IdHdS| |IdHdS) 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 NrEz&Cannot POST to files, use PUT instead.rUzCannot copy file or directory r_r?r>Nr?r@rArBr@)rr_) rIr file_existsrr"rQrNrLrMr\ra)r4rrOrfrrUr_rrrrposts,    zContentsHandler.postcs|}|j}|rl|drtdd|js=|dr*t||dIdHs4t||IdHr=tdd|t|j|IdH}|ddd vrTd |d<|ra| ||IdHdS| ||IdHdS| |IdHdS) 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. rUrEzCannot copy with PUT, only POSTrNz Cannot create file or directory rr?>Nr?r@rArBr@) rQrIrNrr"rLrrMrfrer^ra)r4rrrOexistsrrrputs*   zContentsHandler.putcsl|j}|jst||IdHrtdd||jd|t||IdH| d| dS)zdelete a file in the given pathNrEz Cannot delete file or directory z delete %s) rIrLrrMrr"rXwarningdeleter[r:r4rrOrrrrls  zContentsHandler.delete)Tr?r)r?r?)r*r+r,r-r5r>r authenticatedrrNrTr\r^rarergrirlrrrrr0Hs.  $    '"r0c@s8eZdZdZejedddZejedddZdS) CheckpointsHandlerzA checkpoints API handler.r?cs8|j}t||IdH}tj|td}||dS)z get lists checkpoints for a fileNr7)rIrlist_checkpointsr;r<rr:)r4rrO checkpointsdatarrrrN"s zCheckpointsHandler.getcsl|j}t||IdH}tj|td}t|jdt|dt|d}| d|| d| |dS)zpost creates a new checkpointNr7 api/contentsrridr6rW) rIrcreate_checkpointr;r<rr r2r r9r[r:)r4rrO checkpointrsr=rrrrg+s   zCheckpointsHandler.postNrn) r*r+r,r-rrorrNrgrrrrrpsrpc@s4eZdZdZejeddZejeddZdS)ModifyCheckpointsHandlerz#A checkpoints modification handler.c4|j}t|||IdH|d|dS)z&post restores a file from a checkpointNrj)rIrrestore_checkpointr[r:r4r checkpoint_idrOrrrrgA   zModifyCheckpointsHandler.postcry)z+delete clears a checkpoint for a given fileNrj)rIrdelete_checkpointr[r:r{rrrrlJr}zModifyCheckpointsHandler.deleteN) r*r+r,r-rrorrgrlrrrrrx>s rxc@s,eZdZdZdZddZeZZZZ dS)NotebooksRedirectHandlerz(Redirect /api/notebooks to /api/contents)GETPUTPATCHPOSTDELETEcCs(|jd|t|jdt|dS)zHandle a notebooks redirect.z//api/notebooks is deprecated, use /api/contentsrtN)rXrkredirectr r2r r3rrrrNYs zNotebooksRedirectHandler.getN) r*r+r,r-SUPPORTED_METHODSrNrirTrgrlrrrrrTs rc@s*eZdZdZejeeddddZdS)TrustNotebooksHandlerz"Handles trust/signing of notebooks)resourcer?cs2|j}t||IdH|d|dS)zTrust a notebook by path.NrW)rIrtrust_notebookr[r:rmrrrrgds   zTrustNotebooksHandler.postNrn) r*r+r,r-rrorr.rgrrrrras rz(?P[\w-]+)z/api/contents%s/checkpointsz /api/contentsz /checkpoints/z/api/contents%s/trustz/api/contents%sz/api/notebooks/?(.*))r-r;jupyter_client.jsonutilr ImportErrorrjupyter_core.utilsrtornadorjupyter_server.authrjupyter_server.base.handlersrrr jupyter_server.utilsr r r.r(r)r0rprxrr_checkpoint_id_regexdefault_handlersrrrrs<    *X