BlastOff 0.3a2
A Pylons application template providing a working site skeleton configured with SQLAlchemy, mako, repoze.who, ToscaWidgets, TurboMail, WebFlash and (optionally) SchemaBot. The generated app is pre-configured with authentication, login and registration forms, and (optionally) email confirmation.
License: MIT
Keywords: pylons,template,sqlalchemy,toscawidgets,mako,repoze.who,TurboMail,WebFlash,SchemaBot

BlastOff helps accelerate Pylons application development by generating
a project with a number of pre-configured dependencies.

Installation
------------

Use pip::

  $ pip install BlastOff


or use setuptools::

  $ easy_install BlastOff


or old school, download the package from
http://pypi.python.org/pypi/BlastOff, unpack it and run (as root if
required)::

  $ python setup.py install



Usage
-----

Create a new Pylons project from the BlastOff template with::

  $ paster create -t blastoff AppName


You will be prompted for a few options.

1. SQLAlchemy database URL::

    Enter sqlalchemy_url (The SQLAlchemy URL of the database) ['sqlite:///%(here)s/development.db']: 

  Specify the database URL that will be used by SQLAlchemy. Defaults
  to an SQLite database.  For PostgreSQL use something like:: 

    postgres://user:pass@hostname/dbname

2. SchemaBot database schema version control::

    Enter use_schemabot (Enable database schema version control using SchemaBot) [True]: 

  If True then SchemaBot will be used to automatically manage the
  SQLAlchemy database schema.

3. Email confirmation to activate new user accounts::

    Enter email_confirmation (True/False: New users must click activation link from confirmation email) [True]: 

  If True the application will be configured to send a confirmation email
  to the user upon registration.  The email will contain a link for
  activating the account before it can be used.  If False no activation
  confirmation will be configured so users will be able to login
  immediately after registering.

4. Create a default user::

    Enter default_user (Default username to create, password will match username (leave blank for no default user)) ['']:

  To have a default user created when the database is set up enter the
  username here.

After creation the Pylons app is ready to be used.

To ensure all the application dependencies are installed you can run
this command from the application directory::

  $ python setup.py develop

Before starting the app the database needs to be set up (i.e. tables
created).  This is done by using the standard Pylons command::

  $ paster setup-app development.ini

If the SchemaBot option was enabled then a BlastOff generated project
will use SchemaBot to manage database schema changes.  The initial
tables will be created by SchemaBot, the default user inserted if that
option was selected, and the database marked as schema version 1.  See
model/__init__.py within the application source for more information.

To run the application use the standard Pylons command::

  $ paster serve --reload development.ini


Point your browser at the URL http://127.0.0.1:5000/

The generated project contains model and functional tests that can be
run using the "nosetests" command (requires the Nose package to be
installed).


Documentation
-------------

For more information see the BlastOff wiki at
http://bitbucket.org/chrismiles/blastoff/wiki/Home
or the Pylons documentation at http://pylonshq.com/