Metadata-Version: 2.1
Name: stucco-auth
Version: 0.7.0
Summary: stucco_auth
Home-page: http://bitbucket.org/dholth/stucco_auth
Author: Daniel Holth
Author-email: dholth@fastmail.fm
License: BSD
Keywords: web pyramid pylons
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Requires-Dist: cryptacular
Requires-Dist: pyramid
Requires-Dist: pyramid-beaker
Requires-Dist: pyramid-jinja2
Requires-Dist: stucco-evolution
Requires-Dist: SQLAlchemy

stucco_auth
===========

SQLAlchemy-backed username/password authentication for the Pyramid web 
framework.

What You Get
------------

- Versioned schema with stucco_evolution
- SQLAlchemy-mapped User, Group, and Settings classes
- BCRYPT password encryption with cryptacular
- Pyramid views to login and logout
- Traversal, not routes
- Jinja2 templates for the views
- Uni-Form CSS themed login form
- YUI 3 CSS in the base template
- 99% test coverage

What You Don't Get
------------------

- Any express or implied warranties, including, without limitation, the
  implied warranties of merchantibility and fitness for a particular purpose.

Requirements
------------

It's easy enough to add the stucco_auth views to your application by calling::

	from pyramid.config import Configurator
	config = Configurator(...)
	config.include('stucco_auth.config')

Unfortunately, stucco_auth requires many things from a host Pyramid application
before it will work properly:

- A configured authentication and authorization policy. Login and logout views
  don't make sense otherwise.
- A transaction-managed SQLAlchemy session made available as request.db
- stucco_auth's schema instantiated into that database
- request.session for flash messages
- Jinja2 templating
- A stucco_auth.interfaces.IAuthRoot instance in the resource tree. login/ and
  logout/ are resolved relative to this object.

The demo application, stucco_auth.main(), provides one example of how to set
this up.

If you have any questions, please ask DanielHolth in IRC or on one of the
Pylons mailing lists.

0.7.0
-----
- Generate random password in a Python 3 compatible way.

0.6.0
-----
-  Lengthen username, email fields

0.5.0
-----
- update AnonymousUser class (has no table) to be __abstract__ for
  compatibility with newer SQLAlchemy.

0.4.1
-----
- don't specify paster_plugins. need to re-evaluate template project.

0.4
---
- upgrade to a normal version numbering scheme
- generalize 'persistent random secret' code

0.3e-4
------
- fix MANIFEST.in to include the .jinja2 templates

0.2e-4
------
- update for stucco_evolution >= 0.33

0.1e-6
------
- 99% test coverage

0.1
---

- Remove everything except the most basic user/groups/login functionality

0.0
---

- Initial version


