ó ‹'=[c@s¨dZddlZddlmZddlmZddlmZmZddl m Z ddl m Z dd l m Z dd l m Z dd lmZd d ddddddddddddddgZie d6e d6e d6e d6ZddlmZmZdd lmZdd!l mZdd"lmZmZdd#l mZmZdefd$„ƒYZ ede!d%ƒZ"d&„Z#e"d'„Z$d(„Z%e"d)„Z&dS(*snThe Jupyter notebook format Use this module to read or write notebook files as particular nbformat versions. iÿÿÿÿN(t py3compat(t get_loggeri(t version_infot __version__(tv1(tv2(tv3(tv4(tSentineltversionstvalidatetValidationErrortconvertt from_dictt NotebookNodetcurrent_nbformattcurrent_nbformat_minort NBFormatErrort NO_CONVERTtreadstreadtwritestwriteRRiii(R R (R (treader(R R(tnbformattnbformat_minorcBseZRS((t__name__t __module__(((s0lib/python2.7/site-packages/nbformat/__init__.pyR+ssKValue to prevent nbformat to convert notebooks to most recent version. cKsktj||}|tk r0t||ƒ}nyt|ƒWn&tk rf}tƒjd|ƒnX|S(sRead a notebook from a string and return the NotebookNode object as the given version. The string can contain a notebook of any version. The notebook will be returned `as_version`, converting, if necessary. Notebook format errors will be logged. Parameters ---------- s : unicode The raw unicode string to read the notebook from. as_version : int The version of the notebook format to return. The notebook will be converted, if necessary. Pass nbformat.NO_CONVERT to prevent conversion. Returns ------- nb : NotebookNode The notebook that was read. sNotebook JSON is invalid: %s(RRRR R R Rterror(tst as_versiontkwargstnbte((s0lib/python2.7/site-packages/nbformat/__init__.pyR4s cKs~|tk rt||ƒ}ntj|ƒ\}}yt|ƒWn&tk ri}tƒjd|ƒnXt|j ||S(sóWrite a notebook to a string in a given format in the given nbformat version. Any notebook format errors will be logged. Parameters ---------- nb : NotebookNode The notebook to write. version : int, optional The nbformat version to write. If unspecified, or specified as nbformat.NO_CONVERT, the notebook's own version will be used and no conversion performed. Returns ------- s : unicode The notebook as a JSON string. sNotebook JSON is invalid: %s( RR Rt get_versionR R RRR t writes_json(R tversionRt_R!((s0lib/python2.7/site-packages/nbformat/__init__.pyRTs cKs_t|tjtfƒrItj|ddƒ}t|||SWdQXnt|jƒ||S(sµRead a notebook from a file as a NotebookNode of the given version. The string can contain a notebook of any version. The notebook will be returned `as_version`, converting, if necessary. Notebook format errors will be logged. Parameters ---------- fp : file or str A file-like object with a read method that returns unicode (use ``io.open()`` in Python 2), or a path to a file. as_version: int The version of the notebook format to return. The notebook will be converted, if necessary. Pass nbformat.NO_CONVERT to prevent conversion. Returns ------- nb : NotebookNode The notebook that was read. tencodingsutf-8N(t isinstanceRt unicode_typetbytestiotopenRR(tfpRRtf((s0lib/python2.7/site-packages/nbformat/__init__.pyRrsc Ksµt|tjtfƒrRtj|dddƒ}t||d||SWdQXnt|||}t|tƒr…|jdƒ}n|j|ƒ|j dƒs±|jdƒndS(sRWrite a notebook to a file in a given nbformat version. The file-like object must accept unicode input. Parameters ---------- nb : NotebookNode The notebook to write. fp : file or str Any file-like object with a write method that accepts unicode, or a path to write a file. version : int, optional The nbformat version to write. If nb is not this version, it will be converted. If unspecified, or specified as nbformat.NO_CONVERT, the notebook's own version will be used and no conversion performed. twR&sutf-8R$Ntutf8u ( R'RR(R)R*R+RRtdecodetendswith(R R,R$RR-R((s0lib/python2.7/site-packages/nbformat/__init__.pyRs ('t__doc__R*tipython_genutilsRt traitlets.logRt_versionRRtRRRRtsentinelRt__all__R t validatorR R t converterR Rt notebooknodeR RRRRRt ValueErrorRRRRRRR(((s0lib/python2.7/site-packages/nbformat/__init__.pyts<