Metadata-Version: 1.0
Name: templer.core
Version: 1.0b1
Summary: Core functionality for the templer tool
Home-page: http://svn.plone.org/svn/collective/
Author: Cris Ewing
Author-email: cewing@sound-data.com
License: GPL version 2
Description: .. contents::
        
        Introduction
        ============
        
        This package provides the core functionality of the templer code generation
        system.  Included are a base template class, utility scripts, the templer
        command-line wrapper and basic templates for namespace packages, nested
        namespace packages and buildout recipes.
        
        All functionality of the templer system is inherited from and extends
        PasteScript_ templates.  Templates can be generated using the syntax of that
        package, but the templer system provides a wrapper script to make it easier
        for developers to generate packages.
        
        .. _PasteScript: http://pythonpaste.org/script/
        
        templer script
        --------------
        
        This package provides a script, ``templer``. The script acts as a wrapper for
        PasteScript's ``paster create``, hiding the newbie-error-prone syntax ff that
        command. The ``templer`` script also provides some inline error-checking for
        project names and other variables as well as additional help. It is recommended
        to use this script--especially for new users--rather than using ``paster create``
        directly. (The resulting packages produced, however, will be the same).
        
        For example, to create a new basic namespace package invoke the script like so::
        
        templer basic_namespace
        
        This will prompt you to provide a name for your package.  The name you provide
        will be validated to ensure that it fits with the number of namespaces expected
        by the template you have chosen.
        
        Once you have set the name for your new package, You will be asked to choose a
        set of questions to answer.  By default, only the 'easy' questions are selected,
        allowing you to create a new package with a minimum of interaction.  However,
        you may choose the ``expert`` set, or even choose to answer ``all`` questions
        if you need more control over the final output of your package.
        
        At any time in the question-and-answer process, you may type a ``?`` at the
        prompt to recieve in-line assistance with the current question.
        
        Additional Script Functions
        ---------------------------
        
        In addition to interactively generating code, the templer script provides a
        number of other useful functions:
        
        ``zopskel --help``
        provides full listings of the help text for the templer script.
        
        ``templer --list``
        provides a detailed list of the available templates
        
        ``templer --version``
        provides the version number of the currently installed templer package
        
        Testing
        =======
        
        This package provides both unit tests for code functions and doctests for each
        of the provided templates.  If you make changes to the package, you must ensure
        that these tests run successfully before checking them in.  Please also
        contribute tests for any code you create.  To run the tests, execute the
        following::
        
        $ python setup.py test
        
        
        Contributors
        ============
        
        - Cris Ewing, original author
        
        Based on code from zopeskel, contributors to which include:
        
        - Daniel Nouri
        - Tarek Ziade
        - Mustapha Benali
        - Sylvain Viollon
        - Alan Hoey
        - Josh Johnson
        - Emanuel Sartor
        - Matthew Wilkes
        - Joel Burton
        - Cris Ewing
        - Chris Calloway
        - Chris Rossi
        
        Changelog
        =========
        
        1.0b1 December 1, 2010
        ----------------------
        
        - Added structure system for better isolation of shared structural elements and
        improved maintainability
        [Cris Ewing]
        
        - Namespace for package changed to 'templer' to promote use by systems outside
        the Zope world
        [Cris Ewing]
        
        - Ported basic_namespace, nested_namespace and recipe templates over from
        zopeskel package to create core of new templer system (see
        http://svn.plone.org/svn/collective/ZopeSkel/trunk/SPLITTING-PROPOSAL.txt for
        the rationale behind this move)
        [Cris Ewing]
        
        - Package created by ZopeSkel
        [Cris Ewing]
        
        
Keywords: web zope command-line skeleton project
Platform: Any
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Zope2
Classifier: Framework :: Zope3
Classifier: Framework :: Plone
Classifier: Framework :: Buildout
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.4
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Code Generators
