o i@sdZddlmZddlmZmZmZmZddlm Z m Z ddl m Z gdZ eeeedZdd lmZdd lmZdd lmZmZdd lmZdd lmZddlmZmZGdddeZe dedZdddZ edfddZ!dddZ"edfddZ#dS)znThe Jupyter notebook format Use this module to read or write notebook files as particular nbformat versions. ) get_logger)v1v2v3v4) __version__ version_info)Sentinel)versionsvalidateValidationErrorconvert from_dict NotebookNodecurrent_nbformatcurrent_nbformat_minor NBFormatError NO_CONVERTreadsreadwriteswriter rr )r)reader)r)rr)nbformat)nbformat_minor)r r c@s eZdZdS)rN)__name__ __module__ __qualname__r"r"L/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/nbformat/__init__.pyr2srrzKValue to prevent nbformat to convert notebooks to most recent version. Nc Kstj|fi|}|turt||}zt|W|StyC}ztd|t|t r8||d<WYd}~|SWYd}~|Sd}~ww)a9Read 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. capture_validation_error : dict, optional If provided, a key of "ValidationError" with a value of the ValidationError instance will be added to the dictionary. Returns ------- nb : NotebookNode The notebook that was read. Notebook JSON is invalid: %sr N) rrrrr r rerror isinstancedict)s as_versioncapture_validation_errorkwargsnber"r"r#r?s    rc Ks|tur t||}nt|\}}zt|Wn"ty9}ztd|t|t r/||d<WYd}~nd}~wwt |j |fi|S)aWrite 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. capture_validation_error : dict, optional If provided, a key of "ValidationError" with a value of the ValidationError instance will be added to the dictionary. Returns ------- s : unicode The notebook as a JSON string. r$r N) rrr get_versionr r rr%r&r'r writes_json)r,versionr*r+_r-r"r"r#res   rc Ks|z|}Wn-ty3t|dd}t|||fi|WdYS1s,wYYnwt|||fi|S)arRead 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. capture_validation_error : dict, optional If provided, a key of "ValidationError" with a value of the ValidationError instance will be added to the dictionary. Returns ------- nb : NotebookNode The notebook that was read. utf-8encodingN)rAttributeErroropenr)fpr)r*r+buffr"r"r#rs  (rc Kst|||fi|}t|tr|d}z|||ds'|dWdSWdStydt|ddd"}|||dsP|dWdYdSWdYdS1s\wYYdSw)aWrite 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. capture_validation_error : dict, optional If provided, a key of "ValidationError" with a value of the ValidationError instance will be added to the dictionary. utf8 wr2r3N)rr&bytesdecoderendswithr5r6)r,r7r0r*r+r(r9r"r"r#rs"        &r)N)$__doc__ traitlets.logrrrrr_versionrr sentinelr __all__r r converterr notebooknoderrrrrr validatorr r ValueErrorrrrrrrrr"r"r"r#s6       & $%