Auth365

Effortless asynchronous OAuth 2.0 client for popular platforms

---

---

Features

• Asynchronous: Built on top of httpx is fully asynchronous.
• Built-in support: For popular OAuth 2.0 providers like Google, Yandex, Telegram, etc.
• Extensible: Easily add support for new OAuth 2.0 providers.
• Easy to use: Simple and intuitive API.

Installation

  pip install auth365

Get Started

from typing import Annotated

from fastapi import FastAPI, Depends
from starlette.responses import RedirectResponse

from auth365.providers.google import GoogleOAuth
from auth365.schemas import OAuth2Callback, OpenID
from examples.config import settings

app = FastAPI()

google_oauth = GoogleOAuth(
    client_id=settings.google_client_id,
    client_secret=settings.google_client_secret,
    redirect_uri="http://localhost:8000/callback",
)


@app.get("/login")
async def login() -> RedirectResponse:
    async with google_oauth:
        url = await google_oauth.get_authorization_url()
        return RedirectResponse(url=url)


@app.get("/callback")
async def oauth_callback(callback: Annotated[OAuth2Callback, Depends()]) -> OpenID:
    async with google_oauth:
        await google_oauth.authorize(callback)
        return await google_oauth.userinfo()

Now you can run the server and visit http://localhost:8000/login to start the OAuth 2.0 flow.

After logging into Google, you will be redirected to the callback URL. The server will then fetch the user's OpenID information and return it as a response.