IPython/nbconvert/transformers/convertfigures.py

"""Module containing a transformer that converts outputs in the notebook from 
one format to another.
"""
#-----------------------------------------------------------------------------
# Copyright (c) 2013, the IPython Development Team.
#
# Distributed under the terms of the Modified BSD License.
#
# The full license is in the file COPYING.txt, distributed with this software.
#-----------------------------------------------------------------------------

#-----------------------------------------------------------------------------
# Imports
#-----------------------------------------------------------------------------

from .base import ConfigurableTransformer
from IPython.utils.traitlets import Unicode

#-----------------------------------------------------------------------------
# Classes
#-----------------------------------------------------------------------------

class ConvertFiguresTransformer(ConfigurableTransformer):
    """
    Converts all of the outputs in a notebook from one format to another.
    """

    from_format = Unicode(config=True, help='Format the converter accepts')
    to_format = Unicode(config=True, help='Format the converter writes')

    def __init__(self, **kw):
        """
        Public constructor
        """
        super(ConvertFiguresTransformer, self).__init__(**kw)


    def convert_figure(self, data_format, data):
        raise NotImplementedError()


    def transform_cell(self, cell, resources, cell_index):
        """
        Apply a transformation on each cell,
        
        See base.py
        """

        #Loop through all of the datatypes of the outputs in the cell.
        for index, cell_out in enumerate(cell.get('outputs', [])):
            for data_type, data in cell_out.items():

                #Get the name of the file exported by the extract figure 
                #transformer.  Do not try to convert the figure if the extract
                #fig transformer hasn't touched it
                filename = cell_out.get(data_type + '_filename', None)
                if filename:
                    figure_name = filename[:filename.rfind('.')]
                    self._convert_figure(cell_out, figure_name, resources, data_type, data)
        return cell, resources


    def _convert_figure(self, cell_out, resources, figure_name, data_type, data):
        """
        Convert a figure and output the results to the cell output
        """

        if not self.to_format in cell_out:
            if data_type == self.from_format:
                filename = figure_name + '.' + self.to_format
                if filename not in resources['figures']:

                    #On the cell, make the figure available via 
                    #   cell.outputs[i].pdf_filename  ... etc (PDF in example)
                    cell_out[self.to_format + '_filename'] = filename

                    #In the resources, make the figure available via
                    #   resources['figures']['filename'] = data
                    resources['figures'][filename] = self.convert_figure(data_type, data)