Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/authomatic/authomatic

Simple yet powerful authorization / authentication client library for Python web applications.
https://github.com/authomatic/authomatic

authentication authorization oauth-client oauth2-client openid-client python

Last synced: 2 days ago
JSON representation

Simple yet powerful authorization / authentication client library for Python web applications.

Awesome Lists containing this project

README

        

.. |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 `__.

Requirements
============

Requires **Python 3.4** or newer.
**Python 3.x** support added in **Authomatic 0.0.11** thanks to Emmanuel Leblond `__.

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 `__
first. The project is hosted on
`GitHub `__.

Usage
=====

Read the exhaustive documentation at http://authomatic.github.io/authomatic.

Changelog
=========

The `Changelog is part of the documentation `_.