Repository files navigation

A generic, spec-compliant, thorough implementation of the OAuth request-signinglogic for Python 3.8+

OAuth often seems complicated and difficult-to-implement. There are severalprominent libraries for handling OAuth requests, but they all suffer from one orboth of the following:

1. They predate theOAuth 1.0 spec, AKA RFC 5849.
2. They predate theOAuth 2.0 spec, AKA RFC 6749.
3. They assume the usage of a specific HTTP request library.

OAuthLib is a framework which implements the logic of OAuth1 or OAuth2 withoutassuming a specific HTTP request object or web framework. Use it to graft OAuthclient support onto your favorite HTTP library, or provide support onto yourfavourite web framework. If you're a maintainer of such a library, write a thinveneer on top of OAuthLib and get OAuth support for very little effort.

Full documentation is available onRead the Docs. All contributions are verywelcome! The documentation is still quite sparse, please open an issue for whatyou'd like to know, or discuss it in ourGitter community, or even better, send apull request!

Then you might be more interested in usingrequests which has OAuthLibpowered OAuth support provided by therequests-oauthlib library.

The following packages provide OAuth support using OAuthLib.

• For Django there is:-django-oauth-toolkit, which includesDjango REST framework support.-django-allauth, which includesDjango REST framework as well asDjango Ninja support.
• For Flask there isflask-oauthlib andFlask-Dance.
• For Pyramid there ispyramid-oauthlib.
• For Bottle there isbottle-oauthlib.

If you have written an OAuthLib package that supports your favorite framework,please open a Pull Request, updating the documentation.

Patching OAuth support onto an http request framework? Creating an OAuthprovider extension for a web framework? Simply using OAuthLib to Get Things Doneor to learn?

No matter which we'd love to hear from you in ourGitter community or if you haveanything in particular you would like to have, change or comment on don'thesitate for a second to send a pull request or open an issue. We might be quitebusy and therefore slow to reply but we love feedback!

Chances are you have run into something annoying that you wish there wasdocumentation for, if you wish to gain eternal fame and glory, and a drink if wehave the pleasure to run into each other, please send a docs pull request =)

OAuthLib is yours to use and abuse according to the terms of the BSD-3-Clause license.Check the LICENSE file for full details.

OAuthLib has been started and maintained several years by Idan Gazit and otheramazingAUTHORS. Thanks to their wonderful work, the open-sourcecommunitycreation has been possible and the project can stay active and reactive to usersrequests.

OAuthLib is in active development, with the core of both OAuth1 and OAuth2completed, for providers as well as clients. Seesupported features fordetails.

For a full changelog seeCHANGELOG.rst.