Mh`6dZddlmZddlZddlZddlZddlZddlZddlZ ddl m Z m Z ddl mZmZmZddlmZmZmZmZmZmZmZmZddlmZmZddlmZdd lm Z m!Z!m"Z"m#Z#m$Z$dd l%m&Z&d d l'm(Z(m)Z)d d l*m+Z+d dl,m-Z-d dl.m/Z/GddeZ0iZ1e12ee12dddddddddddd iZ3e32ee32ddd iid!fdd"d iid#fd$d%d iid&fd$d'd(iid)fd*d+d,d-d.id/d0fd*d+d,d-d.idd id1d2fd*d+d,d-d.idd id3d4fd5d d d6id7fd5d d d d8id9fd:d;d iidfd5d?d*iid@fdAdBd iidCfdAdDd iidEfdFGdGd$eZ4GdHdIe4Z5e4j6xZ7Z8e5j6Z9dS)JzuNbConvert is a utility for conversion of .ipynb files. Command-line interface for the NbConvert conversion utility. ) annotationsN)dedentfill) JupyterApp base_aliases base_flags)BoolDottedObjectNameInstanceListTypeUnicodedefaultobserve) Configurablecatch_config_error) import_item) __version__ exporterspostprocessors preprocessorswriters)indent)get_export_names get_exporter) NbConvertBase)ConversionException)unicode_stdin_streamc&eZdZdZdZfdZxZS) DottedOrNonezjA string holding a valid dotted object name in Python, such as A.b3._c Also allows for None type. cv|5t|dkr"t||S|S)zValidate an input.Nr)lensupervalidate)selfobjvalue __class__s V/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/nbconvert/nbconvertapp.pyr&zDottedOrNone.validate,s6  Ua77##C// / )__name__ __module__ __qualname____doc__ default_valuer& __classcell__r*s@r+r!r!%sIMr,r!zNbConvertApp.export_formatzTemplateExporter.template_namezTemplateExporter.template_filezHTMLExporter.themezHTMLExporter.sanitize_htmlzNbConvertApp.writer_classz NbConvertApp.postprocessor_classzNbConvertApp.output_basezFilesWriter.build_directoryz SlidesExporter.reveal_url_prefixz!NotebookExporter.nbformat_version) totemplatez template-filetheme sanitize_htmlwriterpostoutputz output-dirz reveal-prefixnbformatExecutePreprocessorenabledTz%Execute the notebook prior to export. 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_class StdoutWriterz1Write notebook output to stdout instead of files.Fnotebook)use_output_suffix export_formatbuild_directoryr")r? FilesWriterztRun nbconvert in place, overwriting the existing notebook (only relevant when converting to notebook format))r?rGClearOutputPreprocessorz[Clear output of current file and save in place, overwriting the existing notebook. )r?rGCoalesceStreamsPreprocessorzRCoalesce consecutive stdout and stderr outputs into one stream (within each cell).TemplateExporter)exclude_input_promptexclude_output_promptz9Exclude input and output prompts from converted document.)rL exclude_inputrKz|Exclude input cells and output prompts from converted document. This mode is ideal for generating code-free reports.WebPDFExporterallow_chromium_downloadzTWhether to allow downloading chromium if no suitable version is found on the system.disable_sandboxz:Disable chromium security sandbox when converting to PDF..rMzr?zAApplication used to convert from notebook file type (``*.ipynb``)zjupyter-nbconvert log_levelctjSN)loggingINFOr's r+_log_level_defaultzNbConvertApp._log_level_defaults |r,classesctg}ttttfD]c}t |D]Q}t ||}t|tr*t|tr| |Rd|SrZ) rrrrrdirgetattr isinstancetype issubclassrappend)r'r_pkgnameclss r+_classes_defaultzNbConvertApp._classes_defaults&3_}g~F ( (CC ( (c4((c4(((Z\-J-J(NN3''' ( r,zThis application is used to convert notebook files (*.ipynb) to various other formats. WARNING: THE COMMANDLINE INTERFACE MAY CHANGE IN FUTURE RELEASES.{notebook_name}zsOverwrite base name use for output files. Supports pattern replacements '{notebook_name}'. )helpTconfigzWhether 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 basename.z The simplest way to use nbconvert is > jupyter nbconvert mynotebook.ipynb --to html Options include aG. > jupyter nbconvert --to latex mynotebook.ipynb Both HTML and LaTeX support multiple output templates. LaTeX includes 'base', 'article' and 'report'. HTML includes 'basic', 'lab' and 'classic'. You can specify the flavor of the format used. > jupyter nbconvert --to html --template lab 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.)rl allow_nonerGz\Writer class used to write the results of the conversionz#nbconvert.writers.files.FilesWriterz#nbconvert.writers.debug.DebugWriterz%nbconvert.writers.stdout.StdoutWriter) fileswriter debugwriter stdoutwriter)rorAc|d}||jvr|j|}t||_dSNnew)lowerwriter_aliasesrwriter_factoryr'changerus r+_writer_class_changedz"NbConvertApp._writer_class_changed3sLUm 99;;$- - -%ciikk2C)#..r,z/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 conversionservez1nbconvert.postprocessors.serve.ServePostProcessorNpostprocessor_classc|d}||jvr|j|}|rt||_dSdSrt)rvpostprocessor_aliasesrpostprocessor_factoryrys r+_postprocessor_class_changedz)NbConvertApp._postprocessor_class_changedIs^Um 99;;$4 4 4,SYY[[9C  :)4S)9)9D & & & : :r,FzIThe export format to be used, either one of the built-in formats zb or a dotted object name that represents the import path for an ``Exporter`` class)rorlzList of notebooks to convert. Wildcards are supported. Filenames passed positionally will be added to the list. z"read a single notebook from stdin.z  / /G!Ig9LMMMM  7X+=I\!]!]!] ^ ^ ^  I  !>HHH) / /9,,$$X... /#r,c|d|ji|jrI|||_t |jdr|jjdkr d|_dSdSdSdS)z*Initialize the writer (which is stateless)ruparentrFr"FN)r{rArxr8rrFrDr]s r+rzNbConvertApp.init_writers ""E4+<#=>>>   /--T-::DKt{$566 /4;;VZ\;\;\).&&& / / / /;\;\r,c|d|ji|jr|||_dSdS)z1Initialize the postprocessor (which is stateless)rurN)rr}r postprocessorr]s r+rzNbConvertApp.init_postprocessorsU ))5$2J*KLLL  % I!%!;!;4!;!H!HD    I Ir,cpt|dS)z4Run start after initialization process has completedN)r%startconvert_notebooks)r'r*s r+rzNbConvertApp.starts,        r,ctj|}|d|d}|j|}|S)z Returns the notebook name from the notebook filename by applying `output_base` pattern and stripping extension N. notebook_name)rrbasenamerfind output_baseformat)r'notebook_filenamerrs r+_notebook_filename_to_namez'NbConvertApp._notebook_filename_to_namesU 7##$566 !68>>##6#6!67 (//m/LL r,c||}|jd|i}|j|d<||d<|j|}||d<|S)aStep 1: Initialize resources This initializes the resources dictionary for a single notebook. Returns ------- dict resources dictionary for a single notebook that MUST include the following keys: - config_dir: the location of the Jupyter config directory - unique_key: the notebook name - output_files_dir: a directory where output files (not including the notebook itself) should be saved zNotebook name is '%s' config_dir unique_keyroutput_files_dir)rrdebugrrr)r'rr resourcesrs r+init_single_notebook_resourcesz+NbConvertApp.init_single_notebook_resourcessw778IJJ  . >>> "&/ ,"/ ,077m7TT(8 $%r,c | |j||\}}n|j||\}}nB#t$r5|jd|d|dYnwxYw||fS)aTStep 2: Export the notebook Exports the notebook to a particular format according to the specified exporter. This function returns the output and (possibly modified) resources from the exporter. Parameters ---------- notebook_filename : str name of notebook file. resources : dict input_buffer : readable file-like object returning unicode. if not None, notebook_filename is ignored Returns ------- output dict resources (possibly modified) N)rzError while converting '%s'T)exc_infor)exporter from_file from_filenamerrerrorexit)r'rr input_bufferr:s r+export_single_notebookz#NbConvertApp.export_single_notebooks, '$(M$;$;LT]$;$^$^! $(M$?$?%%@%%! #    HNN8:KVZN [ [ [ IIaLLLLL y  sAAtj|j\}}||j jkr||_|js!|jD]}||d St'}|d||d S) z4Convert the notebooks in the self.notebooks traitletrz[Please specify an output format with '--to '. The following formats are available: rmfile_extensionFznotebook.ipynbrN)r$rr@ print_helprrrErrrrnrrbrrsplitextrrrrclose)r'rribaseextrrs r+rzNbConvertApp.convert_notebooks9sn t~  ! # #DO # OO    HRLLL! "O:J:L:LOO S// !4-..4;///  4="2E : : ((()9::ID#dm222#'  !%)^ @ @!,,->???? @ @011L  ( ()9 ( U U U    r,c  d}|jD]f\}\}}||dz }|tt|ddzz }|ttdt |zddzz }g|S)zK Return a string containing descriptions of all the flags. z"The following flags are defined:  Pz z Long Form: )flagsitemsrrstr)r'rflagcfgfhelps r+document_flag_helpzNbConvertApp.document_flag_help\s7"&*"2"2"4"4 I I D,3 [[[ E VDOO,,v5 5E VDS!92>>??&H HEE r,c`d}|jD]\}}|d|d|dz }|S)z-Return a string containing all of the aliasesz$The following aliases are defined: z **z** (z) )aliasesr)r'raliaslongnames r+document_alias_helpz NbConvertApp.document_alias_helpgsO;#|1133 9 9OE8 8e88888 8GGr,cfddD}d|DfdD|d<td}d}|D]b}|||z }|d vr |d |d z }|d d ||Dz }c|ddS)z Provides a much improves version of the configuration documentation by breaking the configuration options into app, exporter, writer, preprocessor, postprocessor, and other sections. cTi|]#fdD$S)cJg|]}|jv| S)r-rv).0ccategorys r+ zCNbConvertApp.document_config_options...vs1```QQZM]M]M_M_A_A_qA_A_A_r,)_classes_inc_parents)rrr's @r+ z8NbConvertApp.document_config_options..usM    ````$";";"="=```   r,)apprr8 preprocessorrch|] }|D]}| Srr)rrrs r+ z7NbConvertApp.document_config_options..ys%QQQxQQ1QQQQr,cg|]}|v| Srr)rr accounted_fors r+rz8NbConvertApp.document_config_options..zs$```QR_I_I_qI_I_I_r,otherzt {section} Options ----------------------- r")section)rrr8z.. image:: _static/z_inheritance.png rc3>K|]}|VdSrZ)class_config_rst_doc)rrs r+ z7NbConvertApp.document_config_options..s.!Y!Yq!"8"8":":!Y!Y!Y!Y!Y!Yr,z : z \: )valuesrrrtitlejoinreplace)r' categoriesheadersectionsrrs` @r+document_config_optionsz$NbConvertApp.document_config_optionsos*     Z   RQ:+<+<+>+>QQQ ````$*C*C*E*E``` 7   " Z ZH  hnn.>.> ?? ?HAAAP(PPPP  !Y!YJxDX!Y!Y!YYY YHHw///r,rZ)>r-r.r/r0rversionrhnbconvert_aliasesrnbconvert_flagsrrr^r r_rjr descriptiontagrr rDrrexamplesr r8r rArwr rxrr{rr!r}rrrrErr@rrrrrrrrrrrrrrrrrr r2r3s@r+r?r?sKKG DG E W[dffG WY' MK'  cc  :  cc w  cc w& *)++ & & & ((HVX+4 F $#A cc  =<?N TT***N W^///H94 M',A cc%&YZ D$777 W "##::$#:G      cc    cc e"FGGGKKSWKXXJT R cc " " " " " "(((###6///III !!!!!   8!!!!!!!!FQQQ@ . . .8888r/s#"""""  !!!!!!!!IIIIIIIIII]]]]]]]]]]]]]]]]]]]]========444444TTTTTTTTTTTTTT''''''::::::::%%%%%%111111******     #   &&&*49%5-2,3;7   z"""#Y$5 6 3 #^T$: ;F  $!  v  nn= > ? */%/!!!226    8  */%/!!!226,5t+<    /  7