fast-platform 0.12.2__tar.gz

fast_platform-0.12.2/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) FastMVC contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

fast_platform-0.12.2/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: fast-platform
+Version: 0.12.2
+Summary: Umbrella package: fast_platform.configuration, fast_admin, fast_notifications, fast_resilience, fast_versioning, fast_features, fast_channels, fast_db, observability, analytics, queues, … — merged fast_* modules under one install.
+License: MIT
+Project-URL: Homepage, https://github.com/shregar1/fastMVC
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiokafka<1.0.0,>=0.8.0
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: starlette>=0.27.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: cryptography<44.0.0,>=41.0.0
+Requires-Dist: sqlalchemy<3.0.0,>=2.0.0
+Requires-Dist: jsonschema>=4.0.0
+Requires-Dist: redis<7.0.0,>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: aiosqlite>=0.19.0; extra == "dev"
+Requires-Dist: jinja2>=3.0.0; extra == "dev"
+Requires-Dist: mypy>=1.11.0; extra == "dev"
+Requires-Dist: basedpyright>=1.19.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: flake8>=7.0; extra == "dev"
+Requires-Dist: types-redis; extra == "dev"
+Provides-Extra: async
+Requires-Dist: asyncpg<1.0.0,>=0.29.0; extra == "async"
+Provides-Extra: rabbitmq
+Requires-Dist: pika>=1.3.0; extra == "rabbitmq"
+Provides-Extra: sqs
+Requires-Dist: boto3>=1.28.0; extra == "sqs"
+Provides-Extra: service-bus
+Requires-Dist: azure-servicebus>=7.0.0; extra == "service-bus"
+Provides-Extra: nats
+Requires-Dist: nats-py>=2.0.0; extra == "nats"
+Provides-Extra: vault
+Requires-Dist: hvac>=2.0.0; extra == "vault"
+Provides-Extra: aws
+Requires-Dist: boto3>=1.28.0; extra == "aws"
+Provides-Extra: gcp
+Requires-Dist: google-cloud-secret-manager>=2.0.0; extra == "gcp"
+Provides-Extra: pinecone
+Requires-Dist: pinecone-client>=3.0.0; extra == "pinecone"
+Provides-Extra: qdrant
+Requires-Dist: qdrant-client>=1.0.0; extra == "qdrant"
+Provides-Extra: weaviate
+Requires-Dist: weaviate-client>=4.0.0; extra == "weaviate"
+Provides-Extra: s3
+Requires-Dist: boto3>=1.28.0; extra == "s3"
+Provides-Extra: gcs
+Requires-Dist: google-cloud-storage>=2.10.0; extra == "gcs"
+Provides-Extra: azure
+Requires-Dist: azure-storage-blob>=12.17.0; extra == "azure"
+Provides-Extra: celery
+Requires-Dist: celery[redis]>=5.3.0; extra == "celery"
+Provides-Extra: rq
+Requires-Dist: rq>=1.0.0; extra == "rq"
+Provides-Extra: dramatiq
+Requires-Dist: dramatiq[redis]>=1.0.0; extra == "dramatiq"
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100.0; extra == "fastapi"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
+Provides-Extra: ollama
+Requires-Dist: httpx>=0.24.0; extra == "ollama"
+Provides-Extra: groq
+Requires-Dist: openai>=1.0.0; extra == "groq"
+Provides-Extra: mistral
+Requires-Dist: openai>=1.0.0; extra == "mistral"
+Provides-Extra: gemini
+Requires-Dist: google-generativeai>=0.8.0; extra == "gemini"
+Provides-Extra: protobuf
+Requires-Dist: protobuf>=5.0; extra == "protobuf"
+Provides-Extra: avro
+Requires-Dist: fastavro>=1.9; extra == "avro"
+Provides-Extra: oauth
+Requires-Dist: httpx>=0.24.0; extra == "oauth"
+Provides-Extra: pillow
+Requires-Dist: Pillow>=10.0.0; extra == "pillow"
+Provides-Extra: utils-pdf
+Requires-Dist: pypdf>=4.0.0; extra == "utils-pdf"
+Provides-Extra: meilisearch
+Requires-Dist: meilisearch>=0.31.0; extra == "meilisearch"
+Provides-Extra: typesense
+Requires-Dist: typesense>=0.18.0; extra == "typesense"
+Provides-Extra: opensearch
+Requires-Dist: opensearch-py>=2.0.0; extra == "opensearch"
+Provides-Extra: mongo
+Requires-Dist: pymongo>=4.0.0; extra == "mongo"
+Provides-Extra: elasticsearch
+Requires-Dist: elasticsearch<9.0.0,>=8.0.0; extra == "elasticsearch"
+Provides-Extra: dynamo
+Requires-Dist: boto3>=1.28.0; extra == "dynamo"
+Provides-Extra: cassandra
+Requires-Dist: cassandra-driver>=3.28.0; extra == "cassandra"
+Provides-Extra: cosmos
+Requires-Dist: azure-cosmos>=4.5.0; extra == "cosmos"
+Provides-Extra: web
+Requires-Dist: starlette>=0.27.0; extra == "web"
+Provides-Extra: segment
+Requires-Dist: analytics-python>=1.0.0; extra == "segment"
+Provides-Extra: posthog
+Requires-Dist: posthog>=3.0.0; extra == "posthog"
+Provides-Extra: mixpanel
+Requires-Dist: mixpanel>=4.0.0; extra == "mixpanel"
+Provides-Extra: jinja2
+Requires-Dist: jinja2>=3.0.0; extra == "jinja2"
+Provides-Extra: otel
+Requires-Dist: opentelemetry-api>=1.20.0; extra == "otel"
+Requires-Dist: opentelemetry-sdk>=1.20.0; extra == "otel"
+Requires-Dist: opentelemetry-exporter-otlp>=1.20.0; extra == "otel"
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.41b0; extra == "otel"
+Dynamic: license-file
+
+# fast-platform
+
+Single installable distribution (**`pip install fast-platform`**) that bundles many former standalone `fast_*` modules **unchanged at import time** (flat top-level imports such as `from notifications import …`, `from db import …`).
+
+Logical organization is defined by the **package taxonomy** in [`src/fast_platform/taxonomy.py`](src/fast_platform/taxonomy.py). Imports stay flat under `src/`; the taxonomy is used for docs, tests layout, and navigation.
+
+## Package taxonomy
+
+Each top-level name under `src/` belongs to exactly one **section** (`PackageSection`). The canonical mapping is `PACKAGE_TO_SECTION` in `fast_platform.taxonomy`.
+
+| Section | Meaning |
+|--------|---------|
+| **core** | Config, DTOs, errors, helpers, orchestration services |
+| **security** | Crypto, API keys, identity, secret backends |
+| **persistence** | SQLAlchemy + multi-backend datastores |
+| **data_platform** | Search, vectors, object storage, cache |
+| **messaging** | Queues, Kafka, jobs, events, notifications, webhooks |
+| **realtime** | Channels, streams, WebRTC |
+| **integrations** | LLM, payments, media, analytics, admin |
+| **operations** | Observability, OpenTelemetry, flags, tenancy, resilience, API versioning |
+
+### Packages by section
+
+| Section | Packages |
+|--------|----------|
+| **core** | `configuration`, `dtos`, `errors`, `utils`, `service`, `fast_platform` |
+| **security** | `security`, `secrets`, `identity` |
+| **persistence** | `db`, `datastores` |
+| **data_platform** | `search`, `vectors`, `storage`, `cache` |
+| **messaging** | `kafka`, `queues`, `events`, `jobs`, `notifications`, `webhooks` |
+| **realtime** | `channels`, `streams`, `webrtc` |
+| **integrations** | `llm`, `payments`, `media`, `analytics`, `admin` |
+| **operations** | `observability`, `otel`, `resilience`, `tenancy`, `versioning`, `features` |
+
+Use in code:
+
+```python
+from fast_platform.taxonomy import section_of, PackageSection
+
+section_of("notifications")  # PackageSection.MESSAGING
+```
+
+## Layout: `src/` vs `tests/`
+
+- **`src/`** — **flat** top-level packages (`configuration/`, `notifications/`, …) so existing imports remain stable.
+- **`tests/`** — mirrors the taxonomy: **`tests/<section_folder>/<package>/`**. Section folder names come from `SECTION_TEST_FOLDER` in `taxonomy.py` (e.g. `core`, `persistence`, `data_platform`). The security section uses **`sec`** (not `security`) so the `security` package can live at `tests/sec/security/` without a path collision.
+
+Example: tests for `utils` live under `tests/core/utils/`; tests for `notifications` under `tests/messaging/notifications/`.
+
+## Highlights (by import name)
+
+| Import | Role |
+|--------|------|
+| `configuration` | JSON config loaders + Pydantic DTOs per subsystem |
+| `dtos` | Shared Pydantic DTOs (`IDTO` base) |
+| `errors` | Structured HTTP-oriented exceptions (`BadInputError`, `NotFoundError`, …) |
+| `notifications` | Email/SMS/push templates, fan-out, idempotency, preferences (`pip install fast-platform[jinja2]` for templating extras) |
+| `resilience` | Circuit breakers, retries, bulkheads |
+| `versioning` | API versioning (`VersionedAPIRouter`, `VersioningMiddleware`, path/header/query strategies) |
+| `features` | In-app feature flags, rollout, targeting |
+| `channels` | Real-time hub, Redis/Kafka backends, presence, ACLs, metrics |
+| `db` | SQLAlchemy engine, sessions, `DBDependency` |
+| `datastores` | `IDataStore` adapters (Redis, Mongo, ES, …) |
+| `observability` | Logging, metrics, tracing, audit, OTLP |
+| `admin` | Admin API router (users, roles, audit log), generic SQLAlchemy CRUD routers |
+| `queues` | Queues (DLQ, envelope, backends) |
+| `jobs` | Background jobs |
+| `storage` | Object storage (S3, GCS, Azure) |
+| `secrets` | Secret backends + cache (Vault, AWS, GCP; not the stdlib `secrets` module) |
+| `vectors` | Vector stores |
+| `tenancy` | Multi-tenant context |
+| `webhooks` | Webhook signing / delivery |
+| `webrtc` | WebRTC signaling |
+| `llm` | LLM providers, tools, streaming |
+| `kafka` | Kafka producer/consumer, outbox |
+| `identity` | OAuth/OIDC, JWKS, API keys |
+| `media` | Uploads, variants, presigned URLs |
+| `payments` | Payment gateways, webhooks, SCA |
+| `search` | Meilisearch, Typesense, OpenSearch |
+| `security` | API keys, inbound webhooks, field encryption |
+
+**Install:** `pip install fast-platform`
+
+Optional backends: e.g. `pip install fast-platform[async,otel,rabbitmq,s3,openai,meilisearch,pillow]`.
+
+`pyfastmvc` depends on this wheel for these modules instead of many separate distributions.

fast_platform-0.12.2/README.md

@@ -0,0 +1,86 @@
+# fast-platform
+
+Single installable distribution (**`pip install fast-platform`**) that bundles many former standalone `fast_*` modules **unchanged at import time** (flat top-level imports such as `from notifications import …`, `from db import …`).
+
+Logical organization is defined by the **package taxonomy** in [`src/fast_platform/taxonomy.py`](src/fast_platform/taxonomy.py). Imports stay flat under `src/`; the taxonomy is used for docs, tests layout, and navigation.
+
+## Package taxonomy
+
+Each top-level name under `src/` belongs to exactly one **section** (`PackageSection`). The canonical mapping is `PACKAGE_TO_SECTION` in `fast_platform.taxonomy`.
+
+| Section | Meaning |
+|--------|---------|
+| **core** | Config, DTOs, errors, helpers, orchestration services |
+| **security** | Crypto, API keys, identity, secret backends |
+| **persistence** | SQLAlchemy + multi-backend datastores |
+| **data_platform** | Search, vectors, object storage, cache |
+| **messaging** | Queues, Kafka, jobs, events, notifications, webhooks |
+| **realtime** | Channels, streams, WebRTC |
+| **integrations** | LLM, payments, media, analytics, admin |
+| **operations** | Observability, OpenTelemetry, flags, tenancy, resilience, API versioning |
+
+### Packages by section
+
+| Section | Packages |
+|--------|----------|
+| **core** | `configuration`, `dtos`, `errors`, `utils`, `service`, `fast_platform` |
+| **security** | `security`, `secrets`, `identity` |
+| **persistence** | `db`, `datastores` |
+| **data_platform** | `search`, `vectors`, `storage`, `cache` |
+| **messaging** | `kafka`, `queues`, `events`, `jobs`, `notifications`, `webhooks` |
+| **realtime** | `channels`, `streams`, `webrtc` |
+| **integrations** | `llm`, `payments`, `media`, `analytics`, `admin` |
+| **operations** | `observability`, `otel`, `resilience`, `tenancy`, `versioning`, `features` |
+
+Use in code:
+
+```python
+from fast_platform.taxonomy import section_of, PackageSection
+
+section_of("notifications")  # PackageSection.MESSAGING
+```
+
+## Layout: `src/` vs `tests/`
+
+- **`src/`** — **flat** top-level packages (`configuration/`, `notifications/`, …) so existing imports remain stable.
+- **`tests/`** — mirrors the taxonomy: **`tests/<section_folder>/<package>/`**. Section folder names come from `SECTION_TEST_FOLDER` in `taxonomy.py` (e.g. `core`, `persistence`, `data_platform`). The security section uses **`sec`** (not `security`) so the `security` package can live at `tests/sec/security/` without a path collision.
+
+Example: tests for `utils` live under `tests/core/utils/`; tests for `notifications` under `tests/messaging/notifications/`.
+
+## Highlights (by import name)
+
+| Import | Role |
+|--------|------|
+| `configuration` | JSON config loaders + Pydantic DTOs per subsystem |
+| `dtos` | Shared Pydantic DTOs (`IDTO` base) |
+| `errors` | Structured HTTP-oriented exceptions (`BadInputError`, `NotFoundError`, …) |
+| `notifications` | Email/SMS/push templates, fan-out, idempotency, preferences (`pip install fast-platform[jinja2]` for templating extras) |
+| `resilience` | Circuit breakers, retries, bulkheads |
+| `versioning` | API versioning (`VersionedAPIRouter`, `VersioningMiddleware`, path/header/query strategies) |
+| `features` | In-app feature flags, rollout, targeting |
+| `channels` | Real-time hub, Redis/Kafka backends, presence, ACLs, metrics |
+| `db` | SQLAlchemy engine, sessions, `DBDependency` |
+| `datastores` | `IDataStore` adapters (Redis, Mongo, ES, …) |
+| `observability` | Logging, metrics, tracing, audit, OTLP |
+| `admin` | Admin API router (users, roles, audit log), generic SQLAlchemy CRUD routers |
+| `queues` | Queues (DLQ, envelope, backends) |
+| `jobs` | Background jobs |
+| `storage` | Object storage (S3, GCS, Azure) |
+| `secrets` | Secret backends + cache (Vault, AWS, GCP; not the stdlib `secrets` module) |
+| `vectors` | Vector stores |
+| `tenancy` | Multi-tenant context |
+| `webhooks` | Webhook signing / delivery |
+| `webrtc` | WebRTC signaling |
+| `llm` | LLM providers, tools, streaming |
+| `kafka` | Kafka producer/consumer, outbox |
+| `identity` | OAuth/OIDC, JWKS, API keys |
+| `media` | Uploads, variants, presigned URLs |
+| `payments` | Payment gateways, webhooks, SCA |
+| `search` | Meilisearch, Typesense, OpenSearch |
+| `security` | API keys, inbound webhooks, field encryption |
+
+**Install:** `pip install fast-platform`
+
+Optional backends: e.g. `pip install fast-platform[async,otel,rabbitmq,s3,openai,meilisearch,pillow]`.
+
+`pyfastmvc` depends on this wheel for these modules instead of many separate distributions.

fast_platform-0.12.2/pyproject.toml

@@ -0,0 +1,274 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fast-platform"
+version = "0.12.2"
+description = "Umbrella package: fast_platform.configuration, fast_admin, fast_notifications, fast_resilience, fast_versioning, fast_features, fast_channels, fast_db, observability, analytics, queues, … — merged fast_* modules under one install."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+dependencies = [
+    "aiokafka>=0.8.0,<1.0.0",
+    "fastapi>=0.100.0",
+    "starlette>=0.27.0",
+    "httpx>=0.24.0",
+    "pydantic>=2.0.0",
+    "loguru>=0.7.0",
+    "cryptography>=41.0.0,<44.0.0",
+    "sqlalchemy>=2.0.0,<3.0.0",
+    "jsonschema>=4.0.0",
+    "redis>=4.0.0,<7.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-asyncio>=0.21.0",
+    "aiosqlite>=0.19.0",
+    "jinja2>=3.0.0",
+    # Static typing (strict)
+    "mypy>=1.11.0",
+    "basedpyright>=1.19.0",
+    "ruff>=0.8.0",
+    "black>=24.0",
+    "flake8>=7.0",
+    "types-redis",
+]
+# fast_db
+async = ["asyncpg>=0.29.0,<1.0.0"]
+# fast_queues
+rabbitmq = ["pika>=1.3.0"]
+sqs = ["boto3>=1.28.0"]
+service-bus = ["azure-servicebus>=7.0.0"]
+nats = ["nats-py>=2.0.0"]
+# fast_secrets
+vault = ["hvac>=2.0.0"]
+aws = ["boto3>=1.28.0"]
+gcp = ["google-cloud-secret-manager>=2.0.0"]
+# fast_vectors
+pinecone = ["pinecone-client>=3.0.0"]
+qdrant = ["qdrant-client>=1.0.0"]
+weaviate = ["weaviate-client>=4.0.0"]
+# fast_storage
+s3 = ["boto3>=1.28.0"]
+gcs = ["google-cloud-storage>=2.10.0"]
+azure = ["azure-storage-blob>=12.17.0"]
+# fast_jobs
+celery = ["celery[redis]>=5.3.0"]
+rq = ["rq>=1.0.0"]
+dramatiq = ["dramatiq[redis]>=1.0.0"]
+# fast_webhooks
+fastapi = ["fastapi>=0.100.0"]
+# fast_llm
+openai = ["openai>=1.0.0"]
+anthropic = ["anthropic>=0.18.0"]
+ollama = ["httpx>=0.24.0"]
+groq = ["openai>=1.0.0"]
+mistral = ["openai>=1.0.0"]
+gemini = ["google-generativeai>=0.8.0"]
+# fast_kafka
+protobuf = ["protobuf>=5.0"]
+avro = ["fastavro>=1.9"]
+# fast_identity
+oauth = ["httpx>=0.24.0"]
+# fast_media
+pillow = ["Pillow>=10.0.0"]
+# utils (PDF helpers)
+utils-pdf = ["pypdf>=4.0.0"]
+# fast_search
+meilisearch = ["meilisearch>=0.31.0"]
+typesense = ["typesense>=0.18.0"]
+opensearch = ["opensearch-py>=2.0.0"]
+# fast_datastores
+mongo = ["pymongo>=4.0.0"]
+elasticsearch = ["elasticsearch>=8.0.0,<9.0.0"]
+dynamo = ["boto3>=1.28.0"]
+cassandra = ["cassandra-driver>=3.28.0"]
+cosmos = ["azure-cosmos>=4.5.0"]
+# fast_analytics
+web = ["starlette>=0.27.0"]
+segment = ["analytics-python>=1.0.0"]
+posthog = ["posthog>=3.0.0"]
+mixpanel = ["mixpanel>=4.0.0"]
+# fast_notifications (optional templating; redis is already a base dependency)
+jinja2 = ["jinja2>=3.0.0"]
+# fast_observability
+otel = [
+    "opentelemetry-api>=1.20.0",
+    "opentelemetry-sdk>=1.20.0",
+    "opentelemetry-exporter-otlp>=1.20.0",
+    "opentelemetry-instrumentation-fastapi>=0.41b0",
+]
+
+[project.urls]
+Homepage = "https://github.com/shregar1/fastMVC"
+
+# Type checking (strict):
+#   uv sync --extra dev
+#   uv run mypy src
+#   uv run basedpyright src
+#   uv run ruff check src tests
+# Optional modernization: ``uv run ruff check --select UP src``
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+fast_platform = ["configuration/**/*.json", "py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src", "."]
+asyncio_mode = "auto"
+# Many packages use the same test module basenames (e.g. test_public_api.py); importlib mode avoids collisions.
+addopts = "--import-mode=importlib"
+
+[tool.coverage.run]
+source = ["src"]
+branch = false
+omit = [
+    "*/tests/*",
+]
+
+[tool.coverage.report]
+# Aggregate across many merged packages; optional backends inflate the tree.
+fail_under = 64
+show_missing = true
+exclude_lines = [
+    "pragma: no cover",
+    "\\.\\.\\.",
+    "if TYPE_CHECKING:",
+]
+
+# ---------------------------------------------------------------------------
+# Ruff — fast linter + import sorting; strict typing-related rules on ``src/``.
+# ---------------------------------------------------------------------------
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+# Strict typing + imports. Optional: ``uv run ruff check --select UP src`` (PEP 585/604 modernization).
+# Broader style: ``--extend-select E,W,B,RUF``
+select = [
+    "E9",     # runtime errors (syntax / import)
+    "F",      # pyflakes (incl. unused imports / undefined names)
+    "I",      # isort
+    "ANN",    # flake8-annotations
+    "PYI",    # flake8-pyi
+    "TC",     # flake8-type-checking (incl. TYPE_CHECKING imports)
+    "TID",    # tidy imports
+]
+ignore = [
+    "ANN401",  # typing.Any parameters — allowed when intentional
+]
+
+[tool.ruff.lint.per-file-ignores]
+# Tests: enforce correctness but allow looser annotations than production code.
+"tests/**" = [
+    "ANN001", "ANN002", "ANN003", "ANN201", "ANN202", "ANN204", "ANN205",
+    "TC001", "TC002", "TC003", "TC006",
+    "TID252",
+]
+"**/conftest.py" = ["ANN"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+# ---------------------------------------------------------------------------
+# Black — formatter (line length matches Ruff).
+# ---------------------------------------------------------------------------
+[tool.black]
+line-length = 100
+target-version = ["py310"]
+# Ruff’s formatter wraps ``kafka/lag.py`` differently than Black; omit from Black checks.
+extend-exclude = "/(build|dist|\\.venv|\\.eggs)/|src/kafka/lag\\.py"
+
+# ---------------------------------------------------------------------------
+# mypy — strict mode for ``src/`` (application code).
+# ---------------------------------------------------------------------------
+[tool.mypy]
+python_version = "3.10"
+mypy_path = "src"
+explicit_package_bases = true
+namespace_packages = true
+strict = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+warn_return_any = true
+warn_unreachable = true
+show_error_codes = true
+show_column_numbers = true
+pretty = true
+exclude = [
+    "^build/",
+    "^dist/",
+]
+
+plugins = ["pydantic.mypy"]
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+strict = false
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+warn_return_any = false
+check_untyped_defs = true
+
+# Third-party libraries without usable stubs: silence import-not-found noise.
+[[tool.mypy.overrides]]
+module = [
+    "aiokafka.*",
+    "boto3.*",
+    "botocore.*",
+    "cassandra.*",
+    "dramatiq.*",
+    "google.*",
+    "hvac.*",
+    "loguru",
+    "nats.*",
+    "opensearchpy.*",
+    "pinecone.*",
+    "posthog.*",
+    "pymongo.*",
+    "pypdf.*",
+    "qdrant_client.*",
+    "redis.*",
+    "rq.*",
+    "segment.*",
+    "weaviate.*",
+]
+ignore_missing_imports = true
+
+# ---------------------------------------------------------------------------
+# Based Pyright — duplicate strict signal (editor + CI); aligns with mypy on ``src/``.
+# ---------------------------------------------------------------------------
+[tool.basedpyright]
+pythonVersion = "3.10"
+typeCheckingMode = "strict"
+include = ["src"]
+exclude = ["**/node_modules", "**/__pycache__", "build", "dist"]
+executionEnvironments = [{ root = ".", extraPaths = ["src"] }]
+reportMissingImports = true
+reportMissingTypeStubs = true
+# ``Unknown``-shaped values from untyped deps overlap mypy; keep structural strictness here.
+reportUnknownMemberType = false
+reportUnknownArgumentType = false
+reportUnknownVariableType = false
+reportUnknownParameterType = false
+reportUnknownLambdaType = false
+reportUntypedFunctionDecorator = true
+reportUntypedClassDecorator = true
+reportUntypedBaseClass = true
+reportMissingTypeArgument = true
+reportInvalidTypeForm = true
+reportPrivateUsage = true
+reportIncompatibleMethodOverride = true
+reportIncompatibleVariableOverride = true
+reportOverlappingOverload = true
+useLibraryCodeForTypes = true

fast_platform-0.12.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fast_platform-0.12.2/src/admin/__init__.py

@@ -0,0 +1,31 @@
+"""
+fast_admin – CRUD API for admin resources (users, roles, audit log) for FastMVC.
+"""
+
+from .audit_hooks import (
+    AuditLogHook,
+    AuditTarget,
+    as_audit_hook,
+    audit_repository_hook,
+)
+from .crud import crud_router_from_model
+from .repositories import IAdminRoleRepository, IAdminUserRepository, IAuditLogRepository
+from .router import get_admin_router
+from .schemas import AdminRoleSummary, AdminUserSummary, AuditLogEntry
+
+__version__ = "0.1.1"
+
+__all__ = [
+    "AdminUserSummary",
+    "AdminRoleSummary",
+    "AuditLogEntry",
+    "IAdminUserRepository",
+    "IAdminRoleRepository",
+    "IAuditLogRepository",
+    "get_admin_router",
+    "crud_router_from_model",
+    "AuditLogHook",
+    "AuditTarget",
+    "audit_repository_hook",
+    "as_audit_hook",
+]

fast_platform-0.12.2/src/admin/abstraction.py

@@ -0,0 +1,14 @@
+"""admin package abstractions."""
+
+from __future__ import annotations
+
+from abc import ABC
+
+
+class IAdmin(ABC):
+    """Marker base for concrete types in the ``admin`` package."""
+
+    __slots__ = ()
+
+
+__all__ = ["IAdmin"]

fast_platform-0.12.2/src/admin/abstractions.py

@@ -0,0 +1,24 @@
+"""
+Admin resource abstractions: users, roles, audit log.
+
+Prefer importing from :mod:`admin.schemas` and :mod:`admin.repositories`;
+this module re-exports the same names for backward compatibility.
+"""
+
+from __future__ import annotations
+
+from .repositories import (
+    IAdminRoleRepository,
+    IAdminUserRepository,
+    IAuditLogRepository,
+)
+from .schemas import AdminRoleSummary, AdminUserSummary, AuditLogEntry
+
+__all__ = [
+    "AdminRoleSummary",
+    "AdminUserSummary",
+    "AuditLogEntry",
+    "IAdminUserRepository",
+    "IAdminRoleRepository",
+    "IAuditLogRepository",
+]