jfmcarreira
66b72d1348
App checks / changes (push) Canceled after 0s
App checks / tournament (push) Canceled after 0s
App checks / shifts (push) Canceled after 0s
1.5 KiB
1.5 KiB
CRR Python infrastructure
Internal uv workspace package, imported as crr_common, targeting Python 3.13.
Both applications consume it explicitly through workspace dependencies.
Proven shared needs
database.create_sync_engine: both FastAPI applications use synchronous SQLAlchemy and allow SQLite connections to cross request-worker threads. This wraps SQLAlchemy URL handling and suppliescheck_same_thread=Falsefor SQLite, while forwarding caller engine options and honoring explicit connection arguments. Other database dialects receive no SQLite-specific arguments.migrations.migration_config: both applications create an Alembic configuration from their own ini file, migration directory and database setting. It resolves paths, escapes URL interpolation characters, and optionally attaches a caller- owned connection for transactional migrations.
Schema validation, baseline revisions, upgrades/stamps, transaction ownership, SQLite pragmas, backups, sessions, domain models and authentication belong to each application. The package contains no app imports, switches or domain code. It neither opens migration connections nor runs DDL.
Run make python-common-test from the repository root. make test includes
these checks, and shared-package changes trigger both app CI jobs. Docker images
install the package as a wheel with uv sync --no-editable; local uv commands
use the workspace package. Its internal version is not a public release stream.