identity.model / README.txt


identity.model is a package meant to be used in `python`_ `wsgi`_
applications to manage users, groups and permissions. It is designed
to be integrated in a variety of ways. It is not designed to be an out
of the box solution however. Typically out of the box solutions,
though great for getting up and running quickly, often prove to be too
inflexible to meet all the needs of any given application. In other
words, you still have to write code, but the amount of code you have
to write is significantly reduced. At least that is the goal.

identity.model utilizes `sqlalchemy`_, `paste`_, `tw.forms`_, and
`bfg`_, by virtue of leaning on these frameworks for it's
functionality, you can imagine the possibilities. 

using `sqlalchemy`_, implies you can use any database engine it
supports. Which should in theory give you a decent scalability road

using `paste`_, implies infinite possibilities in configuring your
`wsgi`_ stack for your needs via pastedeploy ini files. To this end,
several mini applications are included for various use cases

  - authentication
  - authorization
  - user registration
  - password reset
  - user management
  - group management

All of these are `wsgi`_ applications implemented using `bfg`_, So one
recipe for integrating into your application is via `urlmap`_ in your ini
file. And then using something like `deliverance`_ to provide the
common look and feel. 

Because these mini-applications are implemented on top of `bfg`_ it is
also possible to incorporate these directly into any other `bfg`_

Several such example applications are included in the source
distribution to give you ideas on what is possible.

.. _`bfg`: http://bfg.repoze.,org
.. _`python`:
.. _`wsgi`:
.. _`sqlalchemy`:
.. _`paste`:
.. _`tw.forms`:
.. _`urlmap`:
.. _`deliverance`: