Metadata-Version: 1.0
Name: iw.recipe.template
Version: 0.2
Summary: ZC buildout recipe to build template based file
Home-page: UNKNOWN
Author: Ingeniweb
Author-email: support@ingeniweb.com
License: GPL
Description: ==========================
        iw.recipe.template package
        ==========================
        
        .. contents::
        
        What is iw.recipe.template ?
        ============================
        
        iw.recipe.template is a zc.buildout recipe to build template based
        file/scripts
        
        It also provide some recipe to build Zope2, Zope3 and Squid vhosts config
        file for apache.
        
        How to use iw.recipe.template ?
        ===============================
        
        We need a buildout config file::
        
        >>> server = start_server(test_dir)
        
        >>> write(sample_buildout, 'buildout.cfg',
        ... """
        ... [buildout]
        ... parts = template.txt
        ...
        ... [template.txt]
        ... recipe = iw.recipe.template
        ... source = %s/template.txt_impl
        ... destination = %s/
        ... """ % (sample_buildout, sample_buildout))
        
        And a template::
        
        >>> template = join(sample_buildout, 'template.txt_impl')
        >>> open(template, 'w').write('''My template is named "$name"''')
        
        
        Then, the recipe should work::
        
        >>> print system(buildout)
        Installing template.txt.
        template.txt: Generated file 'template.txt'.
        
        Here is the result::
        
        >>> print open(join(sample_buildout, 'template.txt')).read()
        My template is named "template.txt"
        
        
        Now we can generate an executable::
        
        >>> write(sample_buildout, 'buildout.cfg',
        ... """
        ... [buildout]
        ... parts = script
        ...
        ... [script]
        ... recipe = iw.recipe.template:script
        ... source = %s/template.py_impl
        ... destination = %s/
        ... """ % (sample_buildout, sample_buildout))
        
        
        We need a small template with a python script::
        
        >>> template = join(sample_buildout, 'template.py_impl')
        >>> open(template, 'w').write('''
        ... import sys
        ... print 'this is the script named "$name"'
        ... ''')
        
        Run buildout again::
        
        >>> print system(buildout)
        Uninstalling template.txt.
        Installing script.
        script: Generated script 'script'.
        
        Here is the result::
        
        >>> print open(join(sample_buildout, 'script')).read()
        #!/.../bin/python
        <BLANKLINE>
        import sys
        print 'this is the script named "script"'
        <BLANKLINE>
        
        >>> print system(join(sample_buildout, 'script'))
        this is the script named "script"
        
        
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
