A generic, spec-compliant, thorough implementation of the OAuth request-signing logic
*A generic, spec-compliant, thorough implementation of the OAuth request-signing logic for Python 3.6+.
.. image:: https://travis-ci.org/oauthlib/oauthlib.svg?branch=master :target: https://travis-ci.org/oauthlib/oauthlib :alt: Travis .. image:: https://coveralls.io/repos/oauthlib/oauthlib/badge.svg?branch=master :target: https://coveralls.io/r/oauthlib/oauthlib :alt: Coveralls .. image:: https://img.shields.io/pypi/pyversions/oauthlib.svg :target: https://pypi.org/project/oauthlib/ :alt: Download from PyPI .. image:: https://img.shields.io/pypi/l/oauthlib.svg :target: https://pypi.org/project/oauthlib/ :alt: License .. image:: https://app.fossa.io/api/projects/git%2Bgithub.com%2Foauthlib%2Foauthlib.svg?type=shield :target: https://app.fossa.io/projects/git%2Bgithub.com%2Foauthlib%2Foauthlib?ref=badge_shield :alt: FOSSA Status .. image:: https://img.shields.io/readthedocs/oauthlib.svg :target: https://oauthlib.readthedocs.io/en/latest/index.html :alt: Read the Docs .. image:: https://badges.gitter.im/oauthlib/oauthlib.svg :target: https://gitter.im/oauthlib/Lobby :alt: Chat on Gitter
.. image:: https://raw.githubusercontent.com/oauthlib/oauthlib/8d71b161fd145d11c40d55c9ab66ac134a303253/docs/logo/oauthlib-banner-700x192.png :target: https://github.com/oauthlib/oauthlib/ :alt: OAuth + Python = OAuthlib Python Framework
OAuth often seems complicated and difficult-to-implement. There are several prominent libraries for handling OAuth requests, but they all suffer from one or both of the following:
OAuth 1.0 spec_, AKA RFC 5849.
OAuth 2.0 spec_, AKA RFC 6749.
OAuth 1.0 spec: https://tools.ietf.org/html/rfc5849 .. _
OAuth 2.0 spec: https://tools.ietf.org/html/rfc6749
OAuthLib is a framework which implements the logic of OAuth1 or OAuth2 without assuming a specific HTTP request object or web framework. Use it to graft OAuth client support onto your favorite HTTP library, or provide support onto your favourite web framework. If you're a maintainer of such a library, write a thin veneer on top of OAuthLib and get OAuth support for very little effort.
Full documentation is available on
Read the Docs. All contributions are very welcome! The documentation is still quite sparse, please open an issue for what you'd like to know, or discuss it in our
Gitter community, or even better, send a pull request!
Gitter community: https://gitter.im/oauthlib/Lobby .. _
Read the Docs: https://oauthlib.readthedocs.io/en/latest/index.html
Then you might be more interested in using
requests_ which has OAuthLib powered OAuth support provided by the
requests: https://github.com/requests/requests .. _
The following packages provide OAuth support using OAuthLib.
django-oauth-toolkit, which includes
Django REST frameworksupport.
If you have written an OAuthLib package that supports your favorite framework, please open a Pull Request, updating the documentation.
django-oauth-toolkit: https://github.com/evonove/django-oauth-toolkit .. _
flask-oauthlib: https://github.com/lepture/flask-oauthlib .. _
Django REST framework: http://django-rest-framework.org .. _
Flask-Dance: https://github.com/singingwolfboy/flask-dance .. _
pyramid-oauthlib: https://github.com/tilgovi/pyramid-oauthlib .. _
Patching OAuth support onto an http request framework? Creating an OAuth provider extension for a web framework? Simply using OAuthLib to Get Things Done or to learn?
No matter which we'd love to hear from you in our
Gitter community_ or if you have anything in particular you would like to have, change or comment on don't hesitate for a second to send a pull request or open an issue. We might be quite busy and therefore slow to reply but we love feedback!
Chances are you have run into something annoying that you wish there was documentation for, if you wish to gain eternal fame and glory, and a drink if we have the pleasure to run into eachother, please send a docs pull request =)
Gitter community: https://gitter.im/oauthlib/Lobby
OAuthLib is yours to use and abuse according to the terms of the BSD license. Check the LICENSE file for full details.
OAuthLib has been started and maintained several years by Idan Gazit and other amazing
AUTHORS. Thanks to their wonderful work, the open-source
communitycreation has been possible and the project can stay active and reactive to users requests.
AUTHORS: https://github.com/oauthlib/oauthlib/blob/master/AUTHORS .. _
OAuthLib is in active development, with the core of both OAuth1 and OAuth2 completed, for providers as well as clients. See
supported features_ for details.
supported features: https://oauthlib.readthedocs.io/en/latest/featurematrix.html
For a full changelog see