stevepiercy / cookiecutter-pyramid

A Cookiecutter (project template) for creating a Pyramid starter project with choices for template language (Jinja2, Chameleon, or Mako), persistent backend (none, SQLAlchemy with SQLite, or ZODB), and mapping of URLs to routes (URL dispatch or traversal)

pyramid-cookiecutter-starter

A Cookiecutter (project template) for creating a Pyramid starter project.

Customizable options upon install include choice of:

• template language (Jinja2, Chameleon, or Mako)
• persistent backend (none, SQLAlchemy with SQLite, or ZODB)
• mapping of URLs to routes (if selected persistent backend is "none" or "sqlalchemy" then URL dispatch, and if "zodb" then traversal)

Requirements

• Python 3.5+
• cookiecutter

Versions

This cookiecutter has several branches to support new features in Pyramid or avoid incompatibilities.

• latest aligns with the latest stable release of Pyramid, and is the default branch on GitHub.
• master aligns with the master branch of Pyramid, and is where development takes place.
• x.y-branch aligns with the x.y-branch branch of Pyramid.

Usage

1. Generate a Pyramid project, following the prompts from the command.

   $ cookiecutter gh:Pylons/pyramid-cookiecutter-starter

   Optionally append a specific branch checkout to the command:

   $ cookiecutter gh:Pylons/pyramid-cookiecutter-starter --checkout master

2. Create a virtual environment, upgrade packaging tools, and install your new project and its dependencies. These steps are output by the cookiecutter and are written to the file in <my_project>/README.txt, and are slightly different for Windows.

   # Change directory into your newly created project.
   $ cd <my_project>
   # Create a Python virtual environment.
   $ python3 -m venv env
   # Upgrade packaging tools.
   $ env/bin/pip install --upgrade pip setuptools
   # Install the project in editable mode with its testing requirements.
   $ env/bin/pip install -e ".[testing]"

3. If you selected sqlalchemy as a backend, there will be additional steps in the output and README.txt.

4. Run your project's tests.

   $ env/bin/pytest

5. Run your project.

   $ env/bin/pserve development.ini