svc-infra 0.1.623__tar.gz → 0.1.624__tar.gz

{svc_infra-0.1.623 → svc_infra-0.1.624}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: svc-infra
-Version: 0.1.623
+Version: 0.1.624
 Summary: Infrastructure for building and deploying prod-ready services
 License: MIT
 Keywords: fastapi,sqlalchemy,alembic,auth,infra,async,pydantic
@@ -77,25 +77,34 @@ Description-Content-Type: text/markdown
 # svc-infra
 
 [![PyPI](https://img.shields.io/pypi/v/svc-infra.svg)](https://pypi.org/project/svc-infra/)
-[![Docs](https://img.shields.io/badge/docs-reference-blue)](src/svc_infra/docs/)
+[![Docs](https://img.shields.io/badge/docs-reference-blue)](.)
 
 svc-infra packages the shared building blocks we use to ship production FastAPI services fast—HTTP APIs with secure auth, durable persistence, background execution, cache, observability, and webhook plumbing that all share the same batteries-included defaults.
 
 ## Helper index
 
-| Helper | What it covers | Guide |
+| Area | What it covers | Guide |
 | --- | --- | --- |
-| API | FastAPI bootstrap, envelopes, middleware, docs wiring | [FastAPI guide](src/svc_infra/docs/api.md) |
-| Auth | Sessions, OAuth/OIDC, MFA, SMTP delivery | [Auth settings](src/svc_infra/docs/auth.md) |
-| Database | SQL + Mongo wiring, Alembic helpers, inbox/outbox patterns | [Database guide](src/svc_infra/docs/database.md) |
-| Jobs | JobQueue, scheduler, CLI worker | [Jobs quickstart](src/svc_infra/docs/jobs.md) |
-| Cache | cashews decorators, namespace management, TTL helpers | [Cache guide](src/svc_infra/docs/cache.md) |
-| Observability | Prometheus middleware, Grafana automation, OTEL hooks | [Observability guide](src/svc_infra/docs/observability.md) |
-| Ops | Probes, breaker, SLOs & dashboards | [SLOs & Ops](src/svc_infra/docs/ops.md) |
-| Webhooks | Subscription store, signing, retry worker | [Webhooks framework](src/svc_infra/docs/webhooks.md) |
-| Security | Password policy, lockout, signed cookies, headers | [Security hardening](src/svc_infra/docs/security.md) |
-| Contributing | Dev setup and quality gates | [Contributing guide](src/svc_infra/docs/contributing.md) |
-| Data Lifecycle | Fixtures, retention, erasure, backups | [Data lifecycle](src/svc_infra/docs/data-lifecycle.md) |
+| Getting Started | Overview and entry points | [This page](getting-started.md) |
+| Environment | Feature switches and env vars | [Environment](environment.md) |
+| API | FastAPI bootstrap, middleware, docs wiring | [API guide](api.md) |
+| Auth | Sessions, OAuth/OIDC, MFA, SMTP delivery | [Auth](auth.md) |
+| Security | Password policy, lockout, signed cookies, headers | [Security](security.md) |
+| Database | SQL + Mongo wiring, Alembic helpers, inbox/outbox patterns | [Database](database.md) |
+| Tenancy | Multi-tenant boundaries and helpers | [Tenancy](tenancy.md) |
+| Idempotency | Idempotent endpoints and middleware | [Idempotency](idempotency.md) |
+| Rate Limiting | Middleware, dependency limiter, headers | [Rate limiting](rate-limiting.md) |
+| Cache | cashews decorators, namespace management, TTL helpers | [Cache](cache.md) |
+| Jobs | JobQueue, scheduler, CLI worker | [Jobs](jobs.md) |
+| Observability | Prometheus, Grafana, OpenTelemetry | [Observability](observability.md) |
+| Ops | Probes, breakers, SLOs & dashboards | [Ops](ops.md) |
+| Webhooks | Subscription store, signing, retry worker | [Webhooks](webhooks.md) |
+| CLI | Command groups for sql/mongo/obs/docs/dx/sdk/jobs | [CLI](cli.md) |
+| Docs & SDKs | Publishing docs, generating SDKs | [Docs & SDKs](docs-and-sdks.md) |
+| Acceptance | Acceptance harness and flows | [Acceptance](acceptance.md), [Matrix](acceptance-matrix.md) |
+| Contributing | Dev setup and quality gates | [Contributing](contributing.md) |
+| Repo Review | Checklist for releasing/PRs | [Repo review](repo-review.md) |
+| Data Lifecycle | Fixtures, retention, erasure, backups | [Data lifecycle](data-lifecycle.md) |
 
 ## Minimal FastAPI bootstrap
 

{svc_infra-0.1.623 → svc_infra-0.1.624}/README.md

@@ -1,25 +1,34 @@
 # svc-infra
 
 [![PyPI](https://img.shields.io/pypi/v/svc-infra.svg)](https://pypi.org/project/svc-infra/)
-[![Docs](https://img.shields.io/badge/docs-reference-blue)](src/svc_infra/docs/)
+[![Docs](https://img.shields.io/badge/docs-reference-blue)](.)
 
 svc-infra packages the shared building blocks we use to ship production FastAPI services fast—HTTP APIs with secure auth, durable persistence, background execution, cache, observability, and webhook plumbing that all share the same batteries-included defaults.
 
 ## Helper index
 
-| Helper | What it covers | Guide |
+| Area | What it covers | Guide |
 | --- | --- | --- |
-| API | FastAPI bootstrap, envelopes, middleware, docs wiring | [FastAPI guide](src/svc_infra/docs/api.md) |
-| Auth | Sessions, OAuth/OIDC, MFA, SMTP delivery | [Auth settings](src/svc_infra/docs/auth.md) |
-| Database | SQL + Mongo wiring, Alembic helpers, inbox/outbox patterns | [Database guide](src/svc_infra/docs/database.md) |
-| Jobs | JobQueue, scheduler, CLI worker | [Jobs quickstart](src/svc_infra/docs/jobs.md) |
-| Cache | cashews decorators, namespace management, TTL helpers | [Cache guide](src/svc_infra/docs/cache.md) |
-| Observability | Prometheus middleware, Grafana automation, OTEL hooks | [Observability guide](src/svc_infra/docs/observability.md) |
-| Ops | Probes, breaker, SLOs & dashboards | [SLOs & Ops](src/svc_infra/docs/ops.md) |
-| Webhooks | Subscription store, signing, retry worker | [Webhooks framework](src/svc_infra/docs/webhooks.md) |
-| Security | Password policy, lockout, signed cookies, headers | [Security hardening](src/svc_infra/docs/security.md) |
-| Contributing | Dev setup and quality gates | [Contributing guide](src/svc_infra/docs/contributing.md) |
-| Data Lifecycle | Fixtures, retention, erasure, backups | [Data lifecycle](src/svc_infra/docs/data-lifecycle.md) |
+| Getting Started | Overview and entry points | [This page](getting-started.md) |
+| Environment | Feature switches and env vars | [Environment](environment.md) |
+| API | FastAPI bootstrap, middleware, docs wiring | [API guide](api.md) |
+| Auth | Sessions, OAuth/OIDC, MFA, SMTP delivery | [Auth](auth.md) |
+| Security | Password policy, lockout, signed cookies, headers | [Security](security.md) |
+| Database | SQL + Mongo wiring, Alembic helpers, inbox/outbox patterns | [Database](database.md) |
+| Tenancy | Multi-tenant boundaries and helpers | [Tenancy](tenancy.md) |
+| Idempotency | Idempotent endpoints and middleware | [Idempotency](idempotency.md) |
+| Rate Limiting | Middleware, dependency limiter, headers | [Rate limiting](rate-limiting.md) |
+| Cache | cashews decorators, namespace management, TTL helpers | [Cache](cache.md) |
+| Jobs | JobQueue, scheduler, CLI worker | [Jobs](jobs.md) |
+| Observability | Prometheus, Grafana, OpenTelemetry | [Observability](observability.md) |
+| Ops | Probes, breakers, SLOs & dashboards | [Ops](ops.md) |
+| Webhooks | Subscription store, signing, retry worker | [Webhooks](webhooks.md) |
+| CLI | Command groups for sql/mongo/obs/docs/dx/sdk/jobs | [CLI](cli.md) |
+| Docs & SDKs | Publishing docs, generating SDKs | [Docs & SDKs](docs-and-sdks.md) |
+| Acceptance | Acceptance harness and flows | [Acceptance](acceptance.md), [Matrix](acceptance-matrix.md) |
+| Contributing | Dev setup and quality gates | [Contributing](contributing.md) |
+| Repo Review | Checklist for releasing/PRs | [Repo review](repo-review.md) |
+| Data Lifecycle | Fixtures, retention, erasure, backups | [Data lifecycle](data-lifecycle.md) |
 
 ## Minimal FastAPI bootstrap
 

{svc_infra-0.1.623 → svc_infra-0.1.624}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "svc-infra"
-version = "0.1.623"
+version = "0.1.624"
 description = "Infrastructure for building and deploying prod-ready services"
 authors = ["Ali Khatami <aliikhatami94@gmail.com>"]
 license = "MIT"

svc_infra-0.1.624/src/svc_infra/docs/getting-started.md

@@ -0,0 +1,63 @@
+# svc-infra
+
+[![PyPI](https://img.shields.io/pypi/v/svc-infra.svg)](https://pypi.org/project/svc-infra/)
+[![Docs](https://img.shields.io/badge/docs-reference-blue)](.)
+
+svc-infra packages the shared building blocks we use to ship production FastAPI services fast—HTTP APIs with secure auth, durable persistence, background execution, cache, observability, and webhook plumbing that all share the same batteries-included defaults.
+
+## Helper index
+
+| Area | What it covers | Guide |
+| --- | --- | --- |
+| Getting Started | Overview and entry points | [This page](getting-started.md) |
+| Environment | Feature switches and env vars | [Environment](environment.md) |
+| API | FastAPI bootstrap, middleware, docs wiring | [API guide](api.md) |
+| Auth | Sessions, OAuth/OIDC, MFA, SMTP delivery | [Auth](auth.md) |
+| Security | Password policy, lockout, signed cookies, headers | [Security](security.md) |
+| Database | SQL + Mongo wiring, Alembic helpers, inbox/outbox patterns | [Database](database.md) |
+| Tenancy | Multi-tenant boundaries and helpers | [Tenancy](tenancy.md) |
+| Idempotency | Idempotent endpoints and middleware | [Idempotency](idempotency.md) |
+| Rate Limiting | Middleware, dependency limiter, headers | [Rate limiting](rate-limiting.md) |
+| Cache | cashews decorators, namespace management, TTL helpers | [Cache](cache.md) |
+| Jobs | JobQueue, scheduler, CLI worker | [Jobs](jobs.md) |
+| Observability | Prometheus, Grafana, OpenTelemetry | [Observability](observability.md) |
+| Ops | Probes, breakers, SLOs & dashboards | [Ops](ops.md) |
+| Webhooks | Subscription store, signing, retry worker | [Webhooks](webhooks.md) |
+| CLI | Command groups for sql/mongo/obs/docs/dx/sdk/jobs | [CLI](cli.md) |
+| Docs & SDKs | Publishing docs, generating SDKs | [Docs & SDKs](docs-and-sdks.md) |
+| Acceptance | Acceptance harness and flows | [Acceptance](acceptance.md), [Matrix](acceptance-matrix.md) |
+| Contributing | Dev setup and quality gates | [Contributing](contributing.md) |
+| Repo Review | Checklist for releasing/PRs | [Repo review](repo-review.md) |
+| Data Lifecycle | Fixtures, retention, erasure, backups | [Data lifecycle](data-lifecycle.md) |
+
+## Minimal FastAPI bootstrap
+
+```python
+from fastapi import Depends
+from svc_infra.api.fastapi.ease import easy_service_app
+from svc_infra.api.fastapi.db.sql.add import add_sql_db
+from svc_infra.cache import init_cache
+from svc_infra.jobs.easy import easy_jobs
+from svc_infra.webhooks.fastapi import require_signature
+
+app = easy_service_app(name="Billing", release="1.2.3")
+add_sql_db(app)              # reads SQL_URL / DB_* envs
+init_cache()                 # honors CACHE_PREFIX / CACHE_VERSION
+queue, scheduler = easy_jobs()  # switches via JOBS_DRIVER / REDIS_URL
+
+@app.post("/webhooks/billing")
+async def handle_webhook(payload = Depends(require_signature(lambda: ["current", "next"]))):
+    queue.enqueue("process-billing-webhook", payload)
+    return {"status": "queued"}
+```
+
+## Environment switches
+
+- **API** – toggle logging/observability and docs exposure with `ENABLE_LOGGING`, `LOG_LEVEL`, `LOG_FORMAT`, `ENABLE_OBS`, `METRICS_PATH`, `OBS_SKIP_PATHS`, and `CORS_ALLOW_ORIGINS`. 【F:src/svc_infra/api/fastapi/ease.py†L67-L111】【F:src/svc_infra/api/fastapi/setup.py†L47-L88】
+- **Auth** – configure JWT secrets, SMTP, cookies, and policy using the `AUTH_…` settings family (e.g., `AUTH_JWT__SECRET`, `AUTH_SMTP_HOST`, `AUTH_SESSION_COOKIE_SECURE`). 【F:src/svc_infra/api/fastapi/auth/settings.py†L23-L91】
+- **Database** – set connection URLs or components via `SQL_URL`/`SQL_URL_FILE`, `DB_DIALECT`, `DB_HOST`, `DB_USER`, `DB_PASSWORD`, plus Mongo knobs like `MONGO_URL`, `MONGO_DB`, and `MONGO_URL_FILE`. 【F:src/svc_infra/api/fastapi/db/sql/add.py†L55-L114】【F:src/svc_infra/db/sql/utils.py†L85-L206】【F:src/svc_infra/db/nosql/mongo/settings.py†L9-L13】【F:src/svc_infra/db/nosql/utils.py†L56-L113】
+- **Jobs** – choose the queue backend with `JOBS_DRIVER` and provide Redis via `REDIS_URL`; interval schedules can be declared with `JOBS_SCHEDULE_JSON`. 【F:src/svc_infra/jobs/easy.py†L11-L27】【F:src/svc_infra/docs/jobs.md†L11-L48】
+- **Cache** – namespace keys and lifetimes through `CACHE_PREFIX`, `CACHE_VERSION`, and TTL overrides `CACHE_TTL_DEFAULT`, `CACHE_TTL_SHORT`, `CACHE_TTL_LONG`. 【F:src/svc_infra/cache/README.md†L20-L173】【F:src/svc_infra/cache/ttl.py†L26-L55】
+- **Observability** – turn metrics on/off or adjust scrape paths with `ENABLE_OBS`, `METRICS_PATH`, `OBS_SKIP_PATHS`, and Prometheus/Grafana flags like `SVC_INFRA_DISABLE_PROMETHEUS`, `SVC_INFRA_RATE_WINDOW`, `SVC_INFRA_DASHBOARD_REFRESH`, `SVC_INFRA_DASHBOARD_RANGE`. 【F:src/svc_infra/api/fastapi/ease.py†L67-L111】【F:src/svc_infra/obs/metrics/asgi.py†L49-L206】【F:src/svc_infra/obs/cloud_dash.py†L85-L108】
+- **Webhooks** – reuse the jobs envs (`JOBS_DRIVER`, `REDIS_URL`) for the delivery worker and queue configuration. 【F:src/svc_infra/docs/webhooks.md†L32-L53】
+- **Security** – enforce password policy, MFA, and rotation with auth prefixes such as `AUTH_PASSWORD_MIN_LENGTH`, `AUTH_PASSWORD_REQUIRE_SYMBOL`, `AUTH_JWT__SECRET`, and `AUTH_JWT__OLD_SECRETS`. 【F:src/svc_infra/docs/security.md†L24-L70】

{svc_infra-0.1.623 → svc_infra-0.1.624}/src/svc_infra/mcp/svc_infra_mcp.py

@@ -3,9 +3,10 @@ from __future__ import annotations
 from enum import Enum
 
 from ai_infra.llm.tools.custom.cli import cli_cmd_help, cli_subcmd_help
+from ai_infra.mcp.server.tools import mcp_from_functions
+
 from svc_infra.app.env import prepare_env
 from svc_infra.cli.foundation.runner import run_from_root
-from ai_infra.mcp.server.tools import mcp_from_functions
 
 CLI_PROG = "svc-infra"
 
@@ -34,6 +35,7 @@ class Subcommand(str, Enum):
     sql_scaffold_models = "sql scaffold-models"
     sql_scaffold_schemas = "sql scaffold-schemas"
     sql_export_tenant = "sql export-tenant"
+    sql_seed = "sql seed"
 
     # Mongo group commands
     mongo_prepare = "mongo prepare"
@@ -49,6 +51,24 @@ class Subcommand(str, Enum):
     obs_down = "obs down"
     obs_scaffold = "obs scaffold"
 
+    # Docs group
+    docs_list = "docs list"
+    docs_show = "docs show"
+
+    # DX group
+    dx_openapi = "dx openapi"
+    dx_migrations = "dx migrations"
+    dx_changelog = "dx changelog"
+    dx_ci = "dx ci"
+
+    # Jobs group
+    jobs_run = "jobs run"
+
+    # SDK group
+    sdk_ts = "sdk ts"
+    sdk_py = "sdk py"
+    sdk_postman = "sdk postman"
+
 
 async def svc_infra_subcmd_help(subcommand: Subcommand) -> dict:
     """