Metadata-Version: 1.0
Name: bluebream
Version: 0.1.5
Summary: The Zope Web Framework
Home-page: http://packages.python.org/bluebream
Author: BlueBream Team
Author-email: zope-dev@zope.org
License: Zope Public License
Download-URL: http://pypi.python.org/pypi/bluebream
Description: .. contents:: Table of Contents
        :depth: 2
        
        BlueBream
        *********
        
        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
        <http://pythonpaste.org/script/developer.html>`_ by Ian Bicking.
        Deatailed documentation about BlueBream is available here:
        `http://packages.python.org/bluebream
        <http://packages.python.org/bluebream>`_
        
        .. raw:: html
        
        <object width="480" height="295"><param name="movie" value="http://www.youtube.com/v/HyG5Qee5wbs&hl=en_US&fs=1&"></param><param name="allowFullScreen" value="true"></param><param name="allowscriptaccess" value="always"></param><embed src="http://www.youtube.com/v/HyG5Qee5wbs&hl=en_US&fs=1&" type="application/x-shockwave-flash" allowscriptaccess="always" allowfullscreen="true" width="480" height="295"></embed></object>
        
        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
        
        .. note::
        
        Access to `PyPI <http://pypi.python.org>`_ is required to perform
        the installation and bootstrapping process.
        
        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
        
        You can continue reading about BlueBream from the `documentation site
        <http://packages.python.org/bluebream>`_.
        
        
        Changelog
        *********
        
        0.1.5 (2010-01-07)
        ------------------
        
        - LP #503388: Value of "namespace_package" should not be
        empty string.
        - Updated description, added promotional video.
        
        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.
        
        
        Download
        ********
Platform: UNKNOWN
