spaps-server-quickstart 0.0.1__tar.gz

spaps_server_quickstart-0.0.1/.gitignore

@@ -0,0 +1,132 @@
+# Dependencies
+node_modules/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Testing
+coverage/
+*.lcov
+.nyc_output
+packages/python-client/.coverage
+
+# Production builds
+dist/
+build/
+out/
+*.tsbuildinfo
+
+# Environment files
+.env
+.env.*
+*.env
+**/.env
+**/.env.*
+.env.development
+.env.production
+.env.staging
+.env.deploy
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+# Allow committed templates/examples
+!*.env.example
+!*.env.sample
+!*.env.template
+!**/.env.example
+!**/.env.sample
+!**/.env.template
+!**/.env.*.example
+!**/.env.*.sample
+!**/.env.*.template
+!**/*.env.example
+!**/*.env.sample
+!**/*.env.template
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*.swn
+.DS_Store
+
+# Debug
+debug.log
+*.log
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+packages/python-client/**/__pycache__/
+
+# Package manager files
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Next.js specific
+.next/
+next-env.d.ts
+.vercel/
+
+# Example projects - ignore build artifacts
+examples/**/.next/
+examples/**/node_modules/
+examples/**/dist/
+examples/**/build/
+examples/**/*.log
+examples/**/.env
+examples/**/.env.local
+
+# MCP/Sweetpotato docs build
+mcp-sweetpotato-docs/node_modules/
+mcp-sweetpotato-docs/dist/
+mcp-sweetpotato-docs/build/
+mcp-sweetpotato-docs/.next/
+
+# Large test files
+*.jpg
+*.jpeg
+*.png
+*.gif
+*.bmp
+*.mp4
+*.mov
+*.avi
+*.zip
+*.tar
+*.gz
+*.rar
+
+# Database files
+*.sqlite
+*.sqlite3
+*.db
+
+# OS files
+Thumbs.db
+Desktop.ini
+
+# Backup files
+*.bak
+*.backup
+*.old
+
+# Test output
+test-results/
+playwright-report/
+playwright/.cache/
+
+# Lock files that shouldn't be committed for libraries
+# (keep package-lock.json for applications)
+# yarn.lock
+# pnpm-lock.yaml*.tgz

spaps_server_quickstart-0.0.1/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to this project will be documented here.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+- Added FastAPI lifespan handling for SPAPS auth cleanup.
+- Introduced migration guide and upgrading instructions for downstream services.
+- Established comprehensive unit tests across settings, middleware, DB, Celery, and auth helpers.
+
+## [0.0.1] - 2025-10-14
+
+- Initial scaffold of `spaps-server-quickstart` with shared FastAPI/Celery/DB utilities.

spaps_server_quickstart-0.0.1/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: spaps-server-quickstart
+Version: 0.0.1
+Summary: Shared FastAPI/Celery scaffolding for Sweet Potato service backends.
+Project-URL: Repository, https://github.com/sweet-potato/spaps
+Author-email: Sweet Potato Team <engineering@sweetpotato.dev>
+License: Proprietary
+Keywords: celery,fastapi,quickstart,spaps,sweet-potato
+Requires-Python: >=3.10
+Requires-Dist: alembic<2.0,>=1.13.1
+Requires-Dist: asyncpg<0.31.0,>=0.30.0
+Requires-Dist: celery<6.0,>=5.4.0
+Requires-Dist: fastapi<0.119.0,>=0.115.0
+Requires-Dist: httpx<0.29.0,>=0.27.0
+Requires-Dist: pydantic-settings<3.0,>=2.3.0
+Requires-Dist: pydantic<3.0,>=2.8.0
+Requires-Dist: redis<6.0,>=5.0.0
+Requires-Dist: spaps>=0.1.2
+Requires-Dist: sqlalchemy<3.0,>=2.0.32
+Requires-Dist: structlog<26.0,>=24.1.0
+Requires-Dist: tenacity<9.0,>=8.3.0
+Requires-Dist: uvicorn<0.38.0,>=0.29.0
+Provides-Extra: dev
+Requires-Dist: anyio<5.0,>=4.4.0; extra == 'dev'
+Requires-Dist: mypy<2.0,>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-asyncio<0.24.0,>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov<6.0,>=5.0.0; extra == 'dev'
+Requires-Dist: pytest<9.0,>=8.3.0; extra == 'dev'
+Requires-Dist: ruff<1.0,>=0.5.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# SPAPS Server Quickstart
+
+Reusable scaffolding for Sweet Potato service backends. This package gathers the FastAPI
+application factory, Celery bootstrap, Pydantic settings base classes, and other utilities
+that HTMA, Ingredient, and future services can share.
+
+## Installation
+
+Use either Poetry (preferred inside this repo) or pip editable installs:
+
+```bash
+# with poetry
+poetry install -C packages/python-server-quickstart
+
+# or with pip (installs package + dev extras)
+python3 -m pip install -e 'packages/python-server-quickstart[dev]'
+```
+
+The editable install ensures FastAPI, SQLAlchemy, Celery, and other dependencies are
+available when the pre-push scripts execute.
+
+## Local Development
+
+```bash
+poetry run -C packages/python-server-quickstart pytest
+```
+
+The shared modules are designed to be imported by individual service packages. Tests live
+alongside the shared code to guard the common behaviour.
+
+## Lifecycle Hooks
+
+`create_app` now uses FastAPI's lifespan context to close shared resources (e.g., SPAPS auth
+clients). When you need additional startup/shutdown logic, extend the lifespan in your service
+by wrapping the provided app with your own context manager or closing resources within your
+domain packages. Running tests with `TestClient(app)` will automatically exercise the shutdown
+path and catch missing `aclose()` implementations.
+
+## Upgrading Downstream Services
+
+Guidance for publishing new versions and upgrading consumer services lives in
+[`docs/UPGRADING.md`](docs/UPGRADING.md). Review those steps before bumping the package or
+pulling a newer release into `htma_server`, `ingredient_server`, or other SPAPS services.
+
+## Migrating an Existing Service
+
+See [`docs/MIGRATION_GUIDE.md`](docs/MIGRATION_GUIDE.md) for a step-by-step walkthrough of
+adopting the shared package inside an existing FastAPI/Celery service. It covers settings
+integration, router wiring, database session management, Celery bootstraps, and the final
+cleanup checklist.
+
+## Release Workflow
+
+- Use the GitHub Action **Publish Python Server Quickstart** (`.github/workflows/python-server-quickstart-release.yml`) to cut releases. It reuses the generic `python-package-release` workflow alongside `scripts/manage_python_package_version.py`.
+- Ensure the repository secret `PYPI_SERVER_QUICKSTART_TOKEN` holds the PyPI API token for this package.
+- For manual bumps, dispatch the workflow and choose the bump type (major/minor/patch). For automated publishes, pushing a commit that updates `packages/python-server-quickstart/pyproject.toml` will trigger the workflow.
+
+## Status
+
+- [x] Initial package scaffold
+- [x] Shared application factories
+- [x] Shared Celery bootstrap
+- [x] Shared middleware, logging, and settings base classes
+- [x] Health endpoint helpers
+- [ ] Documentation and usage examples
+
+## Repository Integration
+
+The root `package.json` includes `lint:python-server-quickstart`, `typecheck:python-server-quickstart`,
+and `test:python-server-quickstart` commands. These run automatically via `npm run prepush`, so make sure
+the editable install step above has been executed before pushing commits.

spaps_server_quickstart-0.0.1/README.md

@@ -0,0 +1,71 @@
+# SPAPS Server Quickstart
+
+Reusable scaffolding for Sweet Potato service backends. This package gathers the FastAPI
+application factory, Celery bootstrap, Pydantic settings base classes, and other utilities
+that HTMA, Ingredient, and future services can share.
+
+## Installation
+
+Use either Poetry (preferred inside this repo) or pip editable installs:
+
+```bash
+# with poetry
+poetry install -C packages/python-server-quickstart
+
+# or with pip (installs package + dev extras)
+python3 -m pip install -e 'packages/python-server-quickstart[dev]'
+```
+
+The editable install ensures FastAPI, SQLAlchemy, Celery, and other dependencies are
+available when the pre-push scripts execute.
+
+## Local Development
+
+```bash
+poetry run -C packages/python-server-quickstart pytest
+```
+
+The shared modules are designed to be imported by individual service packages. Tests live
+alongside the shared code to guard the common behaviour.
+
+## Lifecycle Hooks
+
+`create_app` now uses FastAPI's lifespan context to close shared resources (e.g., SPAPS auth
+clients). When you need additional startup/shutdown logic, extend the lifespan in your service
+by wrapping the provided app with your own context manager or closing resources within your
+domain packages. Running tests with `TestClient(app)` will automatically exercise the shutdown
+path and catch missing `aclose()` implementations.
+
+## Upgrading Downstream Services
+
+Guidance for publishing new versions and upgrading consumer services lives in
+[`docs/UPGRADING.md`](docs/UPGRADING.md). Review those steps before bumping the package or
+pulling a newer release into `htma_server`, `ingredient_server`, or other SPAPS services.
+
+## Migrating an Existing Service
+
+See [`docs/MIGRATION_GUIDE.md`](docs/MIGRATION_GUIDE.md) for a step-by-step walkthrough of
+adopting the shared package inside an existing FastAPI/Celery service. It covers settings
+integration, router wiring, database session management, Celery bootstraps, and the final
+cleanup checklist.
+
+## Release Workflow
+
+- Use the GitHub Action **Publish Python Server Quickstart** (`.github/workflows/python-server-quickstart-release.yml`) to cut releases. It reuses the generic `python-package-release` workflow alongside `scripts/manage_python_package_version.py`.
+- Ensure the repository secret `PYPI_SERVER_QUICKSTART_TOKEN` holds the PyPI API token for this package.
+- For manual bumps, dispatch the workflow and choose the bump type (major/minor/patch). For automated publishes, pushing a commit that updates `packages/python-server-quickstart/pyproject.toml` will trigger the workflow.
+
+## Status
+
+- [x] Initial package scaffold
+- [x] Shared application factories
+- [x] Shared Celery bootstrap
+- [x] Shared middleware, logging, and settings base classes
+- [x] Health endpoint helpers
+- [ ] Documentation and usage examples
+
+## Repository Integration
+
+The root `package.json` includes `lint:python-server-quickstart`, `typecheck:python-server-quickstart`,
+and `test:python-server-quickstart` commands. These run automatically via `npm run prepush`, so make sure
+the editable install step above has been executed before pushing commits.

spaps_server_quickstart-0.0.1/docs/MIGRATION_GUIDE.md

@@ -0,0 +1,104 @@
+# Migrating a Service to `spaps-server-quickstart`
+
+This playbook describes the concrete steps for services like `htma_server` and
+`ingredient_server` to replace local scaffolding with the shared package. Expect a
+single PR per service.
+
+## 1. Prepare the Service
+
+1. **Pin the dependency**
+   - Add `spaps-server-quickstart = "^0.x"` to the service `pyproject.toml`.
+   - `poetry update spaps-server-quickstart` (or pip equivalent) and commit the lockfile.
+2. **Install tooling**
+   - Ensure the editable install exists locally: `python3 -m pip install -e 'packages/python-server-quickstart[dev]'`.
+   - Run the shared package tests once: `npm run test:python-server-quickstart`.
+
+## 2. Settings & Configuration
+
+1. Replace the local `Settings` class with a subclass of `spaps_server_quickstart.settings.BaseServiceSettings`.
+   ```python
+   from spaps_server_quickstart.settings import BaseServiceSettings, create_settings_loader
+
+   class Settings(BaseServiceSettings):
+       app_name: str = "HTMA Server"
+       service_slug: str = "htma-server"
+       database_url: str = "postgresql+asyncpg://.../htma"
+       # include service-specific fields (e.g., practitioners, ingredient keys)
+
+   get_settings = create_settings_loader(Settings)
+   ```
+2. Update imports wherever `Settings` or `get_settings` were used (app factory, dependencies, tasks).
+
+## 3. FastAPI Application & Routers
+
+1. Remove the local `create_app` factory and import the shared one:
+   ```python
+   from spaps_server_quickstart.app_factory import create_app
+   from spaps_server_quickstart.api.router import build_base_router
+   from spaps_server_quickstart.api.health import HealthRouterFactory
+   ```
+2. Compose routers:
+   ```python
+   settings_loader = get_settings
+   health_router = HealthRouterFactory(
+       settings_loader=settings_loader,
+       session_dependency=db_resources.session_dependency,
+       extra_metrics_provider=custom_metrics,
+   ).create_router()
+
+   api_router = build_base_router(
+       health_router,
+       (practitioner_router, {"prefix": "/v1", "tags": ["practitioner"]}),
+   )
+
+   app = create_app(
+       settings_loader=settings_loader,
+       api_router=api_router,
+       enable_spaps_auth=True,
+       auth_exempt_paths={"/open-metrics"},
+   )
+   ```
+3. Delete redundant local modules (auth, middleware, logging) once replaced.
+
+## 4. Database Integration
+
+1. Instantiate shared DB resources in a new `core/db.py` or similar:
+   ```python
+   from spaps_server_quickstart.db import DatabaseResources
+
+   db_resources = DatabaseResources(get_settings())
+   get_db_session = db_resources.session_dependency
+   ```
+2. Update dependencies in API modules (`Depends(get_db_session)`).
+3. Ensure Alembic scripts reuse the shared naming validators if applicable.
+
+## 5. Celery & Tasks
+
+1. Replace the local `Celery` bootstrap with:
+   ```python
+   from spaps_server_quickstart.tasks import create_celery_app
+
+   celery_app = create_celery_app(get_settings(), task_modules=["htma_server.tasks"])
+   ```
+2. Update shared tasks (`build_ping_task`, `build_notification_task`) or keep service-specific overrides as needed.
+
+## 6. Test & Validate
+
+1. Run unit/integration tests: `poetry run pytest`, `poetry run ruff`, `poetry run mypy`.
+2. Run the root `npm run prepush` to cover shared checks.
+3. Smoke test FastAPI and Celery locally if the service has start scripts.
+
+## 7. Cleanup & Review
+
+1. Remove unused files (duplicate middleware/auth/logging) and update service README docs to reference the shared package.
+2. Ensure CI passes and request review. Highlight the dependency bump and key refactors in the PR summary.
+
+## Appendix: Checklist
+
+- [ ] `pyproject.toml` dependency updated and installed.
+- [ ] Settings subclass uses `create_settings_loader`.
+- [ ] FastAPI app uses shared `create_app` and router helpers.
+- [ ] Database dependencies go through `DatabaseResources`.
+- [ ] Celery uses `create_celery_app` with correct task module.
+- [ ] Tests + prepush suite green.
+- [ ] Redundant local scaffolding removed.

spaps_server_quickstart-0.0.1/docs/UPGRADING.md

@@ -0,0 +1,82 @@
+# Upgrading Downstream Services
+
+When `spaps-server-quickstart` publishes new releases, dependent services (e.g.
+`htma_server`, `ingredient_server`) need a predictable upgrade cadence. Follow this
+checklist whenever we cut a release or adopt a newer version downstream.
+
+## For the Quickstart Maintainer (Publishing a Release)
+
+1. **Triage changes** – confirm whether the release is a patch, minor, or major bump.
+   - Patch (x.y.Z) for bug fixes and strictly backwards-compatible tweaks.
+   - Minor (x.Y.0) for new features that keep existing APIs stable.
+   - Major (X.0.0) for breaking changes; document migration steps clearly.
+2. **Update metadata**
+   - Bump `version` in `pyproject.toml`.
+   - Add release notes to `CHANGELOG.md` (include migration guidance for non-trivial upgrades).
+3. **Run validation locally**
+   - `python3 -m pip install -e '.[dev]'`
+   - `python3 -m pytest -q`
+   - `python3 -m ruff check src tests`
+   - `python3 -m mypy src`
+4. **Publish the package**
+   - `npm run build:python-client` is **not** required here; instead run:
+     ```bash
+     cd packages/python-server-quickstart
+     python -m build
+     python -m twine upload dist/*
+     ```
+   - If the package is private, upload to the internal index configured for SPAPS.
+5. **Announce the release**
+   - Share the version, changelog highlights, and any upgrade notes in the engineering
+     channel or release tracker.
+
+## For Downstream Services (Consuming a Release)
+
+1. **Update dependencies**
+   - In the service `pyproject.toml`, bump the `spaps-server-quickstart` requirement.
+   - Run `poetry update spaps-server-quickstart` (or `pip-compile` if using pip-tools).
+2. **Re-install local environment**
+   - `poetry install` (or `python3 -m pip install -e '.[dev]'`) to ensure the new version +
+     transitive deps are in the virtualenv.
+3. **Run the validation stack**
+   - `npm run prepush` from repo root (covers lint, typecheck, pytest, docs health).  
+     Minimum checks:
+     ```bash
+     poetry run pytest
+     poetry run ruff check src tests
+     poetry run mypy src
+      poetry run python - <<'PY'
+      from spaps_server_quickstart.db import DatabaseResources
+      from <service>.core.settings import get_settings
+
+      resources = DatabaseResources(get_settings())
+      assert resources.get_session_factory()
+      PY
+     ```
+   - If the service uses Docker images, rebuild them locally to catch runtime regressions.
+4. **Exercise lifecycles**
+   - Confirm the FastAPI app starts and shuts down cleanly (`uvicorn`, `pytest` with `TestClient`).
+   - Verify Celery workers boot and call `create_celery_app(settings, task_modules=["<service>.tasks"])`.
+5. **Merge and deploy**
+   - Once CI is green, merge the dependency bump PR.
+   - Roll out through the standard deployment pipeline (staging → production) while watching
+     health checks. The shared `HealthRouterFactory` will surface database readiness issues.
+
+## Handling Breaking Changes
+
+- **Major releases** should ship with migration utilities or example diffs in
+  `docs/UPGRADING.md`.
+- If removing or renaming APIs, deprecate in one release cycle first (log a warning),
+  then remove in the next major version.
+- Add integration tests in both the quickstart package and dependent services to guard
+  behaviour that might regress.
+
+## Version Pinning Guidelines
+
+- Each service should pin `spaps-server-quickstart` to a compatible minor range,
+  e.g. `^0.2.0`.
+- Avoid `*` or wide specifiers. This prevents surprise upgrades when publishing other packages.
+- For hotfixes, release a patch version and bump immediately downstream.
+
+By following this flow, the quickstart can evolve confidently while keeping HTMA, Ingredient,
+and future services stable.

spaps_server_quickstart-0.0.1/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["hatchling>=1.24.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "spaps-server-quickstart"
+version = "0.0.1"
+description = "Shared FastAPI/Celery scaffolding for Sweet Potato service backends."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Proprietary" }
+authors = [
+  { name = "Sweet Potato Team", email = "engineering@sweetpotato.dev" }
+]
+keywords = ["sweet-potato", "fastapi", "celery", "quickstart", "spaps"]
+dependencies = [
+  "fastapi>=0.115.0,<0.119.0",
+  "sqlalchemy>=2.0.32,<3.0",
+  "asyncpg>=0.30.0,<0.31.0",
+  "pydantic>=2.8.0,<3.0",
+  "pydantic-settings>=2.3.0,<3.0",
+  "structlog>=24.1.0,<26.0",
+  "alembic>=1.13.1,<2.0",
+  "celery>=5.4.0,<6.0",
+  "redis>=5.0.0,<6.0",
+  "uvicorn>=0.29.0,<0.38.0",
+  "httpx>=0.27.0,<0.29.0",
+  "tenacity>=8.3.0,<9.0",
+  "spaps>=0.1.2",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.3.0,<9.0",
+  "pytest-asyncio>=0.23.0,<0.24.0",
+  "pytest-cov>=5.0.0,<6.0",
+  "mypy>=1.10.0,<2.0",
+  "ruff>=0.5.5,<1.0",
+  "anyio>=4.4.0,<5.0",
+]
+
+[project.urls]
+Repository = "https://github.com/sweet-potato/spaps"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/spaps_server_quickstart"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+addopts = "--cov=spaps_server_quickstart --cov-report=term-missing"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src"]
+
+[tool.mypy]
+python_version = "3.10"
+packages = ["spaps_server_quickstart"]
+strict_optional = true
+ignore_missing_imports = true

spaps_server_quickstart-0.0.1/scripts/release.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROJECT_ROOT=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
+
+echo "==> Running test suite"
+PYTHONPATH="$PROJECT_ROOT/src" python3 -m pytest -q
+
+echo "==> Linting"
+python3 -m ruff check "$PROJECT_ROOT/src" "$PROJECT_ROOT/tests"
+
+echo "==> Type checking"
+python3 -m mypy "$PROJECT_ROOT/src"
+
+echo "==> Building distribution"
+cd "$PROJECT_ROOT"
+rm -rf dist
+python3 -m build
+
+echo "==> Uploading via twine"
+python3 -m twine upload dist/*
+
+echo "Release complete." 

spaps_server_quickstart-0.0.1/src/spaps_server_quickstart/__init__.py

@@ -0,0 +1,63 @@
+"""
+Shared service scaffolding for Sweet Potato backend applications.
+
+The package gathers reusable FastAPI, Celery, settings, database, logging, and
+authentication helpers that individual services (HTMA, Ingredient, etc.) can consume.
+"""
+
+from .alembic import allowed_domains, collect_directory_errors, ensure_known_domain, slugify_title, validate_migration_filename
+from .app_factory import create_app
+from .auth import (
+    AuthenticationError,
+    AuthenticatedUser,
+    SpapsAuthMiddleware,
+    SpapsAuthService,
+    build_spaps_auth_service,
+)
+from .api.health import HealthRouterFactory
+from .api.router import build_base_router
+from .db import (
+    AlembicMigrationRunner,
+    DatabaseResources,
+    create_async_sessionmaker,
+    create_migration_runner,
+    session_dependency_factory,
+)
+from .logging import configure_logging
+from .middleware import RequestLoggingMiddleware
+from .schemas import HealthResponse
+from .settings import BaseServiceSettings, create_settings_loader, get_settings
+from .tasks import create_celery_app, build_notification_task, build_ping_task
+
+__version__ = "0.0.1"
+
+__all__ = [
+    "create_app",
+    "BaseServiceSettings",
+    "create_settings_loader",
+    "get_settings",
+    "configure_logging",
+    "RequestLoggingMiddleware",
+    "AuthenticationError",
+    "AuthenticatedUser",
+    "SpapsAuthService",
+    "SpapsAuthMiddleware",
+    "build_spaps_auth_service",
+    "HealthRouterFactory",
+    "HealthResponse",
+    "build_base_router",
+    "DatabaseResources",
+    "create_async_sessionmaker",
+    "session_dependency_factory",
+    "AlembicMigrationRunner",
+    "create_migration_runner",
+    "create_celery_app",
+    "build_ping_task",
+    "build_notification_task",
+    "validate_migration_filename",
+    "collect_directory_errors",
+    "ensure_known_domain",
+    "allowed_domains",
+    "slugify_title",
+    "__version__",
+]

spaps_server_quickstart-0.0.1/src/spaps_server_quickstart/alembic/__init__.py

@@ -0,0 +1,21 @@
+"""
+Alembic helpers for naming conventions and migration utilities.
+"""
+
+from .naming import (
+    allowed_domains,
+    build_revision_message,
+    collect_directory_errors,
+    ensure_known_domain,
+    slugify_title,
+    validate_migration_filename,
+)
+
+__all__ = [
+    "validate_migration_filename",
+    "collect_directory_errors",
+    "ensure_known_domain",
+    "allowed_domains",
+    "slugify_title",
+    "build_revision_message",
+]