https://github.com/pylons/pyramid-cookiecutter-starter

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)
https://github.com/pylons/pyramid-cookiecutter-starter

chameleon cookiecutter-template jinja2 mako pyramid sqlalchemy sqlite traversal url-dispatch zodb

Last synced: 3 months ago
JSON representation

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)

• Host: GitHub
• URL: https://github.com/pylons/pyramid-cookiecutter-starter
• Owner: Pylons
• Created: 2016-06-02T19:07:22.000Z (over 8 years ago)
• Default Branch: latest
• Last Pushed: 2024-04-21T12:31:00.000Z (9 months ago)
• Last Synced: 2024-05-02T00:42:08.034Z (9 months ago)
• Topics: chameleon, cookiecutter-template, jinja2, mako, pyramid, sqlalchemy, sqlite, traversal, url-dispatch, zodb
• Language: Python
• Homepage:
• Size: 215 KB
• Stars: 93
• Watchers: 15
• Forks: 49
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.txt
  • Contributing: CONTRIBUTING.md

Awesome Lists containing this project

README

        
============================

pyramid-cookiecutter-starter

============================

.. image:: https://github.com/Pylons/pyramid-cookiecutter-starter/workflows/Build%20and%20test/badge.svg?branch=latest

    :target: https://github.com/Pylons/pyramid-cookiecutter-starter/actions?query=branch%3Alatest

    :alt: Latest Branch Status

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 the selected persistent backend is "none" or "sqlalchemy" then URL dispatch, or if "zodb" then traversal)

Requirements

------------

*   Python 3.6+

*   `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.

*   ``main`` aligns with the ``main`` branch of Pyramid, and is where development takes place.

*   ``x.y-branch`` aligns with the ``x.y-branch`` branch of Pyramid.

Usage

-----

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

    .. code-block:: bash

        $ cookiecutter gh:Pylons/pyramid-cookiecutter-starter

    Optionally append a specific branch checkout to the command:

    .. code-block:: bash

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

#.  Create a virtual environment, upgrade packaging tools, and install your new project and its dependencies.

    These steps are output to the console and are written to the file in ``/README.txt`` by the cookiecutter, and are slightly different for Windows.

    .. code-block:: bash

        # Change directory into your newly created project if not already there. Your

        # current directory should be the same as this README.txt file and setup.py.

        $ cd 

        # Create a Python virtual environment, if not already created.

        $ 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]"

        # The previous step installs the latest stable release of Pyramid.

        # Optionally install a specific version of Pyramid.

        # For example, the unreleased version of the main branch:

        env/bin/pip install -e git+https://github.com/pylons/pyramid.git@main#egg=pyramid

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

#.  Run your project's tests.

    .. code-block:: bash

        $ env/bin/pytest

#.  Run your project.

    .. code-block:: bash

        $ env/bin/pserve development.ini