bluebream 0.1.4

Introduction

BlueBream makes it easy to setup a new project using Zope packages. BlueBream generate a project directory from a template called bluebream. The template is created using PasteScript by Ian Bicking. Deatailed documentation about BlueBream is available here: http://packages.python.org/bluebream

Features

1. Generated project package includes ZTK with few additional packages which was part of “Zope 3”.

2. Runnable Buildout

3. Functional testing enabled by default using z3c.testsetup

4. Use PasteDeploy to support WSGI based deployment.

5. Create a namespace package by default.

Installation

To create a new project, first you need to install BlueBream:

$ easy_install bluebream

Once BlueBream is installed, run paster command to create the project directory. The create sub-command provided by paster will show a wizard to create the project directory.

$ paster create -t bluebream

You need to provide the project name and namespace package name. The project name will be used as the egg name.

The project name can be give given as a command line argument:

$ paster create -t bluebream sampleproject

The name of namespace package also can be given from the command line:

$ paster create -t bluebream sampleproject namespace_package=mycompany

The other variables which can be given from command line are:

• version: Version (like 0.1)

• description: One-line description of the package

• long_description: Multi-line description (in reST)

• keywords: Space-separated keywords/tags

• author: Author name

• author_email: Author email

• url: URL of homepage

• license_name: License name

• zip_safe: True, if the package can be distributed as a .zip file othewise False.

Usage

The generated package include Buildout’s bootstrap.py script and configuration file. First you need to bootstrap the buildout:

$ cd sampleproject
$ python2.6 bootstrap.py

After bootstrap, run the buildout:

$ ./bin/buidout

To run test cases:

$ ./bin/test

To run the server:

$ ./bin/paster serve debug.ini

There is a view named hello registered by default. which can be accessed here: http://localhost:8080/@@hello

0.1.4 (2010-01-04)

• LP #503301: Work around fix for “empty directory” problem.

• Change author as “BlueBream” team and email to zope-dev list.

0.1.3 (2010-01-04)

• LP #502817: var directory and its subdirectories not exist

• Documentation improvements: added “Usage” section

0.1.2 (2010-01-03)

• Added functional testing support for project

• Sphinx based documentation infrastruture improvements

• LP #502529: Update wizard to ask all package meta to be updated in setup.py

0.1.1 (2010-01-02)

• Fix missing package data. The 0.1.0 releases was broken.

• Improve documentation.

0.1.0 (2010-01-02)

• Initial release.