mockstack 0.14.0__tar.gz → 0.14.2__tar.gz

{mockstack-0.14.0 → mockstack-0.14.2}/.env.example

@@ -5,6 +5,10 @@
 # the strategy to use: filefixtures (the default) or proxyrules
 MOCKSTACK__STRATEGY = filefixtures
 
+# serve FastAPI's documentation routes (/docs, /redoc, /openapi.json and
+# /docs/oauth2-redirect) instead of passing those paths to the strategy (default: false)
+MOCKSTACK__OPENAPI_DOCS_ENABLED = false
+
 # strategy-specific settings
 
 # base dir for all templates. Required by the 'filefixtures' strategy

{mockstack-0.14.0 → mockstack-0.14.2}/.github/workflows/smoke-test-pypi.yml

@@ -46,16 +46,18 @@ jobs:
         run: |
           set -euo pipefail
           mkdir -p /tmp/mockstack-templates
+          echo '{"message": "Hello from mockstack!"}' > /tmp/mockstack-templates/index.j2
           uvx mockstack --templates-dir /tmp/mockstack-templates --port 18999 \
             > server.log 2>&1 &
           SERVER_PID=$!
           echo "started mockstack pid=$SERVER_PID"
 
-          # Poll for readiness for up to 30s. /openapi.json is served by FastAPI
-          # itself, so a 200 here proves import + app construction + uvicorn boot
-          # + HTTP serving are all healthy end-to-end.
+          # Poll for readiness for up to 30s. GET / is rendered from index.j2 by the
+          # filefixtures strategy, so a 200 here proves import + app construction +
+          # uvicorn boot + request handling are all healthy end-to-end. (FastAPI's
+          # /openapi.json is off by default since mockstack 0.14.2.)
           for i in $(seq 1 30); do
-            if curl -fsS http://127.0.0.1:18999/openapi.json -o /dev/null; then
+            if curl -fsS http://127.0.0.1:18999/ -o /dev/null; then
               echo "ready after ${i}s"
               READY=1
               break
@@ -75,8 +77,15 @@ jobs:
             exit 1
           fi
 
-          # Final assertion + capture status
-          curl -fsS http://127.0.0.1:18999/openapi.json -o /dev/null
+          # Final assertion: the strategy rendered the template.
+          BODY=$(curl -fsS http://127.0.0.1:18999/)
+          echo "GET / -> $BODY"
+          if [ "$BODY" != '{"message": "Hello from mockstack!"}' ]; then
+            echo "unexpected response; logs:"
+            cat server.log
+            kill "$SERVER_PID" 2>/dev/null || true
+            exit 1
+          fi
           echo "smoke test passed"
 
           kill "$SERVER_PID" 2>/dev/null || true

{mockstack-0.14.0 → mockstack-0.14.2}/CLAUDE.md

@@ -32,9 +32,12 @@ CLI flags, `MOCKSTACK__*` environment variables, or a `.env` file.
 - `mockstack/templating.py`: Jinja environment and path-to-template-name resolution
 - `mockstack/intent.py`, `mockstack/identifiers.py`: POST intent (search, command,
   create) and path-identifier heuristics
-- `mockstack/routers/`: catch-all and homepage routes
+- `mockstack/routers/`: the catch-all route; every path, `/` included, reaches the strategy.
+  FastAPI's `/docs`, `/redoc`, `/openapi.json` and `/docs/oauth2-redirect` routes are
+  only registered, ahead of the catch-all, when `openapi_docs_enabled` is set
 - `mockstack/tests/`: unit tests; `conftest.py` holds fixtures shared by unit and live
-  tests (`make_settings`, `make_request`, `write_rules`, `write_template`, `span`), and
+  tests (`make_settings`, `make_request`, `write_rules`, `write_template`, `span`, and
+  `asgi_client`, an httpx client that calls the `app` fixture in-process), and
   `strategies/conftest.py` adds strategy helpers (`traced_request`,
   `proxyrules_strategy`, `apply_rule`, `upstream_send`, `span_attributes`). Build settings with
   `make_settings`: it ignores

{mockstack-0.14.0 → mockstack-0.14.2}/Dockerfile

@@ -2,7 +2,7 @@
 
 # Define build argument for version
 ARG PYTHON_IMAGE_VERSION=3.13-slim
-ARG MOCKSTACK_VERSION=0.14.0
+ARG MOCKSTACK_VERSION=0.14.2
 
 # ---------------------------- Base Image --------------------------------
 

{mockstack-0.14.0 → mockstack-0.14.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mockstack
-Version: 0.14.0
+Version: 0.14.2
 Summary: An API mocking workhorse
 Author-email: Adam Ever-Hadani <mockstack.contact@gmail.com>
 License-Expression: MIT
@@ -17,7 +17,7 @@ Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: colorama>=0.4.6
-Requires-Dist: fastapi[standard]>=0.141.1
+Requires-Dist: fastapi>=0.141.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: opentelemetry-distro[otlp]>=0.65b0
@@ -27,7 +27,7 @@ Requires-Dist: pydantic-settings>=2.15.0
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: rich>=15.0.0
 Requires-Dist: typer>=0.27.2
-Requires-Dist: uvicorn>=0.53.0
+Requires-Dist: uvicorn[standard]>=0.53.0
 Provides-Extra: llm
 Requires-Dist: ollama>=0.6.2; extra == "llm"
 Dynamic: license-file

{mockstack-0.14.0 → mockstack-0.14.2}/docs/configuration.md

@@ -22,6 +22,7 @@ options (`--opentelemetry.enabled`); boolean options are flags with a `--no-` fo
 | `debug` | boolean | `false` | Whether to run in debug mode |
 | `host` | string | `0.0.0.0` | Host to run the server on |
 | `port` | integer | `8000` | Port to run the server on |
+| `openapi_docs_enabled` | boolean | `false` | Whether to serve FastAPI's documentation routes: `/docs`, `/redoc`, `/openapi.json` and `/docs/oauth2-redirect`. They take precedence over the catch-all route and document only that route, so by default they are off and those paths reach the strategy like any other |
 | `strategy` | string | `filefixtures` | Strategy to use for handling requests. Options: `filefixtures`, `proxyrules` |
 
 ## OpenTelemetry Settings

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack/config.py

@@ -55,6 +55,11 @@ class Settings(BaseSettings):
     # port to run the server on
     port: int = 8000
 
+    # whether to serve FastAPI's documentation routes (/docs, /redoc, /openapi.json and
+    # /docs/oauth2-redirect). They take precedence over the catch-all route, so they are
+    # off by default and those paths reach the strategy like any other.
+    openapi_docs_enabled: CliImplicitFlag[bool] = False
+
     # OpenTelemetry configuration
     opentelemetry: OpenTelemetrySettings = OpenTelemetrySettings()
 

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack/main.py

@@ -11,7 +11,6 @@ from mockstack.config import CliSettings, Settings, settings_provider
 from mockstack.lifespan import lifespan_provider
 from mockstack.middleware import middleware_provider
 from mockstack.routers.catchall import catchall_router_provider
-from mockstack.routers.homepage import homepage_router_provider
 from mockstack.strategies.factory import strategy_provider
 from mockstack.telemetry import opentelemetry_provider
 
@@ -20,13 +19,17 @@ def create_app(settings: Settings | None = None) -> FastAPI:
     """Create the fastapi app and bootstrap all dependencies."""
     settings = settings or settings_provider()
 
-    app = FastAPI(lifespan=lifespan_provider(settings))
+    # FastAPI adds its documentation routes ahead of the catch-all route; without an
+    # OpenAPI URL it adds none of them.
+    app = FastAPI(
+        lifespan=lifespan_provider(settings),
+        openapi_url="/openapi.json" if settings.openapi_docs_enabled else None,
+    )
 
     strategy_provider(app, settings)
     middleware_provider(app, settings)
     opentelemetry_provider(app, settings)
 
-    homepage_router_provider(app, settings)
     catchall_router_provider(app, settings)
 
     return app

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack/tests/conftest.py

@@ -1,12 +1,14 @@
 """Fixtures shared by the unit tests and the live tests."""
 
 import os
-from collections.abc import Callable, Iterable, Mapping
+from collections.abc import AsyncIterator, Callable, Iterable, Mapping
 from pathlib import Path
 from typing import Any
 from unittest.mock import MagicMock
 
+import httpx
 import pytest
+import pytest_asyncio
 import yaml
 from fastapi import FastAPI, Request
 from starlette.types import Message
@@ -121,6 +123,17 @@ def app(settings, span):
     return app
 
 
+@pytest_asyncio.fixture
+async def asgi_client(app) -> AsyncIterator[httpx.AsyncClient]:
+    """An ``httpx.AsyncClient`` that calls the ``app`` fixture in-process.
+
+    Requests go through ``httpx.ASGITransport``, so routes and middleware added to
+    ``app`` before the first request are served. The app's lifespan does not run.
+    """
+    async with httpx.AsyncClient(transport=httpx.ASGITransport(app=app), base_url="http://testserver") as client:
+        yield client
+
+
 @pytest.fixture
 def make_request() -> Callable[..., Request]:
     """Factory: a Starlette ``Request`` with a real ASGI ``receive`` channel.

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack/tests/routers/test_catchall.py

@@ -4,7 +4,6 @@ from unittest.mock import AsyncMock
 
 import pytest
 from fastapi.responses import JSONResponse
-from starlette.testclient import TestClient
 
 from mockstack.routers.catchall import catchall_router_provider
 
@@ -19,41 +18,43 @@ def mock_strategy():
 
 
 @pytest.fixture
-def client(app, settings, mock_strategy):
+def client(app, settings, mock_strategy, asgi_client):
     """A test client for an app whose catch-all router uses ``mock_strategy``."""
     app.state.strategy = mock_strategy
     catchall_router_provider(app, settings)
-    return TestClient(app)
+    return asgi_client
 
 
+@pytest.mark.asyncio
 @pytest.mark.parametrize("method", ["GET", "POST", "PUT", "DELETE", "PATCH"])
-def test_catchall_router_provider(client, mock_strategy, method):
+async def test_catchall_router_provider(client, mock_strategy, method):
     """Test that the catchall router provider sets up routes correctly."""
-    response = client.request(method, "/test/path")
+    response = await client.request(method, "/test/path")
 
     assert response.status_code == 200
     assert response.json() == {"message": "Mock response"}
     mock_strategy.apply.assert_called_once()
 
 
+@pytest.mark.asyncio
 @pytest.mark.parametrize("method", ["HEAD", "OPTIONS"])
-def test_catchall_router_routes_head_and_options_to_strategy(client, mock_strategy, method):
+async def test_catchall_router_routes_head_and_options_to_strategy(client, mock_strategy, method):
     """HEAD and OPTIONS must reach the strategy rather than get a router-level 405."""
-    response = client.request(method, "/test/path")
+    response = await client.request(method, "/test/path")
 
     assert response.status_code == 200
     mock_strategy.apply.assert_called_once()
     assert mock_strategy.apply.call_args.args[0].method == method
 
 
+@pytest.mark.asyncio
 @pytest.mark.parametrize("method", ["HEAD", "OPTIONS"])
-def test_catchall_router_filefixtures_still_rejects_head_and_options(app, settings, method):
+async def test_catchall_router_filefixtures_still_rejects_head_and_options(app, settings, asgi_client, method):
     """Routed to the filefixtures strategy (the ``app`` fixture's), HEAD and OPTIONS are
     still answered 405 -- now by the strategy itself rather than by the router."""
     catchall_router_provider(app, settings)
-    client = TestClient(app, raise_server_exceptions=True)
 
-    response = client.request(method, "/test/path")
+    response = await asgi_client.request(method, "/test/path")
 
     assert response.status_code == 405
     if method == "OPTIONS":

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack/tests/test_config.py

@@ -62,6 +62,30 @@ def test_filefixtures_without_templates_dir_names_the_right_strategy():
         Settings(strategy="filefixtures", templates_dir=None)
 
 
+def test_openapi_docs_enabled_defaults_to_off(make_settings, templates_dir):
+    assert make_settings(templates_dir=templates_dir).openapi_docs_enabled is False
+
+
+def test_openapi_docs_enabled_env_var(monkeypatch, templates_dir):
+    """``MOCKSTACK__OPENAPI_DOCS_ENABLED`` turns FastAPI's documentation routes on."""
+    monkeypatch.setenv("MOCKSTACK__OPENAPI_DOCS_ENABLED", "true")
+
+    assert Settings(templates_dir=templates_dir).openapi_docs_enabled is True
+
+
+def test_openapi_docs_enabled_cli_flag(templates_dir):
+    """``--openapi-docs-enabled`` turns the documentation routes on and its ``--no-`` form off."""
+    enabled = CliSettings(
+        _cli_parse_args=["--templates-dir", templates_dir, "--openapi-docs-enabled"]  # type: ignore[call-arg]
+    )
+    assert enabled.openapi_docs_enabled is True
+
+    disabled = CliSettings(
+        _cli_parse_args=["--templates-dir", templates_dir, "--no-openapi-docs-enabled"]  # type: ignore[call-arg]
+    )
+    assert disabled.openapi_docs_enabled is False
+
+
 def test_record_mode_defaults_to_off(make_settings, templates_dir):
     settings = make_settings(templates_dir=templates_dir)
     assert settings.proxyrules_record_mode == ProxyRulesRecordMode.OFF

mockstack-0.14.2/mockstack/tests/test_main.py

@@ -0,0 +1,61 @@
+"""Tests for the application factory."""
+
+import httpx
+import pytest
+
+from mockstack.main import create_app
+
+
+OPENAPI_DOCS_PATHS = ["/openapi.json", "/docs", "/docs/oauth2-redirect", "/redoc"]
+
+
+def _route_paths(app):
+    return {route.path for route in app.routes}
+
+
+@pytest.mark.asyncio
+async def test_create_app_routes_root_path_to_strategy(make_settings, write_template, tmp_path):
+    """``GET /`` reaches the strategy through the catch-all route: the app registers no
+    route of its own at the root path."""
+    write_template("index.j2", '{"message": "root fixture"}')
+    app = create_app(make_settings(strategy="filefixtures", templates_dir=tmp_path))
+
+    async with httpx.AsyncClient(transport=httpx.ASGITransport(app=app), base_url="http://testserver") as client:
+        response = await client.get("/")
+
+    assert response.status_code == 200
+    assert response.json() == {"message": "root fixture"}
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize("path", OPENAPI_DOCS_PATHS)
+async def test_create_app_passes_openapi_docs_paths_to_strategy_by_default(make_settings, tmp_path, path):
+    """FastAPI's documentation routes are off by default, so their paths reach the strategy
+    like any other: a filefixtures app with no templates answers them with its 404."""
+    app = create_app(make_settings(strategy="filefixtures", templates_dir=tmp_path))
+
+    assert not _route_paths(app) & set(OPENAPI_DOCS_PATHS)
+    async with httpx.AsyncClient(transport=httpx.ASGITransport(app=app), base_url="http://testserver") as client:
+        response = await client.get(path)
+
+    assert response.status_code == 404
+    assert response.json()["message"] == "mockstack: resource not found"
+
+
+@pytest.mark.asyncio
+async def test_create_app_serves_openapi_docs_when_enabled(make_settings, tmp_path):
+    """With ``openapi_docs_enabled`` FastAPI serves its documentation routes, ahead of the
+    catch-all route."""
+    app = create_app(make_settings(strategy="filefixtures", templates_dir=tmp_path, openapi_docs_enabled=True))
+
+    assert set(OPENAPI_DOCS_PATHS) <= _route_paths(app)
+    async with httpx.AsyncClient(transport=httpx.ASGITransport(app=app), base_url="http://testserver") as client:
+        docs = await client.get("/docs")
+        # FastAPI gives every method of one route the same operation ID, and says so.
+        with pytest.warns(UserWarning, match="Duplicate Operation ID"):
+            schema = await client.get("/openapi.json")
+
+    assert docs.status_code == 200
+    assert docs.headers["content-type"].startswith("text/html")
+    assert schema.status_code == 200
+    assert "/{full_path}" in schema.json()["paths"]

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack/tests/test_middleware.py

@@ -1,11 +1,12 @@
 """Tests for the middleware module."""
 
-from starlette.testclient import TestClient
+import pytest
 
 from mockstack.middleware import middleware_provider
 
 
-def test_middleware_provider_process_time(app, settings):
+@pytest.mark.asyncio
+async def test_middleware_provider_process_time(app, settings, asgi_client):
     """Test that the middleware provider adds the process time header."""
     middleware_provider(app, settings)
 
@@ -13,7 +14,7 @@ def test_middleware_provider_process_time(app, settings):
     def route():
         return {"message": "test"}
 
-    response = TestClient(app).get("/test")
+    response = await asgi_client.get("/test")
 
     assert response.status_code == 200
     assert response.json() == {"message": "test"}

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mockstack
-Version: 0.14.0
+Version: 0.14.2
 Summary: An API mocking workhorse
 Author-email: Adam Ever-Hadani <mockstack.contact@gmail.com>
 License-Expression: MIT
@@ -17,7 +17,7 @@ Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: colorama>=0.4.6
-Requires-Dist: fastapi[standard]>=0.141.1
+Requires-Dist: fastapi>=0.141.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: opentelemetry-distro[otlp]>=0.65b0
@@ -27,7 +27,7 @@ Requires-Dist: pydantic-settings>=2.15.0
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: rich>=15.0.0
 Requires-Dist: typer>=0.27.2
-Requires-Dist: uvicorn>=0.53.0
+Requires-Dist: uvicorn[standard]>=0.53.0
 Provides-Extra: llm
 Requires-Dist: ollama>=0.6.2; extra == "llm"
 Dynamic: license-file

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack.egg-info/SOURCES.txt

@@ -99,7 +99,6 @@ mockstack/llm/__init__.py
 mockstack/llm/ollama.py
 mockstack/routers/__init__.py
 mockstack/routers/catchall.py
-mockstack/routers/homepage.py
 mockstack/strategies/__init__.py
 mockstack/strategies/base.py
 mockstack/strategies/create_mixin.py
@@ -114,6 +113,7 @@ mockstack/tests/test_docs_settings.py
 mockstack/tests/test_docs_yaml.py
 mockstack/tests/test_identifiers.py
 mockstack/tests/test_intent.py
+mockstack/tests/test_main.py
 mockstack/tests/test_middleware.py
 mockstack/tests/test_recording.py
 mockstack/tests/test_rules.py
@@ -135,7 +135,6 @@ mockstack/tests/llm/__init__.py
 mockstack/tests/llm/test_ollama.py
 mockstack/tests/routers/__init__.py
 mockstack/tests/routers/test_catchall.py
-mockstack/tests/routers/test_homepage.py
 mockstack/tests/strategies/__init__.py
 mockstack/tests/strategies/conftest.py
 mockstack/tests/strategies/test_create_mixin.py

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack.egg-info/requires.txt

@@ -1,5 +1,5 @@
 colorama>=0.4.6
-fastapi[standard]>=0.141.1
+fastapi>=0.141.1
 httpx>=0.28.1
 jinja2>=3.1.6
 opentelemetry-distro[otlp]>=0.65b0
@@ -9,7 +9,7 @@ pydantic-settings>=2.15.0
 pyyaml>=6.0.3
 rich>=15.0.0
 typer>=0.27.2
-uvicorn>=0.53.0
+uvicorn[standard]>=0.53.0
 
 [llm]
 ollama>=0.6.2

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack.egg-info/scm_file_list.json

@@ -88,7 +88,6 @@
     "mockstack/recording.py",
     "mockstack/routers/__init__.py",
     "mockstack/routers/catchall.py",
-    "mockstack/routers/homepage.py",
     "mockstack/rules.py",
     "mockstack/strategies/__init__.py",
     "mockstack/strategies/base.py",
@@ -116,7 +115,6 @@
     "mockstack/tests/llm/test_ollama.py",
     "mockstack/tests/routers/__init__.py",
     "mockstack/tests/routers/test_catchall.py",
-    "mockstack/tests/routers/test_homepage.py",
     "mockstack/tests/strategies/__init__.py",
     "mockstack/tests/strategies/conftest.py",
     "mockstack/tests/strategies/test_create_mixin.py",
@@ -130,6 +128,7 @@
     "mockstack/tests/test_docs_yaml.py",
     "mockstack/tests/test_identifiers.py",
     "mockstack/tests/test_intent.py",
+    "mockstack/tests/test_main.py",
     "mockstack/tests/test_middleware.py",
     "mockstack/tests/test_recording.py",
     "mockstack/tests/test_rules.py",

{mockstack-0.14.0 → mockstack-0.14.2}/mockstack.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "0.14.0",
+  "tag": "0.14.2",
   "distance": 0,
-  "node": "g96e7689044f1b72430a7acb6ab3cec1989805660",
+  "node": "g24d55a15eafcd996e27f2415d9911f4cdea0adf0",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-09-15"

{mockstack-0.14.0 → mockstack-0.14.2}/pyproject.toml

@@ -21,7 +21,7 @@ classifiers = [
 requires-python = ">=3.13"
 dependencies = [
     "colorama>=0.4.6",
-    "fastapi[standard]>=0.141.1",
+    "fastapi>=0.141.1",
     "httpx>=0.28.1",
     "jinja2>=3.1.6",
     "opentelemetry-distro[otlp]>=0.65b0",
@@ -31,7 +31,8 @@ dependencies = [
     "pyyaml>=6.0.3",
     "rich>=15.0.0",
     "typer>=0.27.2",
-    "uvicorn>=0.53.0",
+    # The standard extra installs uvloop and httptools, which uvicorn uses when present.
+    "uvicorn[standard]>=0.53.0",
 ]
 dynamic = ["version"]
 
@@ -94,11 +95,8 @@ addopts = "-m 'not slow'"
 # strict_config, strict_markers, strict_xfail and strict_parametrization_ids.
 strict = true
 filterwarnings = [
-    # A warning raised from mockstack's own modules (tests included) is an error...
+    # A warning raised from mockstack's own modules (tests included) is an error.
     "error:::mockstack",
-    # ...except Starlette's deprecation of httpx in its test client, which it attributes
-    # to the module importing `starlette.testclient`.
-    "default:Using `httpx` with `starlette.testclient` is deprecated",
 ]
 
 [tool.coverage.run]