Metadata-Version: 1.0
Name: collective.recipe.template
Version: 1.0
Summary: Buildout recipe to generate a text file from a template
Home-page: UNKNOWN
Author: Wichert Akkerman
Author-email: wichert@wiggy.net
License: BSD
Description: Introduction
        ============
        
        This recipe can be used to generate textfiles from a (text) template.
        
        A short example::
        
        [buildout]
        parts = zope.conf
        
        [message]
        recipe = collective.recipe.template
        input = templates/message.in
        output = /message
        
        mymessage = Hello, World!
        
        
        In the template you can use the exact same variables as you can use
        in the buildout configuration. For example an input file can look like this::
        
        My top level directory is ${buildout:directory}
        Executables are stored in ${buildout:bin-directory}
        
        
        As an extension to the buildout syntax you can reference variables from
        the current buildout part directly. For example::
        
        My message is: ${mymessage}
        
        
        Why another template recipe?
        ----------------------------
        
        Both `iw.recipe.template`_ and `inquant.recipe.textfile`_ claim to do the
        same thing. I have found them to be undocumented and too buggy for real
        world use, and neither are in a public repository where I could fix them. In
        addition this implementation leverages the buildout variable substitution
        code, making it a lot simpler.
        
        
        .. _iw.recipe.template: http://pypi.python.org/pypi/iw.recipe.template
        .. _inquant.recipe.textfile: http://pypi.python.org/pypi/inquant.recipe.textfile
        
        Changelog
        =========
        
        1.0 - 2008-10-16
        ----------------
        
        * Copy the mode of the input file to the output file. This makes it possible
        to create executable scripts.
        [wichert]
        
        * Add missing link in README.
        [wichert]
        
        
        1.0rc2 - 2008-07-04
        -------------------
        
        * Add a MANIFEST.in with instructions to include docs/, otherwise the package
        will not install.
        [wichert]
        
        
        1.0rc1 - 2008-07-04
        -------------------
        
        * Initial release.
        [wichert]
        
        
Platform: UNKNOWN
Classifier: Framework :: Buildout
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
