0.1.8 Other/Proprietary License
  not rated
Script that creates a Datashackle skeleton for a new Datashackle web application




datashackleproject is a script that sets up a skeleton for building datashackle web applications. In order to do so, we are approaching a buildout-based installation.

The first thing to get started with a new datashackle project is to install the datashackleproject package, which provides a PasteScript template to create a buildout that sets up the project you want to create:

 pip install datashackleproject

datashackleproject provides a way to set get started with a Grok web application. Simply install grokproject:

easy_install grokproject

If you have an old version of grokproject installed then you can upgrade doing:

easy_install -U grokproject

Afterwards you can run the grokproject script with the name of the project you'd like to create as an argument:

grokproject MammothHerd
... many lines of output here

This will not only create a project area for you to work in, it will also download and install Grok and its dependencies.

After the project area has been created successfully, you will find an empty Python package "skeleton" in the src directory in which you can place the code for your web application.

To start the application server, execute:

cd MammothHerd
bin/paster serve parts/etc/deploy.ini

Start/stop it in daemon mode:

bin/daemon start/stop

There is also an Ajax enabled debugger (point your browser to http://localhost:8080/@@login.html when using this):

bin/paster serve parts/etc/debug.ini

To start the interactive debugger prompt:


To run an ad-hoc Python script against a full setup application:

bin/interactive_debugger [name_of_python_script].py

Python scripts run this way, will have access to a root, debugger, and an app object avaible for "interacting" with the application environment.

For those who know paster: grokproject is just a wrapper around a paster template. So instead of running the grokproject command, you can also run:

paster create -t grok MammotHerd

All configuration files used for running Grok can be found in the parts/etc/ directory of your project. These configuration files are generated automatically from the templates in etc/ on each buildout run. To modify the configuration files edit the approriate templates in etc/ and rerun buildout afterwards:


This will rebuild the files in parts/etc/.
Last updated on August 20th, 2012

0 User reviews so far.