Install & Compatibility
Where this runs
tested against v0.4.3 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 2.222s · 53.6MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 5.6s · import 2.021s · 53MB
53MB installed
● package 53MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Auth0
✓ from fastapi_cloudauth.auth0 import Auth0
✗ from fastapi_cloudauth import Auth0
Auth0 is in a submodule, not top-level.
Cognito
✓ from fastapi_cloudauth.cognito import Cognito
✗ from fastapi_cloudauth import Cognito
Cognito is in a submodule.
Firebase
✓ from fastapi_cloudauth.firebase import Firebase
✗ from fastapi_cloudauth import Firebase
Firebase is in a submodule.
CurrentUser
✓ from fastapi_cloudauth.base import CurrentUser
✗ from fastapi_cloudauth import CurrentUser
CurrentUser is in base module.
Basic Auth0 integration; replace domain and audience with your values.
from fastapi import FastAPI, Depends
from fastapi_cloudauth.auth0 import Auth0
app = FastAPI()
auth = Auth0(domain='your-domain.auth0.com', audience='your-audience')
@app.get("/secure")
def secure_route(user: dict = Depends(auth.get_user)):
return {"user": user}
Errors
Common errors & fixes
ImportError: cannot import name 'Auth0' from 'fastapi_cloudauth'
Trying to import from the top-level package instead of submodule.
fixUse: from fastapi_cloudauth.auth0 import Auth0
AttributeError: 'NoneType' object has no attribute 'decode'
Invalid or expired token, or missing JWKS endpoint. Common with self-signed tokens.
fixVerify your token is valid and the provider's JWKS URL is reachable. For local testing, ensure you use a real token.
jose.exceptions.ExpiredSignatureError
Token has expired.
fixRefresh the token or obtain a new one.
Upgrade
Version history
0.4.3latest on PyPI · released Jan 6, 2022
Audit
Dependencies
fastapirequiredRequired for FastAPI integration
python-jose[cryptography]optionalRequired for JWT verification, especially Firebase
httpxrequiredUsed to fetch JWKS keys