appkit-commons

Define a cached configure() function calling service_registry().configure() with your BaseConfig class. BaseConfig loads config.yaml first, then merges config.<profile>.yaml selected via the PROFILE environment variable, with __-delimited env vars overriding nested values.

Subclass BaseRepository[T], implement the model_class property, and add only custom query methods. The base provides create, find_by_id, find_all, save, update, and delete operations using get_asyncdb_session(), which auto-commits on exit.

APScheduler is the default backend and is distributed-safe, coordinating via the SQL datastore so each job runs on only one node. PGQueuerScheduler is the alternative backend; both accept CronTrigger, IntervalTrigger, and CalendarIntervalTrigger definitions.

rx.asession() breaks in background tasks and callbacks outside the Reflex request lifecycle. Use get_asyncdb_session() from appkit_commons instead, which manages the session lifecycle independently and auto-commits on context exit.

No, migrations must be written manually without --autogenerate. Set down_revision to the revision string from the previous migration file, not its filename, and keep the Revises docstring comment matching down_revision.

EncryptedString encrypts values at rest using Fernet, reading the cipher key from DatabaseConfig.encryption_key via the service registry at runtime. ArrayType similarly provides dialect-agnostic arrays, using native ARRAY on PostgreSQL and JSON on SQLite.