B Z[K @sdZddlmZddlZddlZddlZddlZddlmZm Z m Z ddl m Z m Z ddlmZmZmZmZmZmZmZmZddlmZdd lmZmZdd lmZmZmZm Z m!Z!dd l"m#Z#dd l$m%Z%dd l&m'Z'GdddeZ(iZ)e)*e e)*dddddddddiZ+e+*e e+*dddiidfdddiidfdd diid!fdd"d#iid$fd%d&d'd(d)id*d+fd%d&d'd(d)iddid,d-fd.ddd/id0fd.ddd1id2fd3Gd4ddeZ,e,j-Z.Z/dS)5zuNbConvert is a utility for conversion of .ipynb files. Command-line interface for the NbConvert conversion utility. )print_functionN) JupyterApp base_aliases base_flags)catch_config_error Configurable)UnicodeListInstanceDottedObjectNameTypeBooldefaultobserve) import_item)get_export_names get_exporter) exporters preprocessorswriterspostprocessors __version__) NbConvertBase)ConversionException)unicode_stdin_streamcs$eZdZdZdZfddZZS) DottedOrNonezjA string holding a valid dotted object name in Python, such as A.b3._c Also allows for None type. cs.|dk r&t|dkr&tt|||S|SdS)Nr)lensuperrvalidate)selfobjvalue) __class__5lib/python3.7/site-packages/nbconvert/nbconvertapp.pyr *szDottedOrNone.validate)__name__ __module__ __qualname____doc__Z default_valuer __classcell__r%r%)r$r&r$srzNbConvertApp.export_formatzTemplateExporter.template_filezNbConvertApp.writer_classz NbConvertApp.postprocessor_classzNbConvertApp.output_basezFilesWriter.build_directoryz SlidesExporter.reveal_url_prefixz!NotebookExporter.nbformat_version)totemplatewriterZpostoutputz output-dirz reveal-prefixZnbformatZExecutePreprocessorZenabledTz%Execute the notebook prior to export.Z allow_errorszContinue notebook execution even if one of the cells throws an error and include the error message in the cell output (the default behaviour is to abort conversion). This flag is only relevant if '--execute' was specified, too. NbConvertApp from_stdinzgread a single notebook file from stdin. Write the resulting notebook with default basename 'notebook.*' writer_classZ StdoutWriterz1Write notebook output to stdout instead of files.FZnotebook)use_output_suffix export_formatbuild_directoryr)r0 FilesWriterzuRun nbconvert in place, overwriting the existing notebook (only relevant when converting to notebook format))r0r6ZClearOutputPreprocessorz\Clear output of current file and save in place, overwriting the existing notebook. ZTemplateExporter)Zexclude_input_promptexclude_output_promptz9Exclude input and output prompts from converted document.)r7Z exclude_inputz}Exclude input cells and output prompts from converted document. This mode is ideal for generating code-free reports.)Zexecutez allow-errorsstdinstdoutZinplacez clear-outputz no-promptzno-inputcseZdZdZeZdZeZe Z e dddZ e Ze dddZed Zed d d jd dZed dd jd dZeddd jd dZedeZeddd dZeddd jd dZddddZed dZ e!dddZ"ed d!d dZ#e$d"d jd dZ%d#d$iZ&ed%d dZ'e!d&d'd(Z(ed)d*d jd dZ)ed+d,d-d.jd dZ*e gd/d jd dZ+ed,d0d jd dZ,e-dIfd1d2 Z.d3d4Z/d5d6Z0d7d8Z1d9d:Z2fd;d<Z3d=d>Z4dJd?d@Z5dAdBZ6dCdDZ7dKdEdFZ8dGdHZ9Z:S)Lr0zAApplication used to convert from notebook file type (``*.ipynb``)zjupyter-nbconvertZ log_levelcCstjS)N)loggingINFO)r!r%r%r&_log_level_defaultszNbConvertApp._log_level_defaultclassescCsZtg}xNttttfD]>}x8t|D],}t||}t|tr"t |t r"| |q"WqW|S)N) rrrrrdirgetattr isinstancetype issubclassrappend)r!r=pkgnameclsr%r%r&_classes_defaults zNbConvertApp._classes_defaultzThis application is used to convert notebook files (*.ipynb) to various other formats. WARNING: THE COMMANDLINE INTERFACE MAY CHANGE IN FUTURE RELEASES.rz{overwrite base name use for output files. can only be used when converting one notebook at a time. )helpT)configzWhether to apply a suffix prior to the extension (only relevant when converting to notebook format). The suffix is determined by the exporter, and is usually '.nbconvert'.z{notebook_name}_fileszDirectory to copy extra files (figures) to. '{notebook_name}' in the string will be converted to notebook basenamea The simplest way to use nbconvert is > jupyter nbconvert mynotebook.ipynb which will convert mynotebook.ipynb to the default format (probably HTML). You can specify the export format with `--to`. Options include {0} > jupyter nbconvert --to latex mynotebook.ipynb Both HTML and LaTeX support multiple output templates. LaTeX includes 'base', 'article' and 'report'. HTML includes 'basic' and 'full'. You can specify the flavor of the format used. > jupyter nbconvert --to html --template basic mynotebook.ipynb You can also pipe the output to stdout, rather than a file > jupyter nbconvert mynotebook.ipynb --stdout PDF is generated via latex > jupyter nbconvert mynotebook.ipynb --to pdf You can get (and serve) a Reveal.js-powered slideshow > jupyter nbconvert myslides.ipynb --to slides --post serve Multiple notebooks can be given at the command line in a couple of different ways: > jupyter nbconvert notebook*.ipynb > jupyter nbconvert notebook1.ipynb notebook2.ipynb or you can specify the notebooks list in a config file, containing:: c.NbConvertApp.notebooks = ["my_notebook.ipynb"] > jupyter nbconvert --config mycfg.py z!nbconvert.writers.base.WriterBasez`Instance of the writer class used to write the results of the conversion.)rH allow_noner6z]Writer class used to write the results of the conversionz#nbconvert.writers.files.FilesWriterz#nbconvert.writers.debug.DebugWriterz%nbconvert.writers.stdout.StdoutWriter)Z fileswriterZ debugwriterZ stdoutwriter)rJr2cCs2|d}||jkr$|j|}t||_dS)Nnew)lowerwriter_aliasesrwriter_factory)r!changerKr%r%r&_writer_class_changedsz"NbConvertApp._writer_class_changedz/nbconvert.postprocessors.base.PostProcessorBasezfInstance of the PostProcessor class used to write the results of the conversion.zcPostProcessor class used to write the results of the conversionZservez1nbconvert.postprocessors.serve.ServePostProcessorNpostprocessor_classcCs6|d}||jkr$|j|}|r2t||_dS)NrK)rLpostprocessor_aliasesrpostprocessor_factory)r!rOrKr%r%r&_postprocessor_class_changeds z)NbConvertApp._postprocessor_class_changedzhttps://unpkg.com/zURL base for ipywidgets packageZhtmlFzThe export format to be used, either one of the built-in formats, or a dotted object name that represents the import path for an `Exporter` class)rJrHzList of notebooks to convert. Wildcards are supported. Filenames passed positionally will be added to the list. z"read a single notebook from stdin.cs4|tt|||||dS)zsx (