mockstack 0.3.0__tar.gz → 0.4.1__tar.gz

{mockstack-0.3.0/mockstack.egg-info → mockstack-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mockstack
-Version: 0.3.0
+Version: 0.4.1
 Summary: An API mocking workhorse
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/adamhadani/mockstack
@@ -18,6 +18,7 @@ Requires-Dist: opentelemetry-instrumentation-fastapi>=0.53b1
 Requires-Dist: pydantic>=2.11.3
 Requires-Dist: pydantic-settings>=2.9.1
 Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: rich>=14.0.0
 Requires-Dist: typer>=0.15.2
 Requires-Dist: uvicorn>=0.34.2
 Dynamic: license-file
@@ -47,7 +48,7 @@ Highlights include:
 
 Install using [uv](https://docs.astral.sh/uv/). This package conforms the concept of a [tool](https://docs.astral.sh/uv/concepts/tools/) and hence can simply install / run with `uvx`:
 
-    uvx mockstack
+    uvx mockstack --help
 
 or install into a persistent environment and add it to the PATH with:
 
@@ -56,15 +57,20 @@ or install into a persistent environment and add it to the PATH with:
 
 ## Usage
 
-Available configuration options are [here](https://github.com/adamhadani/mockstack/blob/main/mockstack/config.py). Setting individual options can be done with env. variables as in the following example:
+Available configuration options are [here](https://github.com/adamhadani/mockstack/blob/main/mockstack/config.py).
+
+Setting individual options can be done either through an `.env` file, individual environment variables, or command-line arguments. For example:
 
 ```shell
+    export MOCKSTACK__STRATEGY=filefixtures
     export MOCKSTACK__TEMPLATES_DIR=~/mockstack-templates/
     export MOCKSTACK__OPENTELEMETRY__ENABLED=true
     export MOCKSTACK__OPENTELEMETRY__CAPTURE_RESPONSE_BODY=true
-    uv run
+    uvx mockstack
 ```
 
+See also the included [.env.example](https://github.com/adamhadani/mockstack/blob/main/.env.example) for more examples. You can copy that file to `.env` and fill in configuration as needed based on the given examples.
+
 Out of the box, you get the following behavior when using the default `filefixtures` strategy:
 
 - The HTTP request `GET /someservice/api/v1/user/c27f5b2b-6e81-420d-a4e4-6426e1c32db8` will try to find `<templates_dir>/someservice-api-v1-user.c27f5b2b-6e81-420d-a4e4-6426e1c32db8.j2`,
@@ -97,8 +103,8 @@ If you are contributing to development, you will want to clone this project, and
     uv sync
     uv pip install -e .
 
-Copy the included [.env.example](https://github.com/adamhadani/mockstack/blob/main/.env.example) file to `.env` and fill in configuration as needed based on the given examples.
-
 Run in development mode (for live-reload of changes when developing):
 
     uv run uvicorn --factory mockstack.main:create_app --reload
+
+Note that when you run using the uvicorn CLI, you will need to set any configuration via `.env` file or environment variables.

{mockstack-0.3.0 → mockstack-0.4.1}/README.md

@@ -23,7 +23,7 @@ Highlights include:
 
 Install using [uv](https://docs.astral.sh/uv/). This package conforms the concept of a [tool](https://docs.astral.sh/uv/concepts/tools/) and hence can simply install / run with `uvx`:
 
-    uvx mockstack
+    uvx mockstack --help
 
 or install into a persistent environment and add it to the PATH with:
 
@@ -32,15 +32,20 @@ or install into a persistent environment and add it to the PATH with:
 
 ## Usage
 
-Available configuration options are [here](https://github.com/adamhadani/mockstack/blob/main/mockstack/config.py). Setting individual options can be done with env. variables as in the following example:
+Available configuration options are [here](https://github.com/adamhadani/mockstack/blob/main/mockstack/config.py).
+
+Setting individual options can be done either through an `.env` file, individual environment variables, or command-line arguments. For example:
 
 ```shell
+    export MOCKSTACK__STRATEGY=filefixtures
     export MOCKSTACK__TEMPLATES_DIR=~/mockstack-templates/
     export MOCKSTACK__OPENTELEMETRY__ENABLED=true
     export MOCKSTACK__OPENTELEMETRY__CAPTURE_RESPONSE_BODY=true
-    uv run
+    uvx mockstack
 ```
 
+See also the included [.env.example](https://github.com/adamhadani/mockstack/blob/main/.env.example) for more examples. You can copy that file to `.env` and fill in configuration as needed based on the given examples.
+
 Out of the box, you get the following behavior when using the default `filefixtures` strategy:
 
 - The HTTP request `GET /someservice/api/v1/user/c27f5b2b-6e81-420d-a4e4-6426e1c32db8` will try to find `<templates_dir>/someservice-api-v1-user.c27f5b2b-6e81-420d-a4e4-6426e1c32db8.j2`,
@@ -73,8 +78,8 @@ If you are contributing to development, you will want to clone this project, and
     uv sync
     uv pip install -e .
 
-Copy the included [.env.example](https://github.com/adamhadani/mockstack/blob/main/.env.example) file to `.env` and fill in configuration as needed based on the given examples.
-
 Run in development mode (for live-reload of changes when developing):
 
     uv run uvicorn --factory mockstack.main:create_app --reload
+
+Note that when you run using the uvicorn CLI, you will need to set any configuration via `.env` file or environment variables.

{mockstack-0.3.0 → mockstack-0.4.1}/mockstack/config.py

@@ -2,9 +2,19 @@ from functools import lru_cache
 from typing import Any, Literal, Self
 
 from pydantic import DirectoryPath, FilePath, model_validator
-from pydantic_settings import BaseSettings, SettingsConfigDict
+from pydantic_settings import (
+    BaseSettings,
+    CliImplicitFlag,
+    CliSuppress,
+    SettingsConfigDict,
+)
 
-from mockstack.constants import ProxyRulesRedirectVia
+from mockstack.constants import (
+    ENV_FILE,
+    ENV_NESTED_DELIMITER,
+    ENV_PREFIX,
+    ProxyRulesRedirectVia,
+)
 
 
 class OpenTelemetrySettings(BaseSettings):
@@ -28,11 +38,20 @@ class Settings(BaseSettings):
     """
 
     model_config = SettingsConfigDict(
-        env_prefix="mockstack__",
-        env_file=".env",
-        env_nested_delimiter="__",
+        env_prefix=ENV_PREFIX,
+        env_file=ENV_FILE,
+        env_nested_delimiter=ENV_NESTED_DELIMITER,
     )
 
+    # whether to run in debug mode
+    debug: CliImplicitFlag[bool] = False
+
+    # host to run the server on
+    host: str = "0.0.0.0"
+
+    # port to run the server on
+    port: int = 8000
+
     # OpenTelemetry configuration
     opentelemetry: OpenTelemetrySettings = OpenTelemetrySettings()
 
@@ -51,11 +70,11 @@ class Settings(BaseSettings):
 
     # controls behavior of proxying. Whether to simulate creation of resources
     # when a POST request is made to a resource that doesn't match any rules..
-    proxyrules_simulate_create_on_missing: bool = False
+    proxyrules_simulate_create_on_missing: CliImplicitFlag[bool] = False
 
     # metadata fields to inject into created resources.
     # A few template fields are available. See documentation for more details.
-    created_resource_metadata: dict[str, Any] = {
+    created_resource_metadata: CliSuppress[dict[str, Any]] = {
         "id": "{{ uuid4() }}",
         "createdAt": "{{ utcnow().isoformat() }}",
         "updatedAt": "{{ utcnow().isoformat() }}",
@@ -65,7 +84,7 @@ class Settings(BaseSettings):
 
     # fields to inject into missing resources response json.
     # some services may require such additional fields to be present in the response.
-    missing_resource_fields: dict[str, Any] = dict(
+    missing_resource_fields: CliSuppress[dict[str, Any]] = dict(
         code=404,
         message="mockstack: resource not found",
         retryable=False,
@@ -73,7 +92,7 @@ class Settings(BaseSettings):
 
     # logging configuration. schema is based on the logging configuration schema:
     # https://docs.python.org/3/library/logging.config.html#logging-config-dictschema
-    logging: dict[str, Any] = {
+    logging: CliSuppress[dict[str, Any]] = {
         "version": 1,
         "disable_existing_loggers": False,
         "formatters": {
@@ -84,32 +103,30 @@ class Settings(BaseSettings):
         },
         "handlers": {
             "console": {
-                "class": "logging.StreamHandler",
-                "level": "DEBUG",
-                "formatter": "standard",
-                "stream": "ext://sys.stdout",
+                "class": "rich.logging.RichHandler",
+                "level": "INFO",
             },
         },
         "loggers": {
             "uvicorn": {
                 "handlers": ["console"],
-                "level": "INFO",
+                "level": "DEBUG",
                 "propagate": False,
             },
             "FileFixturesStrategy": {
                 "handlers": ["console"],
-                "level": "INFO",
+                "level": "DEBUG",
                 "propagate": False,
             },
             "ProxyRulesStrategy": {
                 "handlers": ["console"],
-                "level": "INFO",
+                "level": "DEBUG",
                 "propagate": False,
             },
         },
         "root": {
             "handlers": ["console"],
-            "level": "INFO",
+            "level": "NOTSET",
             "propagate": False,
         },
     }
@@ -135,6 +152,24 @@ class Settings(BaseSettings):
         return self
 
 
+# Nb. We separate the Cli-specific parameters since currently breaks pytest
+# when running via pre-commit hooks. Can remove once fixed by pytest / pre-commit.
+
+
+class CliSettings(Settings):
+    """Settings for mockstack CLI."""
+
+    model_config = SettingsConfigDict(
+        env_prefix=ENV_PREFIX,
+        env_file=ENV_FILE,
+        env_nested_delimiter=ENV_NESTED_DELIMITER,
+        cli_parse_args=True,
+        cli_kebab_case=True,
+        cli_hide_none_type=True,
+        cli_avoid_json=True,
+    )
+
+
 @lru_cache
 def settings_provider() -> Settings:
     """Provide the settings for the application."""

{mockstack-0.3.0 → mockstack-0.4.1}/mockstack/constants.py

@@ -2,7 +2,10 @@
 
 from enum import StrEnum
 
-# proxyrules strategy constants
+
+ENV_PREFIX = "mockstack__"
+ENV_FILE = ".env"
+ENV_NESTED_DELIMITER = "__"
 
 
 class ProxyRulesRedirectVia(StrEnum):

mockstack-0.4.1/mockstack/display.py

@@ -0,0 +1,27 @@
+"""Display and logging functionality."""
+
+import logging
+
+from fastapi import FastAPI
+
+from mockstack.config import Settings
+
+
+def announce(app: FastAPI, settings: Settings):
+    """Log the startup message with the active settings."""
+    logger = logging.getLogger("uvicorn")
+    extra = {"markup": True}
+
+    logger.info(
+        f"[bold medium_purple]mockstack[/bold medium_purple] ready to roll. "
+        f"debug: [medium_purple]{settings.debug}[/medium_purple]. "
+        f"strategy: [medium_purple]{settings.strategy}[/medium_purple]. ",
+        extra=extra,
+    )
+    logger.info(str(app.state.strategy), extra=extra)
+    logger.info(
+        f"OpenTelemetry enabled: [medium_purple]{settings.opentelemetry.enabled}[/medium_purple], "
+        f"endpoint: [medium_purple]{settings.opentelemetry.endpoint}[/medium_purple], "
+        f"capture_response_body: [medium_purple]{settings.opentelemetry.capture_response_body}[/medium_purple]",
+        extra=extra,
+    )

{mockstack-0.3.0 → mockstack-0.4.1}/mockstack/intent.py

@@ -51,3 +51,18 @@ def looks_like_a_command(request: Request) -> bool:
             request.url.path.endswith("/execute"),
         )
     )
+
+
+def looks_like_a_create(request: Request) -> bool:
+    """Check if the request looks like a create.
+
+    This is a heuristic to try and identify cases where a POST
+    request is used for creating a new resource.
+
+    """
+    return any(
+        (
+            request.method == "POST",
+            request.url.path.endswith("/create"),
+        ),
+    )

{mockstack-0.3.0 → mockstack-0.4.1}/mockstack/lifespan.py

@@ -1,7 +1,7 @@
 """FastAPI application lifecycle management."""
 
 from contextlib import asynccontextmanager
-from logging import config
+from logging import DEBUG, config
 from typing import Callable
 
 from fastapi import FastAPI
@@ -21,7 +21,12 @@ def lifespan_provider(
 
         This is the context manager that FastAPI will use to manage the lifecycle of the application.
         """
+        if settings.debug:
+            # Enable verbose debug logging if debug mode is set.
+            settings.logging["handlers"]["console"]["level"] = DEBUG
+
         config.dictConfig(settings.logging)
+
         announce(app, settings)
 
         yield

{mockstack-0.3.0 → mockstack-0.4.1}/mockstack/main.py

@@ -1,9 +1,9 @@
 """Application entrypoints."""
 
 from fastapi import FastAPI
-from typer import Typer
+from pydantic_settings import CliApp, CliSettingsSource
 
-from mockstack.config import settings_provider
+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
@@ -11,12 +11,10 @@ from mockstack.routers.homepage import homepage_router_provider
 from mockstack.strategies.factory import strategy_provider
 from mockstack.telemetry import opentelemetry_provider
 
-cli = Typer()
 
-
-def create_app() -> FastAPI:
-    """Create the FastAPI app."""
-    settings = settings_provider()
+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))
 
@@ -30,23 +28,23 @@ def create_app() -> FastAPI:
     return app
 
 
-@cli.command()
-def run(host: str = "0.0.0.0", port: int = 8000):
-    """mockstack run CLI entrypoint."""
+def run():
+    """run the mockstack server."""
+    import argparse
     import uvicorn
 
-    app = create_app()
-    uvicorn.run(app, host=host, port=port)
+    parser = argparse.ArgumentParser()
+    cli_settings = CliSettingsSource(CliSettings, root_parser=parser)
+    settings = CliApp.run(CliSettings, cli_settings_source=cli_settings)
+
+    app = create_app(settings=settings)
+
+    uvicorn.run(app, host=settings.host, port=settings.port)
 
 
-@cli.command()
 def version():
-    """mockstack version CLI entrypoint."""
+    """display mockstack version."""
     from importlib.metadata import version
 
     pkg_version = version("mockstack")
     print(f"mockstack {pkg_version}")
-
-
-if __name__ == "__main__":
-    cli()

{mockstack-0.3.0 → mockstack-0.4.1}/mockstack/strategies/filefixtures.py

@@ -8,7 +8,6 @@ from fastapi import HTTPException, Request, Response, status
 from jinja2 import Environment, FileSystemLoader
 
 from mockstack.config import Settings
-from mockstack.display import ANSIColors
 from mockstack.intent import (
     looks_like_a_command,
     looks_like_a_search,
@@ -39,12 +38,9 @@ class FileFixturesStrategy(BaseStrategy, CreateMixin):
         self.env = Environment(loader=FileSystemLoader(self.templates_dir))
 
     def __str__(self) -> str:
-        HIGHLIGHT = ANSIColors.HEADER
-        ENDC = ANSIColors.ENDC
-
         return (
-            f"{HIGHLIGHT}[filefixtures]{ENDC} "
-            f"templates_dir: {HIGHLIGHT}{self.templates_dir}{ENDC}. "
+            f"[medium_purple]filefixtures[/medium_purple] "
+            f"templates_dir: [medium_purple]{self.templates_dir}[/medium_purple]. "
         )
 
     async def apply(self, request: Request) -> Response:
@@ -85,6 +81,7 @@ class FileFixturesStrategy(BaseStrategy, CreateMixin):
                 request, status_code=status.HTTP_201_CREATED
             )
         else:
+            # simulate resource creation:
             return await self._create(
                 request,
                 env=self.env,

{mockstack-0.3.0 → mockstack-0.4.1}/mockstack/strategies/proxyrules.py

@@ -15,7 +15,7 @@ from starlette.datastructures import Headers
 
 from mockstack.config import Settings
 from mockstack.constants import ProxyRulesRedirectVia
-from mockstack.display import ANSIColors
+from mockstack.intent import looks_like_a_create
 from mockstack.strategies.base import BaseStrategy
 from mockstack.strategies.create_mixin import CreateMixin
 
@@ -69,14 +69,11 @@ class ProxyRulesStrategy(BaseStrategy, CreateMixin):
         self.env = Environment()
 
     def __str__(self) -> str:
-        HIGHLIGHT = ANSIColors.HEADER
-        ENDC = ANSIColors.ENDC
-
         return (
-            f"{HIGHLIGHT}[proxyrules]{ENDC} "
-            f"rules_filename: {HIGHLIGHT}{self.rules_filename}{ENDC}. "
-            f"redirect_via: {HIGHLIGHT}{self.proxyrules_redirect_via}{ENDC}. "
-            f"simulate_create_on_missing: {HIGHLIGHT}{self.proxyrules_simulate_create_on_missing}{ENDC}"
+            f"[medium_purple]proxyrules[/medium_purple] "
+            f"rules_filename: [medium_purple]{self.rules_filename}[/medium_purple]. "
+            f"redirect_via: [medium_purple]{self.proxyrules_redirect_via}[/medium_purple]. "
+            f"simulate_create_on_missing: [medium_purple]{self.proxyrules_simulate_create_on_missing}[/medium_purple]"
         )
 
     @cached_property
@@ -103,9 +100,12 @@ class ProxyRulesStrategy(BaseStrategy, CreateMixin):
             self.logger.warning(
                 f"No rule found for request: {request.method} {request.url.path}"
             )
-            if self.proxyrules_simulate_create_on_missing:
+
+            if self.proxyrules_simulate_create_on_missing and looks_like_a_create(
+                request
+            ):
                 self.logger.info(
-                    "Simulating resource creation for missing rule for {request.method} {request.url.path}"
+                    f"Simulating resource creation for missing rule for {request.method} {request.url.path}"
                 )
                 return await self._create(
                     request,
@@ -113,6 +113,7 @@ class ProxyRulesStrategy(BaseStrategy, CreateMixin):
                     created_resource_metadata=self.created_resource_metadata,
                 )
             else:
+                # no rule found and we are not simulating resource creation
                 return Response(status_code=status.HTTP_404_NOT_FOUND)
 
         url = rule.apply(request)
@@ -141,13 +142,13 @@ class ProxyRulesStrategy(BaseStrategy, CreateMixin):
     async def reverse_proxy(self, request: Request, url: str) -> Response:
         """Reverse proxy the request to the target URL."""
         async with httpx.AsyncClient() as client:
-            method = request.method
             request_content = await request.body()
+            request_headers = self.reverse_proxy_headers(request.headers, url=url)
             req = client.build_request(
-                method,
+                request.method,
                 url,
                 content=request_content,
-                headers=self.reverse_proxy_headers(request.headers, url=url),
+                headers=request_headers,
                 params=request.url.query,
             )
 

{mockstack-0.3.0 → mockstack-0.4.1}/mockstack/tests/test_display.py

@@ -2,20 +2,7 @@
 
 from unittest.mock import patch
 
-from mockstack.display import ANSIColors, announce
-
-
-def test_ansicolors_constants():
-    """Test that ANSIColors constants are defined correctly."""
-    assert ANSIColors.HEADER == "\033[95m"
-    assert ANSIColors.OKBLUE == "\033[94m"
-    assert ANSIColors.OKCYAN == "\033[96m"
-    assert ANSIColors.OKGREEN == "\033[92m"
-    assert ANSIColors.WARNING == "\033[93m"
-    assert ANSIColors.FAIL == "\033[91m"
-    assert ANSIColors.ENDC == "\033[0m"
-    assert ANSIColors.BOLD == "\033[1m"
-    assert ANSIColors.UNDERLINE == "\033[4m"
+from mockstack.display import announce
 
 
 def test_announce(app, settings):

{mockstack-0.3.0 → mockstack-0.4.1/mockstack.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mockstack
-Version: 0.3.0
+Version: 0.4.1
 Summary: An API mocking workhorse
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/adamhadani/mockstack
@@ -18,6 +18,7 @@ Requires-Dist: opentelemetry-instrumentation-fastapi>=0.53b1
 Requires-Dist: pydantic>=2.11.3
 Requires-Dist: pydantic-settings>=2.9.1
 Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: rich>=14.0.0
 Requires-Dist: typer>=0.15.2
 Requires-Dist: uvicorn>=0.34.2
 Dynamic: license-file
@@ -47,7 +48,7 @@ Highlights include:
 
 Install using [uv](https://docs.astral.sh/uv/). This package conforms the concept of a [tool](https://docs.astral.sh/uv/concepts/tools/) and hence can simply install / run with `uvx`:
 
-    uvx mockstack
+    uvx mockstack --help
 
 or install into a persistent environment and add it to the PATH with:
 
@@ -56,15 +57,20 @@ or install into a persistent environment and add it to the PATH with:
 
 ## Usage
 
-Available configuration options are [here](https://github.com/adamhadani/mockstack/blob/main/mockstack/config.py). Setting individual options can be done with env. variables as in the following example:
+Available configuration options are [here](https://github.com/adamhadani/mockstack/blob/main/mockstack/config.py).
+
+Setting individual options can be done either through an `.env` file, individual environment variables, or command-line arguments. For example:
 
 ```shell
+    export MOCKSTACK__STRATEGY=filefixtures
     export MOCKSTACK__TEMPLATES_DIR=~/mockstack-templates/
     export MOCKSTACK__OPENTELEMETRY__ENABLED=true
     export MOCKSTACK__OPENTELEMETRY__CAPTURE_RESPONSE_BODY=true
-    uv run
+    uvx mockstack
 ```
 
+See also the included [.env.example](https://github.com/adamhadani/mockstack/blob/main/.env.example) for more examples. You can copy that file to `.env` and fill in configuration as needed based on the given examples.
+
 Out of the box, you get the following behavior when using the default `filefixtures` strategy:
 
 - The HTTP request `GET /someservice/api/v1/user/c27f5b2b-6e81-420d-a4e4-6426e1c32db8` will try to find `<templates_dir>/someservice-api-v1-user.c27f5b2b-6e81-420d-a4e4-6426e1c32db8.j2`,
@@ -97,8 +103,8 @@ If you are contributing to development, you will want to clone this project, and
     uv sync
     uv pip install -e .
 
-Copy the included [.env.example](https://github.com/adamhadani/mockstack/blob/main/.env.example) file to `.env` and fill in configuration as needed based on the given examples.
-
 Run in development mode (for live-reload of changes when developing):
 
     uv run uvicorn --factory mockstack.main:create_app --reload
+
+Note that when you run using the uvicorn CLI, you will need to set any configuration via `.env` file or environment variables.

mockstack-0.4.1/mockstack.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mockstack = mockstack.main:run

{mockstack-0.3.0 → mockstack-0.4.1}/mockstack.egg-info/requires.txt

@@ -7,5 +7,6 @@ opentelemetry-instrumentation-fastapi>=0.53b1
 pydantic>=2.11.3
 pydantic-settings>=2.9.1
 pyyaml>=6.0.2
+rich>=14.0.0
 typer>=0.15.2
 uvicorn>=0.34.2

{mockstack-0.3.0 → mockstack-0.4.1}/pyproject.toml

@@ -20,6 +20,7 @@ dependencies = [
     "pydantic>=2.11.3",
     "pydantic-settings>=2.9.1",
     "pyyaml>=6.0.2",
+    "rich>=14.0.0",
     "typer>=0.15.2",
     "uvicorn>=0.34.2",
 ]
@@ -30,7 +31,7 @@ Homepage = "https://github.com/adamhadani/mockstack"
 Issues = "https://github.com/adamhadani/mockstack/issues"
 
 [project.scripts]
-mockstack = "mockstack.main:cli"
+mockstack = "mockstack.main:run"
 
 [dependency-groups]
 dev = [