interposition-http-adapter 0.1.0__tar.gz

interposition_http_adapter-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Osoekawa IT Laboratory
+
+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.

interposition_http_adapter-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: interposition_http_adapter
+Version: 0.1.0
+Summary: HTTP adapter for Interposition.
+Author: osoken
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/osoekawaitlab/interposition-http-adapter
+Project-URL: Repository, https://github.com/osoekawaitlab/interposition-http-adapter
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: interposition>=0.3.0
+Requires-Dist: starlette>=0.52.1
+Requires-Dist: uvicorn>=0.40.0
+Dynamic: license-file
+
+# interposition-http-adapter
+
+HTTP adapter for [Interposition](https://github.com/osoekawaitlab/interposition).
+Serves recorded HTTP interactions from an Interposition `Cassette` as a real HTTP server, allowing you to replay captured API responses for testing and development.
+
+## Installation
+
+```bash
+pip install interposition-http-adapter
+```
+
+## Usage
+
+`InterpositionHttpAdapter` is an ASGI application (based on Starlette) that replays HTTP interactions through an Interposition `Broker`.
+
+```python
+from interposition import (
+    Broker,
+    Cassette,
+    Interaction,
+    InteractionRequest,
+    ResponseChunk,
+)
+import uvicorn
+
+from interposition_http_adapter import InterpositionHttpAdapter
+
+# 1. Build an InteractionRequest describing the HTTP request to match
+request = InteractionRequest(
+    protocol="http",
+    action="GET",
+    target="/api/data",
+    headers=(),
+    body=b"",
+)
+
+# 2. Build ResponseChunks with status_code in the first chunk's metadata
+response_chunks = (
+    ResponseChunk(
+        data=b'{"message": "hello"}',
+        sequence=0,
+        metadata=(("status_code", "200"),),
+    ),
+)
+
+# 3. Create a Cassette containing the interaction
+interaction = Interaction(
+    request=request,
+    fingerprint=request.fingerprint(),
+    response_chunks=response_chunks,
+)
+cassette = Cassette(interactions=(interaction,))
+
+# 4. Create a Broker in replay mode
+broker = Broker(cassette=cassette, mode="replay")
+
+# 5. Create the adapter and serve it
+app = InterpositionHttpAdapter(broker=broker)
+uvicorn.run(app, host="127.0.0.1", port=8000)
+```
+
+Once the server is running, a `GET` request to `http://127.0.0.1:8000/api/data` returns the recorded response with status code 200 and body `{"message": "hello"}`.
+Requests that do not match any recorded interaction return a `500 Internal Server Error` response.
+
+## API Reference
+
+Detailed documentation is available in MkDocs: <https://osoekawaitlab.github.io/interposition-http-adapter/>.
+
+## CLI
+
+The package provides a command-line interface:
+
+```bash
+interposition_http_adapter --version
+```
+
+## License
+
+MIT

interposition_http_adapter-0.1.0/README.md

@@ -0,0 +1,79 @@
+# interposition-http-adapter
+
+HTTP adapter for [Interposition](https://github.com/osoekawaitlab/interposition).
+Serves recorded HTTP interactions from an Interposition `Cassette` as a real HTTP server, allowing you to replay captured API responses for testing and development.
+
+## Installation
+
+```bash
+pip install interposition-http-adapter
+```
+
+## Usage
+
+`InterpositionHttpAdapter` is an ASGI application (based on Starlette) that replays HTTP interactions through an Interposition `Broker`.
+
+```python
+from interposition import (
+    Broker,
+    Cassette,
+    Interaction,
+    InteractionRequest,
+    ResponseChunk,
+)
+import uvicorn
+
+from interposition_http_adapter import InterpositionHttpAdapter
+
+# 1. Build an InteractionRequest describing the HTTP request to match
+request = InteractionRequest(
+    protocol="http",
+    action="GET",
+    target="/api/data",
+    headers=(),
+    body=b"",
+)
+
+# 2. Build ResponseChunks with status_code in the first chunk's metadata
+response_chunks = (
+    ResponseChunk(
+        data=b'{"message": "hello"}',
+        sequence=0,
+        metadata=(("status_code", "200"),),
+    ),
+)
+
+# 3. Create a Cassette containing the interaction
+interaction = Interaction(
+    request=request,
+    fingerprint=request.fingerprint(),
+    response_chunks=response_chunks,
+)
+cassette = Cassette(interactions=(interaction,))
+
+# 4. Create a Broker in replay mode
+broker = Broker(cassette=cassette, mode="replay")
+
+# 5. Create the adapter and serve it
+app = InterpositionHttpAdapter(broker=broker)
+uvicorn.run(app, host="127.0.0.1", port=8000)
+```
+
+Once the server is running, a `GET` request to `http://127.0.0.1:8000/api/data` returns the recorded response with status code 200 and body `{"message": "hello"}`.
+Requests that do not match any recorded interaction return a `500 Internal Server Error` response.
+
+## API Reference
+
+Detailed documentation is available in MkDocs: <https://osoekawaitlab.github.io/interposition-http-adapter/>.
+
+## CLI
+
+The package provides a command-line interface:
+
+```bash
+interposition_http_adapter --version
+```
+
+## License
+
+MIT

interposition_http_adapter-0.1.0/pyproject.toml

@@ -0,0 +1,124 @@
+[project]
+name = "interposition_http_adapter"
+dynamic = ["version"]
+description = "HTTP adapter for Interposition."
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "osoken" }
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "interposition>=0.3.0",
+    "starlette>=0.52.1",
+    "uvicorn>=0.40.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/osoekawaitlab/interposition-http-adapter"
+Repository = "https://github.com/osoekawaitlab/interposition-http-adapter"
+
+[build-system]
+requires = ["setuptools>=70.1"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.dynamic]
+version = {attr = "interposition_http_adapter._version.__version__"}
+
+
+[project.scripts]
+interposition_http_adapter = "interposition_http_adapter.cli:main"
+
+[dependency-groups]
+dev = [
+    "getgauge>=0.5.0",
+    "httpx>=0.28.1",
+    "mypy>=1.18.2",
+    "nox>=2025.11.12",
+    "pytest>=9.0.1",
+    "pytest-cov>=7.0.0",
+    "pytest-mock>=3.15.1",
+    "pytest-randomly>=4.0.1",
+    "ruff>=0.14.5",
+]
+docs = [
+    "mkdocs>=1.6.1",
+    "mkdocs-awesome-nav>=3.2.0",
+    "mkdocs-material>=9.7.0",
+    "mkdocstrings>=0.30.1",
+    "mkdocstrings-python>=1.19.0",
+]
+
+[tool.ruff]
+indent-width = 4
+target-version = "py312"
+line-length = 88
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "COM812",  # trailing-comma-missing (conflicts with formatter)
+    "ISC001",  # single-line-implicit-string-concatenation (conflicts with formatter)
+    "D203",    # one-blank-line-before-class (conflicts with D211)
+    "D213",    # multi-line-summary-second-line (conflicts with D212)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    "S101",    # assert-used (pytest uses asserts)
+]
+"e2e/**/*.py" = [
+    "S101",    # assert-used (test uses asserts)
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+check_untyped_defs = true
+disallow_any_explicit = true
+disallow_any_generics = true
+disallow_incomplete_defs = true
+disallow_untyped_decorators = true
+disallow_untyped_defs = true
+no_implicit_optional = true
+show_error_codes = true
+strict_equality = true
+warn_no_return = true
+warn_redundant_casts = true
+warn_return_any = true
+warn_unreachable = true
+warn_unused_configs = true
+warn_unused_ignores = true
+mypy_path = ["stubs"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests", "src"]
+python_files = ["test_*.py", "*_test.py"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "--doctest-modules",
+]
+markers = [
+]

interposition_http_adapter-0.1.0/setup.cfg

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

interposition_http_adapter-0.1.0/src/interposition_http_adapter/__init__.py

@@ -0,0 +1,6 @@
+"""HTTP adapter for Interposition."""
+
+from interposition_http_adapter._version import __version__
+from interposition_http_adapter.app import InterpositionHttpAdapter
+
+__all__ = ["InterpositionHttpAdapter", "__version__"]

interposition_http_adapter-0.1.0/src/interposition_http_adapter/_version.py

@@ -0,0 +1,3 @@
+"""Version information for interposition_http_adapter."""
+
+__version__ = "0.1.0"

interposition_http_adapter-0.1.0/src/interposition_http_adapter/app.py

@@ -0,0 +1,143 @@
+"""HTTP adapter application for Interposition."""
+
+from collections.abc import Awaitable, Callable
+
+from interposition import (
+    Broker,
+    Interaction,
+    InteractionNotFoundError,
+    InteractionRequest,
+    ResponseChunk,
+)
+from starlette.applications import Starlette
+from starlette.datastructures import Headers
+from starlette.requests import Request
+from starlette.responses import Response
+from starlette.routing import Route
+
+
+def _create_get_handler(
+    broker: Broker,
+) -> Callable[[Request], Awaitable[Response]]:
+    """Create a GET request handler bound to the given broker."""
+
+    async def handle_get(request: Request) -> Response:
+        target = request.url.path
+        if request.url.query:
+            target = f"{target}?{request.url.query}"
+
+        body = await request.body()
+        chunks = _replay_matching_get(
+            broker=broker,
+            request_headers=request.headers,
+            target=target,
+            body=body,
+        )
+        if chunks is None:
+            return Response(status_code=500, content=b"Interaction Not Found")
+
+        status_code = 200
+        if chunks:
+            for key, value in chunks[0].metadata:
+                if key == "status_code":
+                    status_code = int(value)
+
+        response_body = b"".join(chunk.data for chunk in chunks)
+        return Response(status_code=status_code, content=response_body)
+
+    return handle_get
+
+
+def _replay_matching_get(
+    broker: Broker,
+    request_headers: Headers,
+    target: str,
+    body: bytes,
+) -> tuple[ResponseChunk, ...] | None:
+    """Try replay candidates built from stored interaction header schemas."""
+    candidates = _build_get_replay_candidates(
+        interactions=broker.cassette.interactions,
+        request_headers=request_headers,
+        target=target,
+        body=body,
+    )
+    for candidate in candidates:
+        try:
+            return tuple(broker.replay(candidate))
+        except InteractionNotFoundError:
+            continue
+    return None
+
+
+def _build_get_replay_candidates(
+    interactions: tuple[Interaction, ...],
+    request_headers: Headers,
+    target: str,
+    body: bytes,
+) -> tuple[InteractionRequest, ...]:
+    """Create candidate requests using the stored header fields per interaction."""
+    candidates: list[InteractionRequest] = []
+    seen_fingerprints: set[str] = set()
+
+    for interaction in interactions:
+        recorded_request = interaction.request
+        if recorded_request.protocol != "http":
+            continue
+        if recorded_request.action != "GET":
+            continue
+        if recorded_request.target != target:
+            continue
+
+        candidate_headers: list[tuple[str, str]] = []
+        missing_header = False
+        for key, _ in recorded_request.headers:
+            value = request_headers.get(key)
+            if value is None:
+                missing_header = True
+                break
+            candidate_headers.append((key, value))
+
+        if missing_header:
+            continue
+
+        candidate = InteractionRequest(
+            protocol="http",
+            action="GET",
+            target=target,
+            headers=tuple(candidate_headers),
+            body=body,
+        )
+        candidate_fingerprint = candidate.fingerprint().value
+        if candidate_fingerprint in seen_fingerprints:
+            continue
+        seen_fingerprints.add(candidate_fingerprint)
+        candidates.append(candidate)
+
+    if not candidates:
+        candidates.append(
+            InteractionRequest(
+                protocol="http",
+                action="GET",
+                target=target,
+                headers=(),
+                body=body,
+            )
+        )
+
+    return tuple(candidates)
+
+
+class InterpositionHttpAdapter(Starlette):
+    """ASGI application that replays HTTP interactions via an Interposition Broker."""
+
+    def __init__(self, broker: Broker) -> None:
+        """Initialize the adapter with a Broker.
+
+        Args:
+            broker: The Interposition Broker to use for replaying interactions.
+        """
+        self._broker = broker
+        routes = [
+            Route("/{path:path}", _create_get_handler(broker), methods=["GET"]),
+        ]
+        super().__init__(routes=routes)

interposition_http_adapter-0.1.0/src/interposition_http_adapter/cli.py

@@ -0,0 +1,18 @@
+"""CLI module for interposition_http_adapter."""
+
+from argparse import ArgumentParser
+
+from interposition_http_adapter._version import __version__
+
+
+def generate_cli_parser() -> ArgumentParser:
+    """Generate the argument parser for the interposition_http_adapter CLI."""
+    parser = ArgumentParser(description="HTTP adapter for Interposition.")
+    parser.add_argument("--version", action="version", version=__version__)
+    return parser
+
+
+def main() -> None:
+    """Entry point for the interposition_http_adapter command-line interface."""
+    parser = generate_cli_parser()
+    _ = parser.parse_args()

interposition_http_adapter-0.1.0/src/interposition_http_adapter.egg-info/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: interposition_http_adapter
+Version: 0.1.0
+Summary: HTTP adapter for Interposition.
+Author: osoken
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/osoekawaitlab/interposition-http-adapter
+Project-URL: Repository, https://github.com/osoekawaitlab/interposition-http-adapter
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: interposition>=0.3.0
+Requires-Dist: starlette>=0.52.1
+Requires-Dist: uvicorn>=0.40.0
+Dynamic: license-file
+
+# interposition-http-adapter
+
+HTTP adapter for [Interposition](https://github.com/osoekawaitlab/interposition).
+Serves recorded HTTP interactions from an Interposition `Cassette` as a real HTTP server, allowing you to replay captured API responses for testing and development.
+
+## Installation
+
+```bash
+pip install interposition-http-adapter
+```
+
+## Usage
+
+`InterpositionHttpAdapter` is an ASGI application (based on Starlette) that replays HTTP interactions through an Interposition `Broker`.
+
+```python
+from interposition import (
+    Broker,
+    Cassette,
+    Interaction,
+    InteractionRequest,
+    ResponseChunk,
+)
+import uvicorn
+
+from interposition_http_adapter import InterpositionHttpAdapter
+
+# 1. Build an InteractionRequest describing the HTTP request to match
+request = InteractionRequest(
+    protocol="http",
+    action="GET",
+    target="/api/data",
+    headers=(),
+    body=b"",
+)
+
+# 2. Build ResponseChunks with status_code in the first chunk's metadata
+response_chunks = (
+    ResponseChunk(
+        data=b'{"message": "hello"}',
+        sequence=0,
+        metadata=(("status_code", "200"),),
+    ),
+)
+
+# 3. Create a Cassette containing the interaction
+interaction = Interaction(
+    request=request,
+    fingerprint=request.fingerprint(),
+    response_chunks=response_chunks,
+)
+cassette = Cassette(interactions=(interaction,))
+
+# 4. Create a Broker in replay mode
+broker = Broker(cassette=cassette, mode="replay")
+
+# 5. Create the adapter and serve it
+app = InterpositionHttpAdapter(broker=broker)
+uvicorn.run(app, host="127.0.0.1", port=8000)
+```
+
+Once the server is running, a `GET` request to `http://127.0.0.1:8000/api/data` returns the recorded response with status code 200 and body `{"message": "hello"}`.
+Requests that do not match any recorded interaction return a `500 Internal Server Error` response.
+
+## API Reference
+
+Detailed documentation is available in MkDocs: <https://osoekawaitlab.github.io/interposition-http-adapter/>.
+
+## CLI
+
+The package provides a command-line interface:
+
+```bash
+interposition_http_adapter --version
+```
+
+## License
+
+MIT

interposition_http_adapter-0.1.0/src/interposition_http_adapter.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/interposition_http_adapter/__init__.py
+src/interposition_http_adapter/_version.py
+src/interposition_http_adapter/app.py
+src/interposition_http_adapter/cli.py
+src/interposition_http_adapter/py.typed
+src/interposition_http_adapter.egg-info/PKG-INFO
+src/interposition_http_adapter.egg-info/SOURCES.txt
+src/interposition_http_adapter.egg-info/dependency_links.txt
+src/interposition_http_adapter.egg-info/entry_points.txt
+src/interposition_http_adapter.egg-info/requires.txt
+src/interposition_http_adapter.egg-info/top_level.txt

interposition_http_adapter-0.1.0/src/interposition_http_adapter.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

interposition_http_adapter-0.1.0/src/interposition_http_adapter.egg-info/entry_points.txt

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

interposition_http_adapter-0.1.0/src/interposition_http_adapter.egg-info/requires.txt

@@ -0,0 +1,3 @@
+interposition>=0.3.0
+starlette>=0.52.1
+uvicorn>=0.40.0

interposition_http_adapter-0.1.0/src/interposition_http_adapter.egg-info/top_level.txt

@@ -0,0 +1 @@
+interposition_http_adapter