Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Reusable user registration views for Pyramid apps.
Python CSS
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
cartouche Avoid ResourceWarnings during testing under Py3k.
docs Start on docs for replacing the default adapters.
var Ensure that the 'var' directory is present on first checkout.
.bzrignore Ignore second venv.
.gitignore Ignore derived
CHANGES.txt First pass.
COPYRIGHT.txt First pass.
LICENSE.txt First pass.
README.txt Add explanation of 'no_mail' usage.
TODO.txt Add an admin overview view showing pending / confirmed users.
setup.cfg Expose ' dev' and ' docs' aliases. Explicit support for Python 3.4.
tox.ini Explicit support for Python 3.4.


``cartouche`` README

This package provides a set of applications which can be used to drive
"registration-based" sites:

- registration

- login / logout

- change password

- password recovery

- profile editing

- user / group administration

``cartouche`` is built on the following components:

- The ``cartouche`` applications run atop the ``pyramid`` framework, using
  ``chameleon`` for their templating, and ``deform`` for form schema /
  validation handling.

- ``cartouche`` stores users, profiles, and groups in a ``ZODB`` database
  (you can override this by registering adapters which use different

- ``cartouche`` uses ``zope.password`` to do password hashing / checking.

- ``cartouche`` plugs into ``repoze.who`` as an authenticator, a challenger,
  and a metadata provider.

- If your app doesn't use the ``repoze.who`` middleware, you can plug
  ``cartouche`` in as a ``pyramid`` "authentication policy (cartouche still
  uses the ``repoze.who`` API in this case).

Please see ``docs/index.rst`` for the documentation, which can also be
read online at:

Quick Start

Install into your virtualenv::

  $ /path/to/virtualenv/bin/python develop

If you have a working MTA on localhost:25::

  $ /path/to/venv/bin/paster serve development.ini

If you don't have working MTA on localhost:25, the ``no_mail`` configuration
prints any sent mail to the console::

  $ /path/to/venv/bin/paster serve development.ini --app-name=no_mail
Something went wrong with that request. Please try again.