README.rst
.. |gae| replace:: Google App Engine
.. _gae: https://developers.google.com/appengine/
.. |webapp2| replace:: Webapp2
.. _webapp2: http://webapp-improved.appspot.com/
.. |oauth2| replace:: OAuth 2.0
.. _oauth2: http://oauth.net/2/
.. |oauth1| replace:: OAuth 1.0a
.. _oauth1: http://oauth.net/core/1.0a/
.. |openid| replace:: OpenID
.. _openid: http://openid.net/
.. |pyopenid| replace:: python-openid
.. _pyopenid: http://pypi.python.org/pypi/python-openid/
==========
Authomatic
==========
.. image:: https://travis-ci.org/authomatic/authomatic.svg?branch=master
:target: https://travis-ci.org/authomatic/authomatic
**Authomatic**
is a **framework agnostic** library
for **Python** web applications
with a **minimalistic** but **powerful** interface
which simplifies **authentication** of users
by third party providers like **Facebook** or **Twitter**
through standards like **OAuth** and **OpenID**.
For more info visit the project page at http://authomatic.github.io/authomatic.
Maintainers
===========
**Authomatic** was migrated from a private project of Peter Hudec to a community-managed project.
Many thanks to Peter Hudec for all his hard work for creating and maintaining **authomatic**!
We are now a small team of volunteers, not paid for the work here.
Any help is appreciated!
Features
========
* Loosely coupled.
* Tiny but powerful interface.
* The |pyopenid|_ library is the only **optional** dependency.
* **Framework agnostic** thanks to adapters.
Out of the box support for **Django**, **Flask**, **Pyramid** and **Webapp2**.
* Ready to accommodate future authorization/authentication protocols.
* Makes provider API calls a breeze.
* Asynchronous requests.
* JavaScript library as a bonus.
* Out of the box support for:
* |oauth1|_ providers: **Bitbucket**, **Flickr**, **Meetup**, **Plurk**,
**Twitter**, **Tumblr**, **UbuntuOne**, **Vimeo**, **Xero**, **Xing** and **Yahoo**.
* |oauth2|_ providers: **Amazon**, **Behance**, **Bitly**, **Cosm**,
**DeviantART**, **Eventbrite**, **Facebook**, **Foursquare**,
**GitHub**, **Google**, **LinkedIn**, **PayPal**, **Reddit**,
**Viadeo**, **VK**, **WindowsLive**, **Yammer** and **Yandex**.
* |pyopenid|_ and |gae|_ based |openid|_.
License
=======
The package is licensed under
`MIT license <http://en.wikipedia.org/wiki/MIT_License>`__.
Requirements
============
Requires **Python 3.4** or newer.
**Python 3.x** support added in **Authomatic 0.0.11** thanks to Emmanuel Leblond <https://github.com/touilleMan>`__.
Live Demo
=========
There is a |gae| based live demo app running at
http://authomatic-example.appspot.com which makes use of most of the features.
Contribute
==========
Contributions of any kind are very welcome.
If you want to contribute, please read the
`Development Guide <http://authomatic.github.io/authomatic/development.html>`__
first. The project is hosted on
`GitHub <https://github.com/authomatic/authomatic>`__.
Usage
=====
Read the exhaustive documentation at http://authomatic.github.io/authomatic.
Changelog
=========
The `Changelog is part of the documentation <https://authomatic.github.io/authomatic/changelog.html>`_.