Python SDK

foyr-auth is the Python twin of the JavaScript SDK: read the signed-in user and check permissions.

Install

pip install foyr-auth

get_user(request)

Returns a FoyrUser or None. Accepts a Starlette/FastAPI Request, a Flask request or a Django HttpRequest.

from fastapi import FastAPI, HTTPException, Request
from foyr_auth import get_user
 
app = FastAPI()
 
@app.get("/me")
async def me(request: Request):
    user = get_user(request)
    if user is None:
        raise HTTPException(status_code=401, detail="Sign in first")
    return {"id": user.id, "email": user.email, "role": user.role}

has_permission(user, action)

Same rules as JavaScript: the minimum role comes from foyr.json, unknown actions require admin, and None never has permission.

from foyr_auth import has_permission
 
if has_permission(user, "billing:edit"):
    ...

Local development

Set FOYR_DEV_USER=priya@acme.in:admin to act as a user when running outside Foyr.