Usage

Epaster can only really be used within its virtual environment, so you must remember to enable it first:

cd /home/emencia/epaster
source bin/active

Then you can go the path where you want to create your project.

List of available project types

The following command:

paster create --list-templates

will display a list of available project types which you can create:

Available templates:
  basic_package:  A basic setuptools-enabled package
  django:         Django project
  paste_deploy:   A web application deployed through paste.deploy

Create a new project

The Epaster tool is an interactive command. When launched, some questions will be asked for the selection of components and options to be used within the project:

paster create -t django myproject

Install a new project

Once the project has been created by Buildout, it is autonomous of Epaster and you can move it wherever you want. This is the process we recommend (i.e., do not keep it under the Epaster tree).

So, for a newly created project called myproject, you will have to enter it in its directory and just execute the automatic install command from Makefile:

make install

This will install the virtual environment and all required packages using the default config buildout.cfg. When it’s finished, active the virtual environment:

source bin/active

Then if you need to use a specific config, execute it as follows:

buildout -c production.cfg

Generally, the database type used is sqlite3, stored in a database.sqlite3 file at the root directory of your project.

Error with setuptools

Sometimes (when the version of your installed setuptools is too old), python bootstrap.py raises an error such as:

Traceback (most recent call):
File "bootstrap.py", line 159, in <module>
    ws.require(requirement)
File "/home/django/Emencia/epaster/toto/lib/python2.6/site-packages/distribute-0.6.34-py2.6.egg/pkg_resources.py", line 696, in require
    needed = self.resolve(parse_requirements(requirements))
File "/home/django/Emencia/epaster/toto/lib/python2.6/site-packages/distribute-0.6.34-py2.6.egg/pkg_resources.py", line 594, in resolve
    raise DistributionNotFound(req)
pkg_resources.DistributionNotFound: setuptools>=0.7

because the virtual environment inherits it from the setuptools installed on your system. You can fix it manually as follows:

pip install --upgrade setuptools

Note that this is not required if you follow the make install command procedure.

Makefile actions

A Makefile is shipped within a project to include some useful maintenance command actions:

  • help: display this help list;
  • install: to proceed with a new install of this project. Use clean command before if you want to reset a current install;
  • clean: to clean your local repository of all the buildout and instance usage elements;
  • delpyc: to remove all *.pyc files, this is recursive from the current directory;
  • assets: to minify all assets and collect static files;
  • scss: to compile all SCSS elements with compass;
  • syncf5: to synchronize required Javascript files from foundation5 sources dir to the project static files;

It is only used from its location as follows.

You can use it with the following syntax:

make ACTION

Where ACTION is the command action to use, as follows:

make install

Gestus

The Gestus client is embedded in all created projects, its config is automatically generated (in gestus.cfg). You can register your environment with the following command :

gestus register

Remember this should only be used in integration or production environment and you will have to fill a correct accounts in the EXTRANET part.