| commit | author | age | ||
| 2df8f0 | 1 | repoze.who |
| TS | 2 | ========== |
| 30b996 | 3 | |
| 0cfd9d | 4 | .. image:: https://travis-ci.org/repoze/repoze.who.png?branch=master |
| TS | 5 | :target: https://travis-ci.org/repoze/repoze.who |
| 6 | ||
| 7 | .. image:: https://readthedocs.org/projects/repozewho/badge/?version=latest | |
| 8d27a8 | 8 | :target: http://repozewho.readthedocs.org/en/latest/ |
| 0cfd9d | 9 | :alt: Documentation Status |
| TS | 10 | |
| 1475ab | 11 | .. image:: https://img.shields.io/pypi/v/repoze.who.svg |
| TS | 12 | :target: https://pypi.python.org/pypi/repoze.who |
| 13 | ||
| 14 | .. image:: https://img.shields.io/pypi/pyversions/repoze.who.svg | |
| 15 | :target: https://pypi.python.org/pypi/repoze.who | |
| 16 | ||
| 7141c7 | 17 | ``repoze.who`` is an identification and authentication framework |
| 30b996 | 18 | for arbitrary WSGI applications. ``repoze.who`` can be configured |
| TS | 19 | either as WSGI middleware or as an API for use by an application. |
| fdbab9 | 20 | |
| 7141c7 | 21 | ``repoze.who`` is inspired by Zope 2's Pluggable Authentication |
| TS | 22 | Service (PAS) (but ``repoze.who`` is not dependent on Zope in any |
| 25ac2e | 23 | way; it is useful for any WSGI application). It provides no facility |
| CM | 24 | for authorization (ensuring whether a user can or cannot perform the |
| 25 | operation implied by the request). This is considered to be the | |
| 26 | domain of the WSGI application. | |
| 2df8f0 | 27 | |
| TS | 28 | Installation |
| 29 | ------------ | |
| 30 | ||
| 31 | Install using setuptools, e.g. (within a virtualenv):: | |
| 32 | ||
| 33 | $ easy_install repoze.who | |
| 34 | ||
| 35 | or using pip:: | |
| 36 | ||
| 37 | $ pip install repoze.who | |
| 38 | ||
| 39 | ||
| 40 | Usage | |
| 41 | ----- | |
| 42 | ||
| 43 | For details on using the various components, please see the | |
| 44 | documentation in ``docs/index.rst``. A rendered version of that documentation | |
| 45 | is also available online: | |
| 46 | ||
| 47 | - http://repozewho.readthedocs.org/en/latest/ | |
| 48 | ||
| 49 | ||
| 50 | Reporting Bugs | |
| 51 | -------------- | |
| 52 | ||
| 53 | Please report bugs in this package to | |
| 54 | ||
| 55 | https://github.com/repoze/repoze.who/issues | |
| 56 | ||
| 57 | ||
| 58 | Obtaining Source Code | |
| 59 | --------------------- | |
| 60 | ||
| 61 | Download development or tagged versions of the software by visiting: | |
| 62 | ||
| 63 | https://github.com/repoze/repoze.who | |
| 64 | ||
