B 3¢\A+ã@sâdZddlZddlmZmZddlmZmZddlm Z ddl m Z m Z m Z dd„ZGd d „d e ƒZGd d „d e ƒZGd d„de ƒZGdd„de ƒZGdd„de ƒZdZde efde efefde efde efdefgZdS)z‘Tornado handlers for the contents web service. Preliminary documentation at https://github.com/ipython/ipython/wiki/IPEP-27%3A-Contents-Service éN)ÚgenÚweb)Ú url_path_joinÚ url_escape)Ú date_default)ÚIPythonHandlerÚ APIHandlerÚ path_regexc s¤ddddddddd h }|tˆ ¡ƒ}|r>t d d j|d ¡‚dd g}|rv‡fd d„|Dƒ}|r t d dj|d¡‚n*‡fdd„|Dƒ}|r t d dj|d¡‚dS)z  Validate a model returned by a ContentsManager method. If expect_content is True, then we expect non-null entries for 'content' and 'format'. ÚnameÚpathÚtypeÚwritableZcreatedÚ last_modifiedZmimetypeÚcontentÚformatiôzMissing Model Keys: {missing})Úmissingcsg|]}ˆ|dkr|‘qS)N©)Ú.0Úkey)ÚmodelrúBlib/python3.7/site-packages/notebook/services/contents/handlers.pyú 0sz"validate_model..zKeys unexpectedly None: {keys})Úkeyscs"i|]}ˆ|dk rˆ||“qS)Nr)rr)rrrú 7sz"validate_model..z"Keys unexpectedly not None: {keys}N)ÚsetrrÚ HTTPErrorr)rÚexpect_contentZ required_keysrZmaybe_none_keysÚerrorsr)rrÚvalidate_models6 rc@sÈeZdZdd„Zddd„Zejejddd„ƒƒZ ejejdd d „ƒƒZ ejdd d „ƒZ ejdd„ƒZ ejddd„ƒZ ejdd„ƒZejejddd„ƒƒZejejd dd„ƒƒZejejd!dd„ƒƒZd S)"ÚContentsHandlercCst|jddt|ƒƒS)z«Return the full URL location of a file. Parameters ---------- path : unicode The API path of the file, such as "foo/bar.txt". ZapiÚcontents)rÚbase_urlr)Úselfr rrrÚ location_urlEszContentsHandler.location_urlTcCsR|r| |d¡}| d|¡| d|d¡| dd¡| tj|td¡dS) zBFinish a JSON request with a model, setting relevant headers, etc.r ÚLocationz Last-Modifiedrz Content-Typezapplication/json)ÚdefaultN)r#Ú set_headerÚfinishÚjsonÚdumpsr)r"rÚlocationrrrÚ _finish_modelQs   zContentsHandler._finish_modelÚccs¼|pd}|jddd}|dkr.t dd|¡‚|jddd}|d krTt dd |¡‚|jd d d}|d krzt dd|¡‚t|ƒ}t |jj||||d¡V}t||d|j |dddS)z©Return 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,r N)r%>Ú directoryÚfileÚnotebookNizType %r is invalidr>ÚtextÚbase64NzFormat %r is invalidrÚ1>r2Ú0zContent %r is invalid)r r rr)rF)r*) Zget_query_argumentrrÚintrÚ maybe_futureÚcontents_managerÚgetrr+)r"r r rrrrrrr7Zs  zContentsHandler.getccsP|j}| ¡}|dkr"t dd¡‚t | ||¡¡V}t|dd| |¡dS)z?PATCH renames a file or directory without re-uploading content.NizJSON body missingF)r) r6Ú get_json_bodyrrrr5Úupdaterr+)r"r ÚcmrrrrÚpatchus  zContentsHandler.patchNccsT|j dj||pdd¡t |j ||¡¡V}| d¡t|dd|  |¡dS)z6Copy a file, optionally specifying a target directory.z Copying {copy_from} to {copy_to}r,)Ú copy_fromÚcopy_toéÉF)rN) ÚlogÚinforrr5r6ÚcopyÚ set_statusrr+)r"r<r=rrrrÚ_copys   zContentsHandler._copyccsH|j d|¡t |j ||¡¡V}| d¡t|dd| |¡dS)z#Handle upload of a new file to pathzUploading file to %sr>F)rN) r?r@rr5r6ÚnewrBrr+)r"rr rrrÚ_uploads   zContentsHandler._uploadccsR|j d|pd|¡t |jj|||d¡V}| d¡t|dd| |¡dS)z#Create a new, empty untitled entityzCreating new %s in %sr.)r r Úextr>F)rN) r?r@rr5r6Z new_untitledrBrr+)r"r r rFrrrrÚ _new_untitled–s   zContentsHandler._new_untitledccsV| dd¡}|r|dkr&|j d|¡t |j ||¡¡V}t|dd| |¡dS)zSave an existing file.ÚchunkNéÿÿÿÿzSaving file at %sF)r) r7r?r@rr5r6Zsaverr+)r"rr rHrrrÚ_saveŸs    zContentsHandler._saveccs |j}| |¡rt dd¡‚| |¡s6t dd|¡‚| ¡}|dk r| d¡}| dd¡}| d d¡}|r|| ||¡Vqœ|j|||d Vn | |¡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 iz&Cannot POST to files, use PUT instead.i”zNo such directory: %sNr<rFr,r )r rF) r6Ú file_existsrrZ dir_existsr8r7rCrG)r"r r:rr<rFr rrrÚpost©s      zContentsHandler.postccs|| ¡}|rf| d¡r"t dd¡‚t |j |¡¡V}|rPt | ||¡¡Vqxt |  ||¡¡Vnt |  |¡¡VdS)aµSaves 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. r<izCannot copy with PUT, only POSTN) r8r7rrrr5r6rKrJrErG)r"r rÚexistsrrrÚputÌs   zContentsHandler.putccs<|j}|j d|¡t | |¡¡V| d¡| ¡dS)zdelete a file in the given pathz delete %séÌN)r6r?Úwarningrr5ÚdeleterBr')r"r r:rrrrQås  zContentsHandler.delete)T)r,)r,)N)r,r,)r,)r,)r,)Ú__name__Ú __module__Ú __qualname__r#r+rÚ authenticatedrÚ coroutiner7r;rCrErGrJrLrNrQrrrrrCs.      !rc@s8eZdZejejddd„ƒƒZejejddd„ƒƒZdS) ÚCheckpointsHandlerr,ccs4|j}t | |¡¡V}tj|td}| |¡dS)z get lists checkpoints for a file)r%N)r6rr5Zlist_checkpointsr(r)rr')r"r r:Ú checkpointsÚdatarrrr7òszCheckpointsHandler.getccsh|j}t | |¡¡V}tj|td}t|jdt |ƒdt |dƒƒ}|  d|¡|  d¡|  |¡dS)zpost creates a new checkpoint)r%z api/contentsrXÚidr$r>N) r6rr5Zcreate_checkpointr(r)rrr!rr&rBr')r"r r:Z checkpointrYr*rrrrLûs  zCheckpointsHandler.postN)r,)r,) rRrSrTrrUrrVr7rLrrrrrWðs rWc@s4eZdZejejdd„ƒƒZejejdd„ƒƒZdS)ÚModifyCheckpointsHandlerccs0|j}t | ||¡¡V| d¡| ¡dS)z&post restores a file from a checkpointrON)r6rr5Zrestore_checkpointrBr')r"r Ú checkpoint_idr:rrrrL s zModifyCheckpointsHandler.postccs0|j}t | ||¡¡V| d¡| ¡dS)z+delete clears a checkpoint for a given filerON)r6rr5Zdelete_checkpointrBr')r"r r\r:rrrrQs zModifyCheckpointsHandler.deleteN) rRrSrTrrUrrVrLrQrrrrr[ sr[c@s,eZdZdZdZdd„ZeZZZZ dS)ÚNotebooksRedirectHandlerz(Redirect /api/notebooks to /api/contents)ZGETZPUTZPATCHZPOSTZDELETEcCs$|j d¡| t|jd|ƒ¡dS)Nz//api/notebooks is deprecated, use /api/contentsz api/contents)r?rPZredirectrr!)r"r rrrr7"s  zNotebooksRedirectHandler.getN) rRrSrTÚ__doc__ZSUPPORTED_METHODSr7rNr;rLrQrrrrr]sr]c@s&eZdZdZejejddd„ƒƒZdS)ÚTrustNotebooksHandlerz$ Handles trust/signing of notebooks r,ccs.|j}t | |¡¡V| d¡| ¡dS)Nr>)r6rr5Ztrust_notebookrBr')r"r r:rrrrL0s zTrustNotebooksHandler.postN)r,) rRrSrTr^rrUrrVrLrrrrr_-sr_z(?P[\w-]+)z/api/contents%s/checkpointsz/api/contents%s/checkpoints/%sz/api/contents%s/trustz/api/contents%sz/api/notebooks/?(.*))r^r(ZtornadorrZnotebook.utilsrrZjupyter_client.jsonutilrZnotebook.base.handlersrrr rrrWr[r]r_Z_checkpoint_id_regexZdefault_handlersrrrrÚs& ..