semblance 0.2.2__tar.gz → 0.4.0__tar.gz

{semblance-0.2.2/src/semblance.egg-info → semblance-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semblance
-Version: 0.2.2
+Version: 0.4.0
 Summary: Schema-driven REST API simulation with FastAPI, Pydantic, and Polyfactory
 Author: Semblance Contributors
 License-Expression: MIT
@@ -25,6 +25,7 @@ Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: httpx>=0.25.0; extra == "dev"
+Requires-Dist: hypothesis>=6.0.0; extra == "dev"
 Requires-Dist: ruff>=0.8.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: bandit>=1.7.0; extra == "dev"
@@ -55,7 +56,7 @@ Define API behavior declaratively using schemas and dependency metadata—no end
 - **FastAPI-native** — Full OpenAPI, validation, async
 - **Deterministic** — Seeded generation for reproducible tests
 - **Extensible** — Custom link types via plugins
-- **Production-ready** — Error simulation, latency, pagination, stateful mode
+- **Production-ready** — Error simulation, latency, rate limiting, pagination, stateful mode, optional response validation
 
 ## Requirements
 
@@ -100,10 +101,10 @@ class User(BaseModel):
     ]
 
 
-api = SemblanceAPI()
+api = SemblanceAPI(seed=42)
 
 
-@api.get("/users", input=UserQuery, output=list[User])
+@api.get("/users", input=UserQuery, output=list[User], list_count=2)
 def users():
     pass
 
@@ -111,6 +112,8 @@ def users():
 app = api.as_fastapi()
 ```
 
+You can register PUT, PATCH, and DELETE endpoints the same way (`@api.put(...)`, `@api.patch(...)`, `@api.delete(..., output=None)` for 204).
+
 Run:
 
 ```bash
@@ -125,7 +128,16 @@ Try:
 curl "http://127.0.0.1:8000/users?name=alice&start_date=2024-01-01&end_date=2024-12-31"
 ```
 
-Responses are generated from your output model: `name` comes from the query, `created_at` is random in the date range.
+Example output (with `SemblanceAPI(seed=42)` and `list_count=2` for reproducibility):
+
+```json
+[
+  {"name": "alice", "created_at": "2024-08-21T09:22:43.516168"},
+  {"name": "alice", "created_at": "2024-01-10T03:05:39.176702"}
+]
+```
+
+Responses are generated from your output model: `name` comes from the query, `created_at` is in the date range.
 
 ## Use Cases
 
@@ -145,7 +157,7 @@ semblance run app:api [--host HOST] [--port PORT] [--reload]
 # Export OpenAPI schema (optionally with response examples)
 semblance export openapi app:api [-o FILE] [--examples]
 
-# Export JSON fixtures per endpoint
+# Export OpenAPI + JSON fixtures per endpoint (GET, POST, PUT, PATCH, DELETE)
 semblance export fixtures app:api [-o DIR]
 ```
 
@@ -175,16 +187,19 @@ semblance run examples.plugins.app:api --port 8000
 
 ## Testing
 
+Use the same `api` from Quick Start (with `app = api.as_fastapi()`). With the test client you get deterministic responses without starting a server:
+
 ```python
 from semblance import SemblanceAPI, test_client
 
-app = api.as_fastapi()
+# api and app from Quick Start above
 client = test_client(app)
 
 r = client.get("/users?name=testuser")
 assert r.status_code == 200
 data = r.json()
 assert all(u["name"] == "testuser" for u in data)
+# data is a list of User dicts, e.g. [{"name": "testuser", "created_at": "..."}, ...]
 ```
 
 Deterministic seeding for reproducible tests:
@@ -219,15 +234,18 @@ class User(BaseModel):
 
 | Feature | Description |
 |---------|-------------|
-| **SemblanceAPI** | GET and POST endpoints with input/output models |
+| **SemblanceAPI** | GET, POST, PUT, PATCH, DELETE endpoints with input/output models |
 | **Links** | FromInput, DateRangeFrom, WhenInput, ComputedFrom |
 | **Pagination** | PageParams, PaginatedResponse[T] |
 | **Seeding** | `SemblanceAPI(seed=42)` or `seed_from="seed"` |
 | **Error simulation** | `error_rate`, `error_codes` |
 | **Latency** | `latency_ms`, `jitter_ms` |
+| **Rate limiting** | `rate_limit=N` — 429 when exceeded (per endpoint, sliding window) |
 | **Filtering** | `filter_by` for list endpoints |
-| **Stateful mode** | `SemblanceAPI(stateful=True)` — POST stores, GET returns stored |
+| **Stateful mode** | `SemblanceAPI(stateful=True)` — POST stores; GET (list + by-id), PUT/PATCH/DELETE by id use store |
+| **Response validation** | `SemblanceAPI(validate_responses=True)` — verify output conforms to model |
 | **OpenAPI** | summary, description, tags on endpoints |
+| **Property-based testing** | `semblance.property_testing`: `strategy_for_input_model()`, `test_endpoint()` (Hypothesis) |
 
 ## Competitors & Alternatives
 
@@ -245,7 +263,7 @@ class User(BaseModel):
 | **Extensible (plugins)** | ✅ | <span title="Middleware-based; custom behavior via decorators or wrappers">🟡</span> | ❌ | ❌ | ✅ | <span title="Templates and response rules provide extensibility">🟡</span> |
 | **OpenAPI schema** | ✅ | ✅ | ✅ | ❌ | ✅ | <span title="Can import/export OpenAPI; design is GUI-first, not schema-first">🟡</span> |
 | **CI / pytest integration** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
-| **Property-based testing** | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
+| **Property-based testing** | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ |
 
 🟡 = partial or configurable
 

{semblance-0.2.2 → semblance-0.4.0}/README.md

@@ -16,7 +16,7 @@ Define API behavior declaratively using schemas and dependency metadata—no end
 - **FastAPI-native** — Full OpenAPI, validation, async
 - **Deterministic** — Seeded generation for reproducible tests
 - **Extensible** — Custom link types via plugins
-- **Production-ready** — Error simulation, latency, pagination, stateful mode
+- **Production-ready** — Error simulation, latency, rate limiting, pagination, stateful mode, optional response validation
 
 ## Requirements
 
@@ -61,10 +61,10 @@ class User(BaseModel):
     ]
 
 
-api = SemblanceAPI()
+api = SemblanceAPI(seed=42)
 
 
-@api.get("/users", input=UserQuery, output=list[User])
+@api.get("/users", input=UserQuery, output=list[User], list_count=2)
 def users():
     pass
 
@@ -72,6 +72,8 @@ def users():
 app = api.as_fastapi()
 ```
 
+You can register PUT, PATCH, and DELETE endpoints the same way (`@api.put(...)`, `@api.patch(...)`, `@api.delete(..., output=None)` for 204).
+
 Run:
 
 ```bash
@@ -86,7 +88,16 @@ Try:
 curl "http://127.0.0.1:8000/users?name=alice&start_date=2024-01-01&end_date=2024-12-31"
 ```
 
-Responses are generated from your output model: `name` comes from the query, `created_at` is random in the date range.
+Example output (with `SemblanceAPI(seed=42)` and `list_count=2` for reproducibility):
+
+```json
+[
+  {"name": "alice", "created_at": "2024-08-21T09:22:43.516168"},
+  {"name": "alice", "created_at": "2024-01-10T03:05:39.176702"}
+]
+```
+
+Responses are generated from your output model: `name` comes from the query, `created_at` is in the date range.
 
 ## Use Cases
 
@@ -106,7 +117,7 @@ semblance run app:api [--host HOST] [--port PORT] [--reload]
 # Export OpenAPI schema (optionally with response examples)
 semblance export openapi app:api [-o FILE] [--examples]
 
-# Export JSON fixtures per endpoint
+# Export OpenAPI + JSON fixtures per endpoint (GET, POST, PUT, PATCH, DELETE)
 semblance export fixtures app:api [-o DIR]
 ```
 
@@ -136,16 +147,19 @@ semblance run examples.plugins.app:api --port 8000
 
 ## Testing
 
+Use the same `api` from Quick Start (with `app = api.as_fastapi()`). With the test client you get deterministic responses without starting a server:
+
 ```python
 from semblance import SemblanceAPI, test_client
 
-app = api.as_fastapi()
+# api and app from Quick Start above
 client = test_client(app)
 
 r = client.get("/users?name=testuser")
 assert r.status_code == 200
 data = r.json()
 assert all(u["name"] == "testuser" for u in data)
+# data is a list of User dicts, e.g. [{"name": "testuser", "created_at": "..."}, ...]
 ```
 
 Deterministic seeding for reproducible tests:
@@ -180,15 +194,18 @@ class User(BaseModel):
 
 | Feature | Description |
 |---------|-------------|
-| **SemblanceAPI** | GET and POST endpoints with input/output models |
+| **SemblanceAPI** | GET, POST, PUT, PATCH, DELETE endpoints with input/output models |
 | **Links** | FromInput, DateRangeFrom, WhenInput, ComputedFrom |
 | **Pagination** | PageParams, PaginatedResponse[T] |
 | **Seeding** | `SemblanceAPI(seed=42)` or `seed_from="seed"` |
 | **Error simulation** | `error_rate`, `error_codes` |
 | **Latency** | `latency_ms`, `jitter_ms` |
+| **Rate limiting** | `rate_limit=N` — 429 when exceeded (per endpoint, sliding window) |
 | **Filtering** | `filter_by` for list endpoints |
-| **Stateful mode** | `SemblanceAPI(stateful=True)` — POST stores, GET returns stored |
+| **Stateful mode** | `SemblanceAPI(stateful=True)` — POST stores; GET (list + by-id), PUT/PATCH/DELETE by id use store |
+| **Response validation** | `SemblanceAPI(validate_responses=True)` — verify output conforms to model |
 | **OpenAPI** | summary, description, tags on endpoints |
+| **Property-based testing** | `semblance.property_testing`: `strategy_for_input_model()`, `test_endpoint()` (Hypothesis) |
 
 ## Competitors & Alternatives
 
@@ -206,7 +223,7 @@ class User(BaseModel):
 | **Extensible (plugins)** | ✅ | <span title="Middleware-based; custom behavior via decorators or wrappers">🟡</span> | ❌ | ❌ | ✅ | <span title="Templates and response rules provide extensibility">🟡</span> |
 | **OpenAPI schema** | ✅ | ✅ | ✅ | ❌ | ✅ | <span title="Can import/export OpenAPI; design is GUI-first, not schema-first">🟡</span> |
 | **CI / pytest integration** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
-| **Property-based testing** | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
+| **Property-based testing** | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ |
 
 🟡 = partial or configurable
 

{semblance-0.2.2 → semblance-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "semblance"
-version = "0.2.2"
+version = "0.4.0"
 description = "Schema-driven REST API simulation with FastAPI, Pydantic, and Polyfactory"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -35,6 +35,7 @@ dev = [
     "pytest>=7.0.0",
     "pytest-cov>=4.0.0",
     "httpx>=0.25.0",
+    "hypothesis>=6.0.0",
     "ruff>=0.8.0",
     "mypy>=1.0.0",
     "bandit>=1.7.0",
@@ -58,6 +59,9 @@ where = ["src"]
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 pythonpath = ["src"]
+markers = [
+    "slow: marks tests as slow (e.g. time.sleep); use -m 'not slow' for fast runs",
+]
 
 [tool.ruff]
 target-version = "py310"
@@ -73,9 +77,15 @@ ignore = ["E501"]
 python_version = "3.10"
 warn_return_any = true
 warn_unused_configs = true
+warn_unused_ignores = true
+no_implicit_optional = true
 disallow_untyped_defs = false
 mypy_path = "src"
 
+[[tool.mypy.overrides]]
+module = ["semblance.*"]
+disallow_untyped_defs = true
+
 [[tool.mypy.overrides]]
 module = ["polyfactory.*"]
 ignore_missing_imports = true
@@ -84,6 +94,22 @@ ignore_missing_imports = true
 module = ["semblance.api"]
 disable_error_code = ["valid-type"]
 
+[[tool.mypy.overrides]]
+module = ["semblance.rate_limit", "semblance.state", "semblance.pagination"]
+strict_optional = true
+
+[[tool.mypy.overrides]]
+module = ["semblance.export", "semblance.plugins"]
+strict_optional = true
+
+[[tool.mypy.overrides]]
+module = ["semblance.api", "semblance.factory"]
+strict_optional = true
+
+[[tool.mypy.overrides]]
+module = ["semblance.property_testing"]
+strict_optional = true
+
 [[tool.mypy.overrides]]
 module = ["tests.*"]
 disallow_untyped_defs = false