local-web-services-python-sdk 0.1.5__tar.gz → 0.2.0__tar.gz

local_web_services_python_sdk-0.2.0/BUILD

@@ -0,0 +1,17 @@
+load("@pip_python_sdk//:requirements.bzl", "requirement")
+load("@rules_python//python:defs.bzl", "py_library", "py_test")
+
+py_library(
+    name = "lws_testing",
+    srcs = glob(["src/**/*.py"]),
+    imports = ["src"],
+    visibility = ["//visibility:public"],
+    deps = [
+        "//core:lws",
+        requirement("httpx"),
+        requirement("botocore"),
+        requirement("pyyaml"),
+    ],
+)
+
+# Tests live in //lang/python/sdk/tests:tests to avoid output-path prefix conflicts.

{local_web_services_python_sdk-0.1.5 → local_web_services_python_sdk-0.2.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: local-web-services-python-sdk
-Version: 0.1.5
+Version: 0.2.0
 Summary: Python testing SDK for local-web-services — in-process pytest fixtures and boto3 helpers
 Project-URL: Homepage, https://local-web-services.github.io
 Project-URL: Repository, https://github.com/local-web-services/local-web-services-sdk-python
 Project-URL: Issues, https://github.com/local-web-services/local-web-services-sdk-python/issues
 License-Expression: MIT
-Keywords: aws,boto3,dynamodb,local,mocking,pytest,s3,sqs,testing
+Keywords: aws,boto3,dynamodb,faking,local,pytest,s3,sqs,testing
 Classifier: Development Status :: 3 - Alpha
 Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
@@ -19,7 +19,7 @@ Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.11
 Requires-Dist: botocore>=1.34.0
 Requires-Dist: httpx>=0.27.0
-Requires-Dist: local-web-services>=0.17.2
+Requires-Dist: local-web-services>=0.18.0
 Requires-Dist: pyyaml>=6.0
 Provides-Extra: pytest
 Requires-Dist: pytest>=8.0.0; extra == 'pytest'

{local_web_services_python_sdk-0.1.5 → local_web_services_python_sdk-0.2.0}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "local-web-services-python-sdk"
-version = "0.1.5"
+version = "0.2.0"
 description = "Python testing SDK for local-web-services — in-process pytest fixtures and boto3 helpers"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.11"
-keywords = ["aws", "testing", "pytest", "boto3", "local", "dynamodb", "sqs", "s3", "mocking"]
+keywords = ["aws", "testing", "pytest", "boto3", "local", "dynamodb", "sqs", "s3", "faking"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
@@ -21,7 +21,7 @@ dependencies = [
     "httpx>=0.27.0",
     "botocore>=1.34.0",
     "pyyaml>=6.0",
-    "local-web-services>=0.17.2",
+    "local-web-services>=0.18.0",
 ]
 
 [project.optional-dependencies]
@@ -81,3 +81,6 @@ disable = [
     "R0903", "R0902", "R0913", "R0917", "R0904", "R0911", "R0914", "C0103",
     "W0603", "W0621", "C0415", "C0116", "W0212",
 ]
+
+[tool.uv.sources]
+local-web-services = { path = "../../../core", editable = true }

local_web_services_python_sdk-0.2.0/requirements.txt

@@ -0,0 +1,173 @@
+# This file was autogenerated by uv via the following command:
+#    uv export --no-hashes --no-editable --output-file requirements.txt
+aiosqlite==0.22.1
+    # via local-web-services
+annotated-doc==0.0.4
+    # via
+    #   fastapi
+    #   typer
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.12.1
+    # via
+    #   httpx
+    #   starlette
+    #   watchfiles
+black==26.1.0
+boto3==1.42.54
+botocore==1.42.54
+    # via
+    #   boto3
+    #   local-web-services-python-sdk
+    #   s3transfer
+certifi==2026.1.4
+    # via
+    #   httpcore
+    #   httpx
+    #   requests
+cffi==2.0.0 ; platform_python_implementation != 'PyPy'
+    # via cryptography
+charset-normalizer==3.4.4
+    # via requests
+click==8.3.1
+    # via
+    #   black
+    #   typer
+    #   uvicorn
+colorama==0.4.6
+    # via
+    #   click
+    #   pytest
+    #   radon
+    #   uvicorn
+croniter==6.0.0
+    # via local-web-services
+cryptography==46.0.5
+    # via pyjwt
+docker==7.1.0
+    # via local-web-services
+fastapi==0.129.0
+    # via local-web-services
+h11==0.16.0
+    # via
+    #   httpcore
+    #   uvicorn
+httpcore==1.0.9
+    # via httpx
+httptools==0.7.1
+    # via uvicorn
+httpx==0.28.1
+    # via
+    #   local-web-services
+    #   local-web-services-python-sdk
+idna==3.11
+    # via
+    #   anyio
+    #   httpx
+    #   requests
+iniconfig==2.3.0
+    # via pytest
+jmespath==1.1.0
+    # via
+    #   boto3
+    #   botocore
+mando==0.7.1
+    # via radon
+markdown-it-py==4.0.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+mypy-extensions==1.1.0
+    # via black
+packaging==26.0
+    # via
+    #   black
+    #   pytest
+pathspec==1.0.4
+    # via black
+platformdirs==4.9.2
+    # via black
+pluggy==1.6.0
+    # via pytest
+pycparser==3.0 ; implementation_name != 'PyPy' and platform_python_implementation != 'PyPy'
+    # via cffi
+pydantic==2.12.5
+    # via fastapi
+pydantic-core==2.41.5
+    # via pydantic
+pygments==2.19.2
+    # via
+    #   pytest
+    #   rich
+pyjwt==2.11.0
+    # via local-web-services
+pytest==9.0.2
+    # via pytest-asyncio
+pytest-asyncio==1.3.0
+python-dateutil==2.9.0.post0
+    # via
+    #   botocore
+    #   croniter
+python-dotenv==1.2.1
+    # via uvicorn
+python-multipart==0.0.22
+    # via local-web-services
+pytokens==0.4.1
+    # via black
+pytz==2025.2
+    # via croniter
+pywin32==311 ; sys_platform == 'win32'
+    # via docker
+pyyaml==6.0.3
+    # via
+    #   local-web-services
+    #   local-web-services-python-sdk
+    #   uvicorn
+radon==6.0.1
+requests==2.32.5
+    # via docker
+rich==14.3.3
+    # via
+    #   local-web-services
+    #   typer
+ruff==0.15.2
+s3transfer==0.16.0
+    # via boto3
+shellingham==1.5.4
+    # via typer
+six==1.17.0
+    # via
+    #   mando
+    #   python-dateutil
+starlette==0.52.1
+    # via fastapi
+typer==0.24.0
+    # via local-web-services
+typing-extensions==4.15.0
+    # via
+    #   anyio
+    #   fastapi
+    #   pydantic
+    #   pydantic-core
+    #   pytest-asyncio
+    #   starlette
+    #   typing-inspection
+typing-inspection==0.4.2
+    # via
+    #   fastapi
+    #   pydantic
+urllib3==2.6.3
+    # via
+    #   botocore
+    #   docker
+    #   requests
+uvicorn==0.41.0
+    # via local-web-services
+uvloop==0.22.1 ; platform_python_implementation != 'PyPy' and sys_platform != 'cygwin' and sys_platform != 'win32'
+    # via uvicorn
+watchdog==6.0.0
+    # via local-web-services
+watchfiles==1.1.1
+    # via uvicorn
+websockets==16.0
+    # via uvicorn

local_web_services_python_sdk-0.2.0/src/lws_testing/_builders/__init__.py

@@ -0,0 +1 @@
+"""Fluent builders for fake, chaos, and IAM configuration."""

local_web_services_python_sdk-0.1.5/src/lws_testing/_builders/mock.py → local_web_services_python_sdk-0.2.0/src/lws_testing/_builders/fake.py

@@ -1,4 +1,4 @@
-"""Fluent builder for configuring AWS operation mocks."""
+"""Fluent builder for configuring AWS operation fakes."""
 
 from __future__ import annotations
 
@@ -7,12 +7,12 @@ from typing import Any
 import httpx
 
 
-class MockBuilder:
-    """Fluent builder for AWS service mock responses.
+class FakeBuilder:
+    """Fluent builder for AWS service fake responses.
 
     Usage::
 
-        session.mock("dynamodb").operation("PutItem").respond(
+        session.fake("dynamodb").operation("PutItem").respond(
             status=500,
             body={"__type": "ProvisionedThroughputExceededException"},
         )
@@ -23,11 +23,11 @@ class MockBuilder:
         self._mgmt_port = mgmt_port
         self._rules: list[dict[str, Any]] = []
 
-    def operation(self, operation_name: str) -> _MockRuleBuilder:
-        """Start building a mock rule for *operation_name*."""
-        return _MockRuleBuilder(self, operation_name)
+    def operation(self, operation_name: str) -> _FakeRuleBuilder:
+        """Start building a fake rule for *operation_name*."""
+        return _FakeRuleBuilder(self, operation_name)
 
-    def _add_rule(self, rule: dict[str, Any]) -> MockBuilder:
+    def _add_rule(self, rule: dict[str, Any]) -> FakeBuilder:
         self._rules.append(rule)
         self._apply()
         return self
@@ -35,30 +35,30 @@ class MockBuilder:
     def _apply(self) -> None:
         """Push the current rules to the management API."""
         httpx.post(
-            f"http://127.0.0.1:{self._mgmt_port}/_ldk/aws-mock",
+            f"http://127.0.0.1:{self._mgmt_port}/_ldk/aws-fake",
             json={self._service: {"enabled": True, "rules": self._rules}},
             timeout=5.0,
         )
 
     def clear(self) -> None:
-        """Remove all mock rules for this service."""
+        """Remove all fake rules for this service."""
         self._rules = []
         httpx.post(
-            f"http://127.0.0.1:{self._mgmt_port}/_ldk/aws-mock",
+            f"http://127.0.0.1:{self._mgmt_port}/_ldk/aws-fake",
             json={self._service: {"enabled": False, "rules": []}},
             timeout=5.0,
         )
 
 
-class _MockRuleBuilder:
-    """Intermediate builder — configure a single mock rule."""
+class _FakeRuleBuilder:
+    """Intermediate builder — configure a single fake rule."""
 
-    def __init__(self, parent: MockBuilder, operation: str) -> None:
+    def __init__(self, parent: FakeBuilder, operation: str) -> None:
         self._parent = parent
         self._operation = operation
         self._match_headers: dict[str, str] = {}
 
-    def with_header(self, name: str, value: str) -> _MockRuleBuilder:
+    def with_header(self, name: str, value: str) -> _FakeRuleBuilder:
         """Add an additional header match constraint."""
         self._match_headers[name] = value
         return self
@@ -69,7 +69,7 @@ class _MockRuleBuilder:
         body: str | dict[str, Any] = "",
         content_type: str = "application/json",
         delay_ms: int = 0,
-    ) -> MockBuilder:
+    ) -> FakeBuilder:
         """Set the response and register the rule.
 
         Args:
@@ -99,7 +99,7 @@ class _MockRuleBuilder:
 
         return self._parent._add_rule(rule)
 
-    def error(self, error_type: str, message: str = "", status: int = 400) -> MockBuilder:
+    def error(self, error_type: str, message: str = "", status: int = 400) -> FakeBuilder:
         """Respond with a structured AWS error."""
         import json
 

{local_web_services_python_sdk-0.1.5 → local_web_services_python_sdk-0.2.0}/src/lws_testing/_transport/inprocess.py

@@ -108,9 +108,9 @@ class _StubOrchestrator:
 def _create_management_app(
     providers: dict[str, Any],
     chaos_configs: dict[str, Any],
-    mock_configs: dict[str, Any],
+    fake_configs: dict[str, Any],
 ) -> Any:
-    """Build a FastAPI management app with reset, mock, and chaos endpoints."""
+    """Build a FastAPI management app with reset, fake, and chaos endpoints."""
     from fastapi import FastAPI
     from fastapi.responses import JSONResponse
     from lws.api.management import _handle_reset, create_management_router
@@ -122,7 +122,7 @@ def _create_management_app(
         orchestrator=orchestrator,
         providers=providers,
         chaos_configs=chaos_configs,
-        aws_mock_configs=mock_configs,
+        aws_fake_configs=fake_configs,
     )
     app.include_router(router)
 
@@ -182,7 +182,7 @@ def _build_service_apps(
     providers: dict[str, Any],
     ports: dict[str, int],
     chaos_configs: dict[str, Any],
-    mock_configs: dict[str, Any],
+    fake_configs: dict[str, Any],
     cfg: dict[str, list[Any]],
 ) -> list[tuple[str, Any]]:
     """Build FastAPI apps for all services; return as (service_name, app) pairs."""
@@ -200,7 +200,7 @@ def _build_service_apps(
             create_dynamodb_app(
                 providers["dynamodb"],
                 chaos=chaos_configs["dynamodb"],
-                aws_mock=mock_configs["dynamodb"],
+                aws_fake=fake_configs["dynamodb"],
             ),
         ),
         (
@@ -209,7 +209,7 @@ def _build_service_apps(
                 providers["sqs"],
                 port=ports["sqs"],
                 chaos=chaos_configs["sqs"],
-                aws_mock=mock_configs["sqs"],
+                aws_fake=fake_configs["sqs"],
             ),
         ),
         (
@@ -217,7 +217,7 @@ def _build_service_apps(
             create_s3_app(
                 providers["s3"],
                 chaos=chaos_configs["s3"],
-                aws_mock=mock_configs["s3"],
+                aws_fake=fake_configs["s3"],
             ),
         ),
         (
@@ -225,7 +225,7 @@ def _build_service_apps(
             create_sns_app(
                 providers["sns"],
                 chaos=chaos_configs["sns"],
-                aws_mock=mock_configs["sns"],
+                aws_fake=fake_configs["sns"],
             ),
         ),
         (
@@ -233,7 +233,7 @@ def _build_service_apps(
             create_stepfunctions_app(
                 providers["stepfunctions"],
                 chaos=chaos_configs["stepfunctions"],
-                aws_mock=mock_configs["stepfunctions"],
+                aws_fake=fake_configs["stepfunctions"],
             ),
         ),
         (
@@ -241,7 +241,7 @@ def _build_service_apps(
             create_ssm_app(
                 initial_parameters=cfg["parameters"] or None,
                 chaos=chaos_configs["ssm"],
-                aws_mock=mock_configs["ssm"],
+                aws_fake=fake_configs["ssm"],
             ),
         ),
         (
@@ -249,7 +249,7 @@ def _build_service_apps(
             create_secretsmanager_app(
                 initial_secrets=cfg["secrets"] or None,
                 chaos=chaos_configs["secretsmanager"],
-                aws_mock=mock_configs["secretsmanager"],
+                aws_fake=fake_configs["secretsmanager"],
             ),
         ),
     ]
@@ -268,7 +268,7 @@ async def _start_all_servers(
     mgmt_port: int,
 ) -> list[Any]:
     """Start uvicorn servers for every service app plus the management app."""
-    from lws.providers.mockserver.provider import start_uvicorn_server
+    from lws.providers.fakeserver.provider import start_uvicorn_server
 
     servers: list[Any] = []
     for svc, app in service_apps:
@@ -302,20 +302,20 @@ async def start_services(
         passed directly to :func:`stop_services`.
     """
     from lws.providers._shared.aws_chaos import AwsChaosConfig
-    from lws.providers._shared.aws_operation_mock import AwsMockConfig
+    from lws.providers._shared.aws_operation_fake import AwsFakeConfig
 
     log_handler = _setup_logging()
     cfg = _convert_spec(spec)
     providers = _create_providers(cfg, data_dir)
 
     chaos_configs: dict[str, Any] = {s: AwsChaosConfig() for s in _SERVICE_NAMES}
-    mock_configs: dict[str, Any] = {s: AwsMockConfig(service=s) for s in _SERVICE_NAMES}
+    fake_configs: dict[str, Any] = {s: AwsFakeConfig(service=s) for s in _SERVICE_NAMES}
     ports: dict[str, int] = {s: _free_port() for s in _SERVICE_NAMES}
     mgmt_port = _free_port()
 
-    service_apps = _build_service_apps(providers, ports, chaos_configs, mock_configs, cfg)
+    service_apps = _build_service_apps(providers, ports, chaos_configs, fake_configs, cfg)
     await _start_providers(providers)
-    mgmt_app = _create_management_app(providers, chaos_configs, mock_configs)
+    mgmt_app = _create_management_app(providers, chaos_configs, fake_configs)
     servers = await _start_all_servers(service_apps, ports, mgmt_app, mgmt_port)
 
     return log_handler, ports, mgmt_port, servers
@@ -323,7 +323,7 @@ async def start_services(
 
 async def stop_services(servers: list[Any]) -> None:
     """Gracefully stop all servers started by :func:`start_services`."""
-    from lws.providers.mockserver.provider import stop_uvicorn_server
+    from lws.providers.fakeserver.provider import stop_uvicorn_server
 
     for server, task in reversed(servers):
         await stop_uvicorn_server(server, task)

{local_web_services_python_sdk-0.1.5 → local_web_services_python_sdk-0.2.0}/src/lws_testing/session.py

@@ -46,7 +46,7 @@ class LwsSession:
 
     Starts all LWS service providers in background threads within the test
     process, patches boto3 clients, and provides helpers for seeding state,
-    configuring mocks, capturing logs, and asserting side effects.
+    configuring fakes, capturing logs, and asserting side effects.
 
     Use as a context manager::
 
@@ -341,13 +341,13 @@ class LwsSession:
         """
         return f"http://127.0.0.1:{self._ports['sqs']}/000000000000/{queue_name}"
 
-    # ── Mock / chaos / IAM builders ───────────────────────────────────────────
+    # ── Fake / chaos / IAM builders ───────────────────────────────────────────
 
-    def mock(self, service: str) -> Any:
-        """Return a fluent mock builder for the given service."""
-        from lws_testing._builders.mock import MockBuilder
+    def fake(self, service: str) -> Any:
+        """Return a fluent fake builder for the given service."""
+        from lws_testing._builders.fake import FakeBuilder
 
-        return MockBuilder(service, self._mgmt_port)
+        return FakeBuilder(service, self._mgmt_port)
 
     def chaos(self, service: str) -> Any:
         """Return a fluent chaos builder for the given service."""

local_web_services_python_sdk-0.2.0/tests/BUILD

@@ -0,0 +1,15 @@
+load("@pip_python_sdk//:requirements.bzl", "requirement")
+load("@rules_python//python:defs.bzl", "py_test")
+
+py_test(
+    name = "tests",
+    srcs = glob(["**/*.py"]),
+    data = ["//core:ldk"],
+    imports = ["../src"],
+    main = "pytest_runner.py",
+    deps = [
+        "//lang/python/sdk:lws_testing",
+        requirement("pytest"),
+        requirement("boto3"),
+    ],
+)

local_web_services_python_sdk-0.2.0/tests/pytest_runner.py

@@ -0,0 +1,10 @@
+"""Bazel py_test entry point: discovers and runs tests with pytest."""
+
+import os
+import sys
+
+import pytest
+
+if __name__ == "__main__":
+    test_dir = os.path.join(os.path.dirname(__file__), "tests")
+    sys.exit(pytest.main([test_dir, "-v", "--tb=short"] + sys.argv[1:]))

{local_web_services_python_sdk-0.1.5 → local_web_services_python_sdk-0.2.0}/tests/unit/test_session_imports.py

@@ -43,7 +43,7 @@ def test_resource_helpers_importable():
 def test_builders_importable():
     from lws_testing._builders.chaos import ChaosBuilder  # noqa: F401
     from lws_testing._builders.iam import IamBuilder  # noqa: F401
-    from lws_testing._builders.mock import MockBuilder  # noqa: F401
+    from lws_testing._builders.fake import FakeBuilder  # noqa: F401
 
 
 def test_discovery_importable():

local_web_services_python_sdk-0.1.5/src/lws_testing/_builders/__init__.py

@@ -1 +0,0 @@
-"""Fluent builders for mock, chaos, and IAM configuration."""