stackure 1.0.0

Official Stackure authentication SDK for Python

Stackure Python SDK

Authentication for your app. One decorator.

Install

pip install stackure

Requires Python 3.10+.

Protect a route

from stackure import auth

@app.get("/admin")
@auth(app_id="my-app-id", roles=["admin"])
async def admin(request):
    return {"user": request.user}

Works with FastAPI, Starlette, Django, Flask, aiohttp — cookies extracted automatically from the request object.

Verify manually

from stackure import verify

result = await verify(app_id="my-app-id", cookies=dict(request.cookies))

if not result.authenticated:
    return {"error": result.error["message"]}, result.error["code"]

return {"user": result.user}

Send a magic link

from stackure import send_magic_link

await send_magic_link(email="[e-mail]", app_id="my-app-id")

Log out

from stackure import logout

await logout(dict(request.cookies))

Configuration

Set STACKURE_BASE_URL to point at a non-production environment:

STACKURE_BASE_URL=https://stage.stackure.com python app.py

Errors

All errors are StackureError. Switch on .code:

from stackure import StackureError

try:
    await send_magic_link(email=email)
except StackureError as err:
    # err.code is one of: "validation" | "auth" | "forbidden" | "timeout" | "network"
    ...

Contributing

Open a PR. Tag a release when ready: git tag vX.Y.Z && git push --tags — the release workflow builds, signs, and publishes.

Security

Report vulnerabilities via GitHub Security Advisories. Releases publish to PyPI via OIDC trusted publishing with GitHub build-provenance attestations.

License

MIT