Adaptador FastAPI

Uso comum:

from govbr_auth.fastapi import GovBrAuth

auth = GovBrAuth(on_success=authenticated)
app.include_router(auth.router)

GovBrAuth aceita GovBrRuntimeSettings ou um GovBrRuntime já composto. Quando ambos são omitidos, carrega GovBrRuntimeSettings do ambiente. settings e runtime são mutuamente exclusivos. O adapter registra login e callback. Com GOVBR_PROVIDER=fake, também registra a demo na raiz /; com o provedor oficial, a página demo não é criada. Quando GOVBR_LOGOUT_URL e GOVBR_POST_LOGOUT_REDIRECT_URI estão configurados juntos, também registra /auth/govbr/logout para iniciar o logout no provedor.

class GovBrAuth(*, on_success, settings=None, runtime=None, on_error=None, expose_tokens=False, prefix='/auth/govbr', clock=utc_now, user_repository=None)

Fachada assíncrona que expõe router para inclusão explícita na aplicação.

class AuthContext

Contexto entregue ao handler após a validação completa da autenticação.

create_govbr_router(*, client, on_success, on_error=None, expose_tokens=False, prefix='/auth/govbr', clock=utc_now)

Factory avançada para um GovBrClient já composto.