reflectapi-runtime 0.17.2a1__tar.gz

reflectapi_runtime-0.17.2a1/.gitignore

@@ -0,0 +1,5 @@
+/target
+docs/book
+.vscode/settings.json
+*.pyc
+__pycache__/

reflectapi_runtime-0.17.2a1/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: reflectapi-runtime
+Version: 0.17.2a1
+Summary: Runtime library for ReflectAPI Python clients
+Project-URL: Homepage, https://github.com/thepartly/reflectapi
+Project-URL: Repository, https://github.com/thepartly/reflectapi
+Project-URL: Documentation, https://docs.rs/reflectapi/latest/reflectapi/
+Author: Partly
+License: MIT
+Keywords: api,client,codegen,http,rest
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: hypothesis>=6.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.5.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: hypothesis>=6.0.0; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# reflectapi-runtime
+
+Runtime support library for Python clients generated by
+[`reflectapi`](https://github.com/thepartly/reflectapi). Generated code
+imports from `reflectapi_runtime`; you don't normally call this library
+directly.
+
+## What it provides
+
+- `ClientBase` / `AsyncClientBase` — base classes used by the generated
+  `Client` / `AsyncClient`. They wrap `httpx` and handle request build-up,
+  Pydantic-based response validation, and middleware.
+- `ApiResponse[T, E]` — typed wrapper around the response value, transport
+  metadata, and the optional typed error.
+- `ApplicationError`, `NetworkError`, `TimeoutError`, `ValidationError` —
+  exceptions raised by the generated methods on non-2xx, transport, and
+  validation failures respectively.
+- `ReflectapiOption` — three-state Option used by the generated models
+  (`some` / `none` / `undefined`) so absent and explicit-null can round-trip.
+- Authentication helpers (`BearerTokenAuth`, `APIKeyAuth`, `BasicAuth`,
+  `OAuth2ClientCredentialsAuth`, `OAuth2AuthorizationCodeAuth`).
+- Middleware, batching, and testing utilities (`MockClient`,
+  `CassetteMiddleware`).
+
+## Streaming endpoints
+
+Endpoints declared with `Builder::stream_route` on the server are exposed on
+the generated client as ordinary methods that return an iterator:
+
+```python
+async with AsyncClient("http://localhost:3000") as client:
+    async for event in client.pets.cdc_events(headers=headers):
+        ...  # process each event
+```
+
+The sync client returns a regular `Iterator`; both validate each event
+against the declared item model. The wire format is Server-Sent Events
+(`data: <json>\n\n`); init failures (4xx/5xx) raise `ApplicationError` and
+do not enter the iterator. Breaking out of the loop or calling
+`stream.aclose()` releases the underlying HTTP connection.
+
+Validation is strict: an event whose payload doesn't match the item model
+(for example, an unknown discriminated-union variant added by a newer
+server) raises `ValidationError` mid-stream and the iterator terminates.
+Items received before the bad event are still delivered.
+
+## Compatibility
+
+Python 3.12+. The package targets the same `reflectapi` minor version as
+the schema you generate from; mismatches will surface at import time.

reflectapi_runtime-0.17.2a1/README.md

@@ -0,0 +1,50 @@
+# reflectapi-runtime
+
+Runtime support library for Python clients generated by
+[`reflectapi`](https://github.com/thepartly/reflectapi). Generated code
+imports from `reflectapi_runtime`; you don't normally call this library
+directly.
+
+## What it provides
+
+- `ClientBase` / `AsyncClientBase` — base classes used by the generated
+  `Client` / `AsyncClient`. They wrap `httpx` and handle request build-up,
+  Pydantic-based response validation, and middleware.
+- `ApiResponse[T, E]` — typed wrapper around the response value, transport
+  metadata, and the optional typed error.
+- `ApplicationError`, `NetworkError`, `TimeoutError`, `ValidationError` —
+  exceptions raised by the generated methods on non-2xx, transport, and
+  validation failures respectively.
+- `ReflectapiOption` — three-state Option used by the generated models
+  (`some` / `none` / `undefined`) so absent and explicit-null can round-trip.
+- Authentication helpers (`BearerTokenAuth`, `APIKeyAuth`, `BasicAuth`,
+  `OAuth2ClientCredentialsAuth`, `OAuth2AuthorizationCodeAuth`).
+- Middleware, batching, and testing utilities (`MockClient`,
+  `CassetteMiddleware`).
+
+## Streaming endpoints
+
+Endpoints declared with `Builder::stream_route` on the server are exposed on
+the generated client as ordinary methods that return an iterator:
+
+```python
+async with AsyncClient("http://localhost:3000") as client:
+    async for event in client.pets.cdc_events(headers=headers):
+        ...  # process each event
+```
+
+The sync client returns a regular `Iterator`; both validate each event
+against the declared item model. The wire format is Server-Sent Events
+(`data: <json>\n\n`); init failures (4xx/5xx) raise `ApplicationError` and
+do not enter the iterator. Breaking out of the loop or calling
+`stream.aclose()` releases the underlying HTTP connection.
+
+Validation is strict: an event whose payload doesn't match the item model
+(for example, an unknown discriminated-union variant added by a newer
+server) raises `ValidationError` mid-stream and the iterator terminates.
+Items received before the bad event are still delivered.
+
+## Compatibility
+
+Python 3.12+. The package targets the same `reflectapi` minor version as
+the schema you generate from; mismatches will surface at import time.

reflectapi_runtime-0.17.2a1/pyproject.toml

@@ -0,0 +1,133 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "reflectapi-runtime"
+version = "0.17.2a1"
+description = "Runtime library for ReflectAPI Python clients"
+readme = "README.md"
+requires-python = ">=3.12"
+license = {text = "MIT"}
+authors = [
+    {name = "Partly"}
+]
+keywords = ["api", "client", "codegen", "rest", "http"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pydantic>=2.0.0",
+    "httpx>=0.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "hypothesis>=6.0.0",
+    "mypy>=1.5.0",
+    "ruff>=0.1.0",
+]
+test = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "hypothesis>=6.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/thepartly/reflectapi"
+Repository = "https://github.com/thepartly/reflectapi"
+Documentation = "https://docs.rs/reflectapi/latest/reflectapi/"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/reflectapi_runtime"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/README.md",
+]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+
+[tool.ruff.lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4", # flake8-comprehensions
+    "UP", # pyupgrade
+    "ARG", # flake8-unused-arguments
+    "SIM", # flake8-simplify
+    "TCH", # flake8-type-checking
+]
+ignore = [
+    "B008",  # do not perform function calls in argument defaults
+    "B024",  # abstract base class without abstract methods
+    "B904",  # raise from err/None - we handle this explicitly
+    "UP046", # Generic[T] vs type parameters - keeping for compatibility
+    "UP047", # Generic functions - keeping for compatibility
+    "SIM105", # contextlib.suppress - prefer explicit error handling
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*" = ["ARG", "S101", "F401", "F811"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "--cov=src/reflectapi_runtime",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+    "--cov-report=xml",
+]
+markers = [
+    "unit: Unit tests",
+    "integration: Integration tests",
+    "slow: Slow tests",
+]
+asyncio_mode = "auto"
+
+[dependency-groups]
+dev = [
+    "mypy>=1.17.0",
+    "pytest>=8.4.1",
+    "pytest-asyncio>=1.1.0",
+    "pytest-cov>=6.2.1",
+    "ruff>=0.12.5",
+    "ty>=0.0.1a16",
+]

reflectapi_runtime-0.17.2a1/src/reflectapi_runtime/__init__.py

@@ -0,0 +1,109 @@
+"""ReflectAPI Python Runtime Library.
+
+This package provides the core runtime components for ReflectAPI-generated clients.
+"""
+
+from .auth import (
+    APIKeyAuth,
+    AuthHandler,
+    AuthToken,
+    BasicAuth,
+    BearerTokenAuth,
+    CustomAuth,
+    OAuth2AuthorizationCodeAuth,
+    OAuth2ClientCredentialsAuth,
+    api_key,
+    basic_auth,
+    bearer_token,
+    oauth2_authorization_code,
+    oauth2_client_credentials,
+)
+from .batch import BatchClient
+from .client import AsyncClientBase, ClientBase
+from .exceptions import (
+    ApiError,
+    ApplicationError,
+    NetworkError,
+    TimeoutError,
+    ValidationError,
+)
+from .hypothesis_strategies import (
+    HAS_HYPOTHESIS,
+    api_model_strategy,
+    enhanced_strategy_for_type,
+    strategy_for_pydantic_model,
+    strategy_for_type,
+)
+from .middleware import AsyncMiddleware
+from .option import (
+    Option,
+    ReflectapiOption,
+    Undefined,
+    none,
+    serialize_option_dict,
+    some,
+    undefined,
+)
+from .response import ApiResponse, TransportMetadata
+from .streaming import AsyncStreamingClient, StreamingResponse
+from .testing import (
+    AsyncCassetteMiddleware,
+    CassetteClient,
+    CassetteMiddleware,
+    MockClient,
+    TestClientMixin,
+)
+from .types import BatchResult, ReflectapiEmpty, ReflectapiInfallible
+
+__version__ = "0.17.2a1"
+
+__all__ = [
+    # Authentication
+    "APIKeyAuth",
+    "AuthHandler",
+    "AuthToken",
+    "BasicAuth",
+    "BearerTokenAuth",
+    "CustomAuth",
+    "OAuth2AuthorizationCodeAuth",
+    "OAuth2ClientCredentialsAuth",
+    "api_key",
+    "basic_auth",
+    "bearer_token",
+    "oauth2_authorization_code",
+    "oauth2_client_credentials",
+    # Core
+    "ApiError",
+    "ApiResponse",
+    "ApplicationError",
+    "AsyncCassetteMiddleware",
+    "AsyncClientBase",
+    "AsyncStreamingClient",
+    "BatchClient",
+    "BatchResult",
+    "CassetteClient",
+    "CassetteMiddleware",
+    "ClientBase",
+    "HAS_HYPOTHESIS",
+    "AsyncMiddleware",
+    "MockClient",
+    "NetworkError",
+    "Option",
+    "ReflectapiEmpty",
+    "ReflectapiInfallible",
+    "ReflectapiOption",
+    "StreamingResponse",
+    "TestClientMixin",
+    "TimeoutError",
+    "TransportMetadata",
+    "Undefined",
+    "ValidationError",
+    "api_model_strategy",
+    "enhanced_strategy_for_type",
+    "none",
+    "serialize_option_dict",
+    "some",
+    "strategy_for_pydantic_model",
+    "strategy_for_type",
+    "undefined",
+]