https://github.com/everysoftware/auth365
Asynchronous OAuth 2.0 client for such known platforms as Google, Yandex, Telegram, etc.
https://github.com/everysoftware/auth365
fastapi httpx oauth
Last synced: 12 months ago
JSON representation
Asynchronous OAuth 2.0 client for such known platforms as Google, Yandex, Telegram, etc.
- Host: GitHub
- URL: https://github.com/everysoftware/auth365
- Owner: everysoftware
- Created: 2025-01-27T09:15:35.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-04T17:20:22.000Z (about 1 year ago)
- Last Synced: 2025-02-19T12:52:10.287Z (about 1 year ago)
- Topics: fastapi, httpx, oauth
- Language: Python
- Homepage:
- Size: 510 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Auth365
**Effortless asynchronous OAuth 2.0 client for popular platforms**
---
[](https://github.com/everysoftware/fastid/actions/workflows/test.yml)
[](https://github.com/everysoftware/fastid/actions/workflows/codeql.yml)
---
## 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
```bash
pip install auth365
```
## Get Started
```python
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.
