Metadata-Version: 1.0
Name: transmogrify.print
Version: 0.5.0
Summary: Transmogrifier blueprint to print pipeline item keys
Home-page: https://github.com/aclark4life/transmogrify.print
Author: Alex Clark
Author-email: aclark@aclark.net
License: UNKNOWN
Description: 
        Introduction
        ============
        
        .. Note:: As of version 1.3 Transmogrifier provides a similar feature, via a blueprint called: ``collective.transmogrifier.sections.logger``.
        
        This `Transmogrifier`_ blueprint is based on ``collective.transmogrifier.sections.tests.PrettyPrinter``, which anyone can use in their project by creating a utility like so::
        
            <utility
                component="collective.transmogrifier.sections.tests.PrettyPrinter"
                name="print" />
        
        Then adding a section to your pipeline like so::
        
            [transmogrifier]
            pipeline =
                …
                print
        
            [print]
            blueprint = print
        
        ``transmogrify.print`` has has two advantages over the above approach:
        
            * It adds the utility for you
            * It allows you to specify a ``keys`` parameter to print individual keys. If no key is provided, it prints the entire item.
        
        .. _`Transmogrifier`: http://pypi.python.org/pypi/collective.transmogrifier
        
        Installation
        ------------
        
        Make sure to require ``transmogrify.print`` in your project, e.g.::
        
            from setuptools import setup
        
            setup(
                name='migrate',
                py_modules=['migrate'],
                install_requires=[
                    'plone.app.transmogrifier',
                    'transmogrify.filesystem',
                    'transmogrify.print',
                ]
            )
        
        Then you may use it in your pipelines, e.g.::
        
            [transmogrifier]
            pipeline =
                data
                constructor
            #    schema 
                print
        
            [constructor]
            blueprint = collective.transmogrifier.sections.constructor
        
            [data]
            blueprint = transmogrify.filesystem
            directory = silly_content
            file-type = Document
        
            [print]
            blueprint = transmogrify.print
            keys = _path
        
            [schema]
            blueprint = plone.app.transmogrifier.atschemaupdater
        
        See: https://github.com/aclark4life/silly_content_import for a working example.
        
        
        Changelog
        =========
        
        0.5.0 (2011-08-30)
        ------------------
        
        * Fix entry point, now targetting ``transmogrify``
          [aclark]
        
        0.4.0 (2011-07-31)
        ------------------
        
        * Note the existence of ``collective.transmogrifier.sections.logger`` which does
          something similar.
          [aclark]
        
        0.3.0 (2011-07-31)
        ------------------
        
        * Fix blueprint name, should be something unique like ``transmogrify.print``
          (instead of ``print``).
          [aclark]
        
        * Show ``keys`` being used in README
          [aclark]
        
        0.2.0 (2011-07-31)
        ------------------
        
        * Fix package data, setup.py missing ``include_package_data``.
          [aclark]
        
        0.1.0 (2011-07-31)
        ------------------
        
        * Initial release
          [aclark]
        
Platform: UNKNOWN
