mockstack 0.0.5__tar.gz → 0.1.0__tar.gz

{mockstack-0.0.5 → mockstack-0.1.0}/.github/workflows/ci.yml

@@ -31,7 +31,7 @@ jobs:
         version: "latest"
     - name: Install ruff
       uses: astral-sh/ruff-action@v3
-      with: 
+      with:
         version: "latest"
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v3
@@ -43,5 +43,7 @@ jobs:
       run: |
         ruff check
         ruff format
+    - name: Run mypy
+      run: uv run mypy mockstack
     - name: Run tests
       run: uv run pytest

{mockstack-0.0.5 → mockstack-0.1.0}/.github/workflows/publish-to-pypi.yml

@@ -1,4 +1,4 @@
-name: Publish Python distribution to TestPyPI
+name: Publish to PyPI
 
 permissions:
   contents: read

{mockstack-0.0.5 → mockstack-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mockstack
-Version: 0.0.5
+Version: 0.1.0
 Summary: An API mocking workhorse
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/adamhadani/mockstack
@@ -16,12 +16,15 @@ Requires-Dist: opentelemetry-distro[otlp]>=0.53b1
 Requires-Dist: opentelemetry-instrumentation-fastapi>=0.53b1
 Requires-Dist: pydantic>=2.11.3
 Requires-Dist: pydantic-settings>=2.9.1
+Requires-Dist: typer>=0.15.2
+Requires-Dist: uvicorn>=0.34.2
 Dynamic: license-file
 
 # mockstack
 
 [![CI](https://github.com/adamhadani/mockstack/actions/workflows/ci.yml/badge.svg)](https://github.com/adamhadani/mockstack/actions/workflows/ci.yml)
 ![GitHub License](https://img.shields.io/github/license/adamhadani/mockstack)
+![PyPI - Version](https://img.shields.io/pypi/v/mockstack)
 
 An API mocking workhorse :racehorse:
 
@@ -37,27 +40,20 @@ Highlights include:
 
 ## Installation
 
-Install using [uv](https://docs.astral.sh/uv/). This will create a virtualenv for you and install all dependencies:
+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`:
 
-    uv sync
-    uv pip install -e .
-
-
-## Usage
-
-Copy the included [.env.example](.env.example) file to `.env` and fill in configuration as needed based on the given examples.
+    uvx mockstack
 
-Run in development mode (for live-reload of changes when developing):
+or install into a persistent environment and add it to the PATH with:
 
-    uv run fastapi dev mockstack/main.py
+    uv tool install mockstack
 
-Or, run in production mode:
 
-    uv run fastapi run mockstack/main.py
+## Usage
 
 Available configuration options are [here](./mockstack/config.py). Setting individual options can be done with env. variables as in the following example:
 
-    MOCKSTACK__OPENTELEMETRY__ENABLED=true MOCKSTACK__OPENTELEMETRY__CAPTURE_RESPONSE_BODY=true uv run fastapi run mockstack/main.py
+    MOCKSTACK__OPENTELEMETRY__ENABLED=true MOCKSTACK__OPENTELEMETRY__CAPTURE_RESPONSE_BODY=true uv run
 
 Out of the box, you get the following behavior when using the default `filefixtures` strategy:
 
@@ -80,3 +76,23 @@ Invoke unit-tests with:
 Linting, formatting, static type checks etc. are all managed via [pre-commit](https://pre-commit.com/) hooks. These will run automatically on every commit. You can invoke these manually on all files with:
 
     pre-commit run --all-files
+
+
+## Contributing
+
+If you are contributing to development, you will want to clone this project, and can then install it locally with:
+
+    gh repo clone adamhadani/mockstack
+    cd mockstack/
+    uv sync
+    uv pip install -e .
+
+Copy the included [.env.example](.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 fastapi dev mockstack/main.py
+
+Or, run in production mode:
+
+    uv run fastapi run mockstack/main.py

{mockstack-0.0.5 → mockstack-0.1.0}/README.md

@@ -2,6 +2,7 @@
 
 [![CI](https://github.com/adamhadani/mockstack/actions/workflows/ci.yml/badge.svg)](https://github.com/adamhadani/mockstack/actions/workflows/ci.yml)
 ![GitHub License](https://img.shields.io/github/license/adamhadani/mockstack)
+![PyPI - Version](https://img.shields.io/pypi/v/mockstack)
 
 An API mocking workhorse :racehorse:
 
@@ -17,27 +18,20 @@ Highlights include:
 
 ## Installation
 
-Install using [uv](https://docs.astral.sh/uv/). This will create a virtualenv for you and install all dependencies:
+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`:
 
-    uv sync
-    uv pip install -e .
-
-
-## Usage
-
-Copy the included [.env.example](.env.example) file to `.env` and fill in configuration as needed based on the given examples.
+    uvx mockstack
 
-Run in development mode (for live-reload of changes when developing):
+or install into a persistent environment and add it to the PATH with:
 
-    uv run fastapi dev mockstack/main.py
+    uv tool install mockstack
 
-Or, run in production mode:
 
-    uv run fastapi run mockstack/main.py
+## Usage
 
 Available configuration options are [here](./mockstack/config.py). Setting individual options can be done with env. variables as in the following example:
 
-    MOCKSTACK__OPENTELEMETRY__ENABLED=true MOCKSTACK__OPENTELEMETRY__CAPTURE_RESPONSE_BODY=true uv run fastapi run mockstack/main.py
+    MOCKSTACK__OPENTELEMETRY__ENABLED=true MOCKSTACK__OPENTELEMETRY__CAPTURE_RESPONSE_BODY=true uv run
 
 Out of the box, you get the following behavior when using the default `filefixtures` strategy:
 
@@ -60,3 +54,23 @@ Invoke unit-tests with:
 Linting, formatting, static type checks etc. are all managed via [pre-commit](https://pre-commit.com/) hooks. These will run automatically on every commit. You can invoke these manually on all files with:
 
     pre-commit run --all-files
+
+
+## Contributing
+
+If you are contributing to development, you will want to clone this project, and can then install it locally with:
+
+    gh repo clone adamhadani/mockstack
+    cd mockstack/
+    uv sync
+    uv pip install -e .
+
+Copy the included [.env.example](.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 fastapi dev mockstack/main.py
+
+Or, run in production mode:
+
+    uv run fastapi run mockstack/main.py

{mockstack-0.0.5 → mockstack-0.1.0}/mockstack/main.py

@@ -1,14 +1,17 @@
 """Application entrypoints."""
 
 from fastapi import FastAPI
+from typer import Typer
 
 from mockstack.config import settings_provider
 from mockstack.lifespan import lifespan_provider
 from mockstack.middleware import middleware_provider
-from mockstack.opentelemetry import opentelemetry_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
+
+cli = Typer()
 
 
 def create_app() -> FastAPI:
@@ -27,5 +30,23 @@ def create_app() -> FastAPI:
     return app
 
 
-# expose top-level app object for fastapi cli
-app = create_app()
+@cli.command()
+def run(host: str = "0.0.0.0", port: int = 8000):
+    """mockstack run CLI entrypoint."""
+    import uvicorn
+
+    app = create_app()
+    uvicorn.run(app, host=host, port=port)
+
+
+@cli.command()
+def version():
+    """mockstack version CLI entrypoint."""
+    from importlib.metadata import version
+
+    pkg_version = version("mockstack")
+    print(f"mockstack {pkg_version}")
+
+
+if __name__ == "__main__":
+    cli()

{mockstack-0.0.5 → mockstack-0.1.0}/mockstack/routers/catchall.py

@@ -5,7 +5,7 @@ from opentelemetry import trace
 from opentelemetry.propagate import extract
 
 from mockstack.config import Settings
-from mockstack.opentelemetry import span_name_for
+from mockstack.telemetry import span_name_for
 
 
 def catchall_router_provider(app: FastAPI, settings: Settings) -> None:

{mockstack-0.0.5 → mockstack-0.1.0}/mockstack.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mockstack
-Version: 0.0.5
+Version: 0.1.0
 Summary: An API mocking workhorse
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/adamhadani/mockstack
@@ -16,12 +16,15 @@ Requires-Dist: opentelemetry-distro[otlp]>=0.53b1
 Requires-Dist: opentelemetry-instrumentation-fastapi>=0.53b1
 Requires-Dist: pydantic>=2.11.3
 Requires-Dist: pydantic-settings>=2.9.1
+Requires-Dist: typer>=0.15.2
+Requires-Dist: uvicorn>=0.34.2
 Dynamic: license-file
 
 # mockstack
 
 [![CI](https://github.com/adamhadani/mockstack/actions/workflows/ci.yml/badge.svg)](https://github.com/adamhadani/mockstack/actions/workflows/ci.yml)
 ![GitHub License](https://img.shields.io/github/license/adamhadani/mockstack)
+![PyPI - Version](https://img.shields.io/pypi/v/mockstack)
 
 An API mocking workhorse :racehorse:
 
@@ -37,27 +40,20 @@ Highlights include:
 
 ## Installation
 
-Install using [uv](https://docs.astral.sh/uv/). This will create a virtualenv for you and install all dependencies:
+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`:
 
-    uv sync
-    uv pip install -e .
-
-
-## Usage
-
-Copy the included [.env.example](.env.example) file to `.env` and fill in configuration as needed based on the given examples.
+    uvx mockstack
 
-Run in development mode (for live-reload of changes when developing):
+or install into a persistent environment and add it to the PATH with:
 
-    uv run fastapi dev mockstack/main.py
+    uv tool install mockstack
 
-Or, run in production mode:
 
-    uv run fastapi run mockstack/main.py
+## Usage
 
 Available configuration options are [here](./mockstack/config.py). Setting individual options can be done with env. variables as in the following example:
 
-    MOCKSTACK__OPENTELEMETRY__ENABLED=true MOCKSTACK__OPENTELEMETRY__CAPTURE_RESPONSE_BODY=true uv run fastapi run mockstack/main.py
+    MOCKSTACK__OPENTELEMETRY__ENABLED=true MOCKSTACK__OPENTELEMETRY__CAPTURE_RESPONSE_BODY=true uv run
 
 Out of the box, you get the following behavior when using the default `filefixtures` strategy:
 
@@ -80,3 +76,23 @@ Invoke unit-tests with:
 Linting, formatting, static type checks etc. are all managed via [pre-commit](https://pre-commit.com/) hooks. These will run automatically on every commit. You can invoke these manually on all files with:
 
     pre-commit run --all-files
+
+
+## Contributing
+
+If you are contributing to development, you will want to clone this project, and can then install it locally with:
+
+    gh repo clone adamhadani/mockstack
+    cd mockstack/
+    uv sync
+    uv pip install -e .
+
+Copy the included [.env.example](.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 fastapi dev mockstack/main.py
+
+Or, run in production mode:
+
+    uv run fastapi run mockstack/main.py

{mockstack-0.0.5 → mockstack-0.1.0}/mockstack.egg-info/SOURCES.txt

@@ -16,11 +16,12 @@ mockstack/identifiers.py
 mockstack/lifespan.py
 mockstack/main.py
 mockstack/middleware.py
-mockstack/opentelemetry.py
+mockstack/telemetry.py
 mockstack/templating.py
 mockstack.egg-info/PKG-INFO
 mockstack.egg-info/SOURCES.txt
 mockstack.egg-info/dependency_links.txt
+mockstack.egg-info/entry_points.txt
 mockstack.egg-info/requires.txt
 mockstack.egg-info/top_level.txt
 mockstack/routers/__init__.py

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

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

{mockstack-0.0.5 → mockstack-0.1.0}/mockstack.egg-info/requires.txt

@@ -5,3 +5,5 @@ opentelemetry-distro[otlp]>=0.53b1
 opentelemetry-instrumentation-fastapi>=0.53b1
 pydantic>=2.11.3
 pydantic-settings>=2.9.1
+typer>=0.15.2
+uvicorn>=0.34.2

{mockstack-0.0.5 → mockstack-0.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mockstack"
-version = "0.0.5"
+version = "0.1.0"
 description = "An API mocking workhorse"
 readme = "README.md"
 license = "MIT"
@@ -19,12 +19,17 @@ dependencies = [
     "opentelemetry-instrumentation-fastapi>=0.53b1",
     "pydantic>=2.11.3",
     "pydantic-settings>=2.9.1",
+    "typer>=0.15.2",
+    "uvicorn>=0.34.2",
 ]
 
 [project.urls]
 Homepage = "https://github.com/adamhadani/mockstack"
 Issues = "https://github.com/adamhadani/mockstack/issues"
 
+[project.scripts]
+mockstack = "mockstack.main:cli"
+
 [dependency-groups]
 dev = [
     "mypy>=1.15.0",

{mockstack-0.0.5 → mockstack-0.1.0}/uv.lock

@@ -477,8 +477,8 @@ wheels = [
 
 [[package]]
 name = "mockstack"
-version = "0.2.0"
-source = { virtual = "." }
+version = "0.0.5"
+source = { editable = "." }
 dependencies = [
     { name = "colorama" },
     { name = "fastapi", extra = ["standard"] },
@@ -487,6 +487,8 @@ dependencies = [
     { name = "opentelemetry-instrumentation-fastapi" },
     { name = "pydantic" },
     { name = "pydantic-settings" },
+    { name = "typer" },
+    { name = "uvicorn" },
 ]
 
 [package.dev-dependencies]
@@ -506,6 +508,8 @@ requires-dist = [
     { name = "opentelemetry-instrumentation-fastapi", specifier = ">=0.53b1" },
     { name = "pydantic", specifier = ">=2.11.3" },
     { name = "pydantic-settings", specifier = ">=2.9.1" },
+    { name = "typer", specifier = ">=0.15.2" },
+    { name = "uvicorn", specifier = ">=0.34.2" },
 ]
 
 [package.metadata.requires-dev]