Metadata-Version: 1.1
Name: Projy
Version: 0.4.1
Summary: Projy is a template-based skeleton generator.
Home-page: http://stephanepechard.github.com/projy
Author: Stéphane Péchard
Author-email: stephanepechard@gmail.com
License: UNKNOWN
Description: Projy
        =====
        
        **Projy is a template-based skeleton generator**. In one command line,
        you can generate project skeletons like Python packages, LaTeX document
        or any file structure composed of directories and files.
        
        Each file is generated by a different template. It uses the simple core
        templating system from Python, nothing fancy on that part. You can
        easily add new templates and new ways to collect data to insert in the
        created files. As much as possible, Projy tries to be simple to use and
        extend.
        
        See `the complete documentation <http://projy.readthedocs.org/>`__.
        
        Installation
        ============
        
        If you are familiar with Python, it is strongly suggested that you
        install Projy in
        `virtualenv <http://pypi.python.org/pypi/virtualenv>`__.
        
        Pip and Distribute
        ------------------
        
        If you are on Linux or Mac OS X, just type:
        
        ::
        
            $ sudo pip install projy
        
        If no pip available, try ``easy_install``:
        
        ::
        
            $ sudo easy_install projy
        
        Install from git
        ----------------
        
        If you prefer git, that is ok too. You can get the very latest code at
        Github:
        
        ::
        
            $ git clone http://github.com/stephanepechard/projy
        
        Usage
        =====
        
        As an example, let's create a Python package. The Projy template mostly
        follows recommendations from `The Hitchhiker's Guide to
        Packaging <http://guide.python-distribute.org/>`__.
        
        A simple example
        ----------------
        
        Use simply:
        
        ::
        
            $ projy PythonPackage TowelStuff
        
        In the same directory as you typed this command, you now have a
        *TowelStuff* directory, with the following structure:
        
        ::
        
            TowelStuff/
                bin/
                bootstrap
                CHANGES.txt
                docs/
                    index.rst
                LICENSE.txt
                MANIFEST.in
                README.txt
                setup.py
                towelstuff/
                    __init__.py
        
        Each file has been created with a specific template, so the package is
        fully functional, yet empty. You can find `further information
        here <http://guide.python-distribute.org/creation.html>`__.
        
        Specify substitutions
        ---------------------
        
        You can specify template substitutions directly from the command line.
        Add them at the end of the previous example:
        
        ::
        
            $ projy PythonPackage TowelStuff "author,Emmett Brown" "date,1851-09-24"
        
        Then the substitutes *author* and *date* (defaulted to the current day)
        are defined by the given values, not those computed by Projy. The format
        of such substitutions should be "key,value". Neither the key or the
        value should therefore include a comma. Leading and trailing spaces are
        removed from both key and value.
        
        To know which substitutions can be overwritten this way, use the *-i*
        option as described in the dedicated section. You can add substitutions
        that are not listed with the *-i* but they won't have any effect if the
        template file does not consider them.
        
        Options
        -------
        
        Projy comes with some command line options. Type:
        
        ::
        
            $ projy -l
        
        and you'll see the list of available templates in your installation.
        That's an easy way to copy/paste the name of the template you want to
        use next.
        
        Type
        
        ::
        
            $ projy -i PythonPackage
        
        and you'll see the details of the Python package template. It shows the
        created directories and files, with the substitutions included in the
        template.
        
        Available templates
        ===================
        
        The currently available templates are:
        
        -  a full `Django <http://djangoproject.com>`__ project, following most
           of the recommandations from `Two scoops of
           Django <https://2scoops.org/>`__ ;
        -  a `Fabric <http://fabfile.org>`__ file ;
        -  a `LaTeX <http://www.latex-project.org/>`__ book ;
        -  a `Python <http://python.org/>`__ package ;
        -  a Python script ;
        -  a `Projy <https://github.com/stephanepechard/projy>`__ template,
           meta-style.
        -  a bootstrap file, to manage your virtualenv happiness.
        
        See the official doc for more details on created files into these
        templates. Soon to come, more templates around Django. Of course, anyone
        can propose some templates, they'll be integrated into Projy.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: System :: Software Distribution
Classifier: Topic :: System :: System Shells
Classifier: Topic :: Utilities
