BA Kit

bakit dependency installation for local development and testing

uv sync --all-extras --dev

Optional Tortoise ORM runtime

Bakit initializes Tortoise ORM when a service defines a TORTOISE_ORM setting. Services that do not use Tortoise can omit that setting; Bakit's Sanic app, ARQ worker, CLI commands, and interactive shell will then run without initializing Tortoise. Existing services with a TORTOISE_ORM setting keep the default behavior.

Optional Clerk authentication

Install the Sanic and Clerk extras:

pip install "balabs-kit[sanic,clerk]"

Set CLERK_ISSUER (e.g. https://your-app.clerk.accounts.dev, or your production Clerk domain). Optionally set CLERK_AUDIENCE to enforce aud, CLERK_AUTHORIZED_PARTIES to a comma-separated list of trusted browser origins for azp, and CLERK_JWKS_URL to override only the key endpoint.

Then mark any view with @clerk_auth to require a valid Clerk session token (Authorization: Bearer <token> or the __session cookie):

from bakit.sanic.decorators import clerk_auth
from bakit.sanic.views import APIView, Response, route


@route(bp, "/me/")
@clerk_auth
class MeView(APIView):
    async def get(self, request):
        return Response({"user_id": request.ctx.auth_claims["sub"]})

Unmarked views are unaffected. Marked views return 401 without a valid token. On success the token claims are on request.ctx.auth_claims.