ó §‰]c@@s}dZddlmZmZddlZddlZddlZddlmZm Z m Z m Z m Z m Z mZddlmZddlmZddlmZddlmZdd lmZdd lmZmZmZmZmZmZdd l m!Z!d d l"m#Z#dgZ$ie!j%d6e!j&d6e!j'd6e!j(d6e!j)d6e!j*d6e!j+d6e!j,d6e!j-d6e!j.d6e!j/d6e!j0d6e!j1d6e!j2d6e!j3d6e!j4d6e!j5d6e!j6d 6e!j7d!6e!j8d"6e!j9d#6e!j:d$6e!j;d%6e!j<d&6e!j=d'6e!j>d(6e!j?d)6e!j@d*6ejAd+6e!jBd,6ZCd-efd.„ƒYZDd/e#fd0„ƒYZEdS(1sˆThis module defines TemplateExporter, a highly configurable converter that uses Jinja2 to export notebook files into different formats. i(tprint_functiontabsolute_importN(t HasTraitstUnicodetListtDicttBooltdefaulttobserve(tConfig(t import_item(t py3compat(t jupyter_path(tensure_dir_exists(tTemplateNotFoundt Environmentt ChoiceLoadertFileSystemLoadert BaseLoadert DictLoader(tfiltersi(tExportersjinja2.ext.loopcontrolstindentt markdown2htmltmarkdown2asciidoct ansi2htmltfilter_data_typet get_linesthighlight2htmlthighlight2latextipython2pythont posix_pathtmarkdown2latext markdown2rstt comment_linest strip_ansit strip_dollarststrip_files_prefixt html2textt add_anchort ansi2latext wrap_textt escape_latextcitation2latextpath2urlt add_promptst ascii_onlytprevent_list_blockst get_metadatatconvert_pandoct json_dumpststrip_trailing_newlinetExtensionTolerantLoadercB@s)eZdZd„Zd„Zd„ZRS(sNA template loader which optionally adds a given extension when searching. Constructor takes two arguments: *loader* is another Jinja loader instance to wrap. *extension* is the extension, which will be added to the template name if finding the template without it fails. This should include the dot, e.g. '.tpl'. cC@s||_||_dS(N(tloadert extension(tselfR5R6((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyt__init__Hs cC@sgy|jj||ƒSWnItk rb|j|jƒrHt|ƒ‚n|jj|||jƒSXdS(N(R5t get_sourceRtendswithR6(R7t environmentttemplate((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyR9Ls  cC@s |jjƒS(N(R5tlist_templates(R7((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyR=Ts(t__name__t __module__t__doc__R8R9R=(((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyR4@s  tTemplateExportercB@seZdZejdddjeejƒƒƒƒZd4Z d4d„Z e d„ƒZ d4Z d4d„Ze d„ƒZe d„ƒZed d ƒjd ed eƒZed d dƒjdeƒZd ZdZedƒd„ƒZedƒd„ƒZedƒd„ƒZedƒjd eƒZedgƒjd edeƒZee j!jddƒd dƒjdeƒZ"ee j!jdddƒd dƒjdeƒZ#ee$ddƒd dƒjdeƒZ%edƒjd edeƒZ&e'e(d d ƒjd eƒZ)e'e(d d!ƒjd eƒZ*e'e(d d"ƒjd eƒZ+e'e(d d#ƒjd eƒZ,e'e(d d$ƒjd eƒZ-e'e(d d%ƒjd eƒZ.e'e(d d&ƒjd eƒZ/e'e(d d'ƒjd eƒZ0ed d(ƒjdeƒZ1e2d d)ƒjd edeƒZ3ed d*ƒjd eƒZ4ed+ƒd,„ƒZ5d4d-„Z6d.„Z7d4d/„Z8d0„Z9d1„Z:d2„Zd3„Z;RS(5sá Exports notebooks into other file formats. Uses Jinja 2 templating engine to output new formats. Inherit from this class if you are creating a new template type along with new filters/preprocessors. If the filters/ preprocessors provided by default suffice, there is no need to inherit from this class. Instead, override the template_file and file_extension traits via a config file. Filters available by default for templates: {filters} Rs- s - cC@s d|_dS(N(tNonet_template_cached(R7tchange((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyt_invalidate_template_cachelscC@s(|jdkr!|jƒ|_n|jS(N(RCRBt_load_template(R7((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyR<oscC@sd|_|jƒdS(N(RBt_environment_cachedRE(R7RD((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyt_invalidate_environment_cachews cC@s(|jdkr!|jƒ|_n|jS(N(RGRBt_create_environment(R7((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyR;{scC@sEtiitd6d6itd6d6ƒ}|jtt|ƒjƒ|S(NtenabledtRegexRemovePreprocessortTagRemovePreprocessor(R tTruetmergetsuperRAtdefault_config(R7tc((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyRPs thelps Name of the template file to usetconfigtaffects_templatetsraw template stringtaffects_environmentst template_filecC@s¶|d}|dkr&|j|_dStjj|ƒ}tjj|ƒr²tjj|ƒ\}}|g|jD]}tjj|ƒ^qokr¦|g|j|_n||_ndS(NtnewR(tdefault_templateRWtostpathtabspathtisfiletsplitt template_path(R7RDRXt full_patht template_dirRWtp((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyt_template_file_changed—s   .cC@s|jS(N(RY(R7((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyt_template_file_default¦st raw_templatecC@s0|ds"|jp|j|_n|jƒdS(NRX(RYt_last_template_fileRWRE(R7RD((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyt_raw_template_changedªs ut.s..t templatess*Path where the template files are located.tskeletons3Path where the template skeleton files are located.t nbconverts*Path where templates can be installed too.s.tplsNThis allows you to exclude code cell inputs from all templates if set to True.sKThis allows you to exclude input prompts from all templates if set to True.sOThis allows you to exclude code cell outputs from all templates if set to True.sLThis allows you to exclude output prompts from all templates if set to True.sHThis allows you to exclude code cells from all templates if set to True.sLThis allows you to exclude markdown cells from all templates if set to True.sGThis allows you to exclude raw cells from all templates if set to True.sKThis allows you to exclude unknown cells from all templates if set to True.s[Jinja loaders to find templates. Will be tried in order before the default FileSystem ones.sVDictionary of filters, by name and namespace, to add to the Jinja environment.s>formats of raw cells to be included in this Exporter's output.t raw_mimetypescC@s |jdgS(NRU(toutput_mimetype(R7((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyt_raw_mimetypes_defaultôscK@sjtt|ƒjd|||j|jt|jdtƒƒƒ|j|jt|jdtƒƒƒdS(s” Public constructor Parameters ---------- config : config User configuration instance. extra_loaders : list[of Jinja Loaders] ordered list of Jinja loader to find templates. Will be tried in order before the default FileSystem ones. template : str (optional, kw arg) Template to use when exporting. RSRVRTN( RORAR8RRHtlistttraitsRMRE(R7RStkw((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyR8ùs   cC@s²|jƒ>|j|jkr.|j|_n|jrF|j|_nWdQX|jsdtdƒ‚n|j}|jjd|ƒ|jjdtj j |j ƒƒ|j j |ƒS(s’Load the Jinja template object from the template file This is triggered by various trait changes that would change the template. NsNo template_file specified!sAttempting to load template %ss template_path: %s(thold_trait_notificationsRWt_raw_template_keyRfRet ValueErrortlogtdebugRZtpathseptjoinR_R;t get_template(R7RW((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyRFs    "cK@sàtt|ƒj|||\}}|jd|jƒi |j d6|j d6|j d6|j d6|j d6|j d6|j d6|j d 6|j o¡|j d 6|d <|j jd |d |ƒ}|jdƒ}||fS(s/ Convert a notebook from a notebook node instance. Parameters ---------- nb : :class:`~nbformat.NotebookNode` Notebook node resources : dict Additional resources that can be accessed read/write by preprocessors and filters. Rlt include_codetinclude_markdownt include_rawtinclude_unknownt include_inputtinclude_outputtinclude_input_prompttinclude_output_promptt no_prompttglobal_content_filtertnbt resourcess (RORAtfrom_notebook_nodet setdefaultRltexclude_code_celltexclude_markdownt exclude_rawtexclude_unknownt exclude_inputtexclude_outputtexclude_input_prompttexclude_output_promptR<trendertlstrip(R7R„R…Rqtnb_copytoutput((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyR†'s $        cC@sý|dkrtdƒ‚nt|tƒ}| }|rht|tjƒrht|ƒ}|j|||ƒS|rŽt|dƒrŽ||j |<|S|rÈt |t ƒrÈ|d|ƒ}|j|||ƒn1|rí|ƒ}|j|||ƒn tdƒ‚dS(s9 Register a filter. A filter is a function that accepts and acts on one string. The filters are accessible within the Jinja templating engine. Parameters ---------- name : str name to give the filter in the Jinja engine filter : filter tfiltert__call__tparentN( RBt TypeErrort isinstancettypeR t string_typesR t_register_filterthasattrRt issubclassR(R7tenvirontnamet jinja_filtertisclasst constructedt filter_clstfilter_instance((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyR›Fs"    cC@s|j|j||ƒS(s9 Register a filter. A filter is a function that accepts and acts on one string. The filters are accessible within the Jinja templating engine. Parameters ---------- name : str name to give the filter in the Jinja engine filter : filter (R›R;(R7RŸR ((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pytregister_filterss cC@s tjƒS(s|Override in subclasses to provide extra filters. This should return an iterable of 2-tuples: (name, class-or-function). You should call the method on the parent class and include the filters it provides. If a name is repeated, the last filter provided wins. Filters from user-supplied config win over filters provided by classes. (tdefault_filterstitems(R7((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyR¦s c C@sqtjjtjjtƒƒ}|j}x6|D].}yt|ddƒWq.tk r[q.Xq.W|j|tjj ||j ƒtjj ||j ƒg}|j t t|ƒ|jƒti|j|j6ƒg}tdt|ƒdtƒ}tj|jdR?R@tformatRxtsortedR¦tkeysRBRCREtpropertyR<RGRHR;RPRttagRMRWReRfRsRRcRRdRgRYRR_RZR[R°R±R R®R³RtFalseRŒRŽRRRˆR‰RŠR‹R²RRRlRnR8RFR†R›R¥RI(((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyRAXs–     !                                       -  (FR@t __future__RRRZRµtjsont traitletsRRRRRRRttraitlets.configR ttraitlets.utils.importstringR tipython_genutilsR tjupyter_core.pathsR tjupyter_core.utilsR tjinja2RRRRRRRkRtexporterRR´RRRRtDataTypeFilterRtHighlight2HTMLtHighlight2LatexRRR R!R"R#R$R%R&R'R(R)R*R+R,R-R.R/R0R1tdumpsR3R¦R4RA(((sClib/python2.7/site-packages/nbconvert/exporters/templateexporter.pyts^   4.