=================
 Buildout recipe
=================

.. :doctest:
.. :setup: createzopecoverage.testing.recipeSetUp
.. :teardown: createzopecoverage.testing.recipeTearDown

There is a recipe to ease buildout integration.

Default configuration
=====================

In the default configuration the recipe name is sufficiant in the
buildout section:

>>> write(sample_buildout, 'buildout.cfg',
... """
... [buildout]
... parts = czc
...
... [czc]
... recipe = createzopecoverage
... """)

After running buildout the script gets created in the `bin` directory, it is
named like the section:

>>> import os, os.path
>>> os.chdir(sample_buildout)
>>> buildout = os.path.join(sample_buildout, 'bin', 'buildout')
>>> print system(buildout),
Installing czc.
Generated script '/.../sample-buildout/bin/czc'.
>>> ls('bin')
-  buildout
-  czc

>>> cat(os.path.join(sample_buildout, 'bin', 'czc'))
#!...
import createzopecoverage.script
<BLANKLINE>
if __name__ == '__main__':
    createzopecoverage.script.main()
