source: products/quintagroup.transmogrifier/trunk/quintagroup/transmogrifier/exportadapters.txt @ 275

Export adapters section
=======================

The export adapters section blueprint name is
``quintagroup.transmogrifier.exportadapters``.

Export adapters needs at least 2 piece of information: the path to the object
to update and data dictionary which determine, what adapters will be queried and
what data they will consume. To determine the path, the marshall section inspects
each item and looks for one key, as described below. Any item missing this piece of
information will be skipped. Similarly, items with a path that doesn't exist
or without data dictionary will be skipped too.

Paths to objects are always interpreted as relative to the context.

>>> exportadapters = """
... [transmogrifier]
... pipeline =
...     exportadapterssource
...     exportadapters
...     printer
...     
... [exportadapterssource]
... blueprint = quintagroup.transmogrifier.tests.exportadapterssource
... 
... [exportadapters]
... blueprint = quintagroup.transmogrifier.exportadapters
... data-key = _files
... 
... [printer]
... blueprint = collective.transmogrifier.sections.tests.pprinter
... 
... """
>>> registerConfig(u'quintagroup.transmogrifier.tests.exportadapters', exportadapters)
>>> transmogrifier(u'quintagroup.transmogrifier.tests.exportadapters') # doctest: +ELLIPSIS, +REPORT_NDIFF
{'_files': {'unchanged': 'this must be unchanged', 'mock': 'modified data'},
 '_path': 'spam/eggs/foo'}
{'_path': 'not/existing/bar'}
{}
{'_files': {'mock': "item hasn't path"}}
{'_files': {'mock': "object isn't adaptable"},
 '_path': 'spam/eggs/notadaptable'}