Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

Script that creates a Dolmen project directory, installs Grok, the Grok Toolkit and the Zope Toolkit and sets up a complete skeleton for a new Dolmen application.

Project Description

Script that creates a Dolmen project directory, installs Grok, the Grok Toolkit and the Zope Toolkit and sets up a complete skeleton for a new Dolmen application.


dolmenproject provides an easy way to get started with a Dolmen web application. It’s an extension of grokproject package.

This documentation is adapted from grokproject README.txt. And so is the most of the code :). Thanks to grokproject developers!

Simply install dolmenproject:

$ easy_install dolmenproject

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

$ easy_install -U dolmenproject

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

$ dolmenproject DruidicRitual
... 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 DruidicRitual
$ 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:

$ bin/interactive_debugger

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 dolmen DruidicRitual

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:

$ bin/buildout

This will rebuild the files in parts/etc/.


1.0a3 (2011-02-19)

1.0a2 (2011-01-11)

  • Include .zcml_tmpl files in the release.
  • Define “sources-dir = dev” in generated sources.cfg.

1.0a1 (2011-01-11)

  • Initial version, based on grokproject 2.3.

Release history Release notifications

This version
History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date (16.7 kB) Copy SHA256 hash SHA256 Source None Feb 19, 2011

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page