payi 0.1.0a97__tar.gz → 0.1.0a98__tar.gz

payi-0.1.0a98/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-alpha.98"
+}

{payi-0.1.0a97 → payi-0.1.0a98}/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.1.0-alpha.98 (2025-07-11)
+
+Full Changelog: [v0.1.0-alpha.97...v0.1.0-alpha.98](https://github.com/Pay-i/pay-i-python/compare/v0.1.0-alpha.97...v0.1.0-alpha.98)
+
+### Features
+
+* instrument provider module version ([9bc9596](https://github.com/Pay-i/pay-i-python/commit/9bc9596edb103b187dc468b9592d5e8a0c5f38f3))
+
+
+### Bug Fixes
+
+* **parsing:** correctly handle nested discriminated unions ([38be788](https://github.com/Pay-i/pay-i-python/commit/38be7889bf028750274f66a584e229a9578033eb))
+
+
+### Chores
+
+* **internal:** bump pinned h11 dep ([9a1ef2e](https://github.com/Pay-i/pay-i-python/commit/9a1ef2efb18e5bd7e2e66a8176feefdc1c22ea22))
+* **package:** mark python 3.13 as supported ([5ab6ac5](https://github.com/Pay-i/pay-i-python/commit/5ab6ac561585ffdc8ff1d07b06d873e0ef99a1ea))
+* **readme:** fix version rendering on pypi ([3f91efc](https://github.com/Pay-i/pay-i-python/commit/3f91efc050e6ffcf97617f2b727c2f68fd83d91f))
+
 ## 0.1.0-alpha.97 (2025-07-08)
 
 Full Changelog: [v0.1.0-alpha.96...v0.1.0-alpha.97](https://github.com/Pay-i/pay-i-python/compare/v0.1.0-alpha.96...v0.1.0-alpha.97)

{payi-0.1.0a97 → payi-0.1.0a98}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: payi
-Version: 0.1.0a97
+Version: 0.1.0a98
 Summary: The official Python library for the payi API
 Project-URL: Homepage, https://github.com/Pay-i/pay-i-python
 Project-URL: Repository, https://github.com/Pay-i/pay-i-python
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.9
 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: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.8
@@ -37,7 +38,8 @@ Description-Content-Type: text/markdown
 
 # Payi Python API library
 
-[![PyPI version](https://github.com/Pay-i/pay-i-python/tree/main/<https://img.shields.io/pypi/v/payi.svg?label=pypi%20(stable)>)](https://pypi.org/project/payi/)
+<!-- prettier-ignore -->
+[![PyPI version](https://img.shields.io/pypi/v/payi.svg?label=pypi%20(stable))](https://pypi.org/project/payi/)
 
 The Payi Python library provides convenient access to the Payi REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,

{payi-0.1.0a97 → payi-0.1.0a98}/README.md

@@ -1,6 +1,7 @@
 # Payi Python API library
 
-[![PyPI version](<https://img.shields.io/pypi/v/payi.svg?label=pypi%20(stable)>)](https://pypi.org/project/payi/)
+<!-- prettier-ignore -->
+[![PyPI version](https://img.shields.io/pypi/v/payi.svg?label=pypi%20(stable))](https://pypi.org/project/payi/)
 
 The Payi Python library provides convenient access to the Payi REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,

{payi-0.1.0a97 → payi-0.1.0a98}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "payi"
-version = "0.1.0-alpha.97"
+version = "0.1.0-alpha.98"
 description = "The official Python library for the payi API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -27,6 +27,7 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "Operating System :: OS Independent",
   "Operating System :: POSIX",
   "Operating System :: MacOS",

{payi-0.1.0a97 → payi-0.1.0a98}/requirements-dev.lock

@@ -51,9 +51,9 @@ filelock==3.12.4
 frozenlist==1.6.2
     # via aiohttp
     # via aiosignal
-h11==0.14.0
+h11==0.16.0
     # via httpcore
-httpcore==1.0.2
+httpcore==1.0.9
     # via httpx
 httpx==0.28.1
     # via httpx-aiohttp

{payi-0.1.0a97 → payi-0.1.0a98}/requirements.lock

@@ -39,9 +39,9 @@ exceptiongroup==1.2.2
 frozenlist==1.6.2
     # via aiohttp
     # via aiosignal
-h11==0.14.0
+h11==0.16.0
     # via httpcore
-httpcore==1.0.2
+httpcore==1.0.9
     # via httpx
 httpx==0.28.1
     # via httpx-aiohttp

{payi-0.1.0a97 → payi-0.1.0a98}/src/payi/_models.py

@@ -2,9 +2,10 @@ from __future__ import annotations
 
 import os
 import inspect
-from typing import TYPE_CHECKING, Any, Type, Union, Generic, TypeVar, Callable, cast
+from typing import TYPE_CHECKING, Any, Type, Union, Generic, TypeVar, Callable, Optional, cast
 from datetime import date, datetime
 from typing_extensions import (
+    List,
     Unpack,
     Literal,
     ClassVar,
@@ -366,7 +367,7 @@ def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     if type_ is None:
         raise RuntimeError(f"Unexpected field type is None for {key}")
 
-    return construct_type(value=value, type_=type_)
+    return construct_type(value=value, type_=type_, metadata=getattr(field, "metadata", None))
 
 
 def is_basemodel(type_: type) -> bool:
@@ -420,7 +421,7 @@ def construct_type_unchecked(*, value: object, type_: type[_T]) -> _T:
     return cast(_T, construct_type(value=value, type_=type_))
 
 
-def construct_type(*, value: object, type_: object) -> object:
+def construct_type(*, value: object, type_: object, metadata: Optional[List[Any]] = None) -> object:
     """Loose coercion to the expected type with construction of nested values.
 
     If the given value does not match the expected type then it is returned as-is.
@@ -438,8 +439,10 @@ def construct_type(*, value: object, type_: object) -> object:
         type_ = type_.__value__  # type: ignore[unreachable]
 
     # unwrap `Annotated[T, ...]` -> `T`
-    if is_annotated_type(type_):
-        meta: tuple[Any, ...] = get_args(type_)[1:]
+    if metadata is not None:
+        meta: tuple[Any, ...] = tuple(metadata)
+    elif is_annotated_type(type_):
+        meta = get_args(type_)[1:]
         type_ = extract_type_arg(type_, 0)
     else:
         meta = tuple()

{payi-0.1.0a97 → payi-0.1.0a98}/src/payi/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "payi"
-__version__ = "0.1.0-alpha.97"  # x-release-please-version
+__version__ = "0.1.0-alpha.98"  # x-release-please-version

{payi-0.1.0a97 → payi-0.1.0a98}/src/payi/lib/AnthropicInstrumentor.py

@@ -9,9 +9,13 @@ from payi.lib.helpers import PayiCategories
 from payi.types.ingest_units_params import Units
 
 from .instrument import _ChunkResult, _IsStreaming, _StreamingType, _ProviderRequest, _PayiInstrumentor
+from .version_helper import get_version_helper
 
 
 class AnthropicInstrumentor:
+    _module_name: str = "anthropic"
+    _module_version: str = ""
+
     @staticmethod
     def is_vertex(instance: Any) -> bool:
         from anthropic import AnthropicVertex, AsyncAnthropicVertex  # type: ignore # noqa: I001
@@ -27,7 +31,7 @@ class AnthropicInstrumentor:
     @staticmethod
     def instrument(instrumentor: _PayiInstrumentor) -> None:
         try:
-            import anthropic  # type: ignore #  noqa: F401  I001
+            AnthropicInstrumentor._module_version = get_version_helper(AnthropicInstrumentor._module_name)
 
             wrap_function_wrapper(
                 "anthropic.resources.messages",
@@ -149,6 +153,8 @@ class _AnthropicProviderRequest(_ProviderRequest):
             instrumentor=instrumentor,
             category=category,
             streaming_type=streaming_type,
+            module_name=AnthropicInstrumentor._module_name,
+            module_version=AnthropicInstrumentor._module_version,
             )
 
     @override

{payi-0.1.0a97 → payi-0.1.0a98}/src/payi/lib/BedrockInstrumentor.py

@@ -11,15 +11,21 @@ from payi.types.ingest_units_params import Units
 from payi.types.pay_i_common_models_api_router_header_info_param import PayICommonModelsAPIRouterHeaderInfoParam
 
 from .instrument import _ChunkResult, _IsStreaming, _StreamingType, _ProviderRequest, _PayiInstrumentor
+from .version_helper import get_version_helper
 
 
 class BedrockInstrumentor:
+    _module_name: str = "boto3"
+    _module_version: str = ""
+
     _instrumentor: _PayiInstrumentor
 
     @staticmethod
     def instrument(instrumentor: _PayiInstrumentor) -> None:
         BedrockInstrumentor._instrumentor = instrumentor
 
+        BedrockInstrumentor._module_version = get_version_helper(BedrockInstrumentor._module_name)
+
         try:
             wrap_function_wrapper(
                 "botocore.client",
@@ -234,6 +240,8 @@ class _BedrockProviderRequest(_ProviderRequest):
             instrumentor=instrumentor,
             category=PayiCategories.aws_bedrock,
             streaming_type=_StreamingType.iterator,
+            module_name=BedrockInstrumentor._module_name,
+            module_version=BedrockInstrumentor._module_version,
             is_aws_client=True,
             )
 

{payi-0.1.0a97 → payi-0.1.0a98}/src/payi/lib/GoogleGenAiInstrumentor.py

@@ -5,12 +5,18 @@ from wrapt import wrap_function_wrapper  # type: ignore
 
 from .instrument import _ChunkResult, _IsStreaming, _PayiInstrumentor
 from .VertexRequest import _VertexRequest
+from .version_helper import get_version_helper
 
 
 class GoogleGenAiInstrumentor:
+    _module_name: str = "google-genai"
+    _module_version: str = ""
+
     @staticmethod
     def instrument(instrumentor: _PayiInstrumentor) -> None:
         try:
+            GoogleGenAiInstrumentor._module_version = get_version_helper(GoogleGenAiInstrumentor._module_name)
+
             wrap_function_wrapper(
                 "google.genai.models",
                 "Models.generate_content",
@@ -115,6 +121,8 @@ class _GoogleGenAiRequest(_VertexRequest):
     def __init__(self, instrumentor: _PayiInstrumentor):
         super().__init__(
             instrumentor=instrumentor,
+            module_name=GoogleGenAiInstrumentor._module_name,
+            module_version=GoogleGenAiInstrumentor._module_version,
             )
         self._prompt_character_count = 0
         self._candidates_character_count = 0

{payi-0.1.0a97 → payi-0.1.0a98}/src/payi/lib/OpenAIInstrumentor.py

@@ -10,9 +10,13 @@ from payi.lib.helpers import PayiCategories, PayiHeaderNames
 from payi.types.ingest_units_params import Units
 
 from .instrument import _ChunkResult, _IsStreaming, _StreamingType, _ProviderRequest, _PayiInstrumentor
+from .version_helper import get_version_helper
 
 
 class OpenAiInstrumentor:
+    _module_name: str = "openai"
+    _module_version: str = ""
+
     @staticmethod
     def is_azure(instance: Any) -> bool:
         from openai import AzureOpenAI, AsyncAzureOpenAI # type: ignore # noqa: I001
@@ -22,6 +26,8 @@ class OpenAiInstrumentor:
     @staticmethod
     def instrument(instrumentor: _PayiInstrumentor) -> None:
         try:
+            OpenAiInstrumentor._module_version = get_version_helper(OpenAiInstrumentor._module_name)
+
             wrap_function_wrapper(
                 "openai.resources.chat.completions",
                 "Completions.create",
@@ -187,6 +193,8 @@ class _OpenAiProviderRequest(_ProviderRequest):
             instrumentor=instrumentor,
             category=PayiCategories.openai,
             streaming_type=_StreamingType.iterator,
+            module_name=OpenAiInstrumentor._module_name,
+            module_version=OpenAiInstrumentor._module_version,
             )
         self._input_tokens_key = input_tokens_key
         self._output_tokens_key = output_tokens_key

{payi-0.1.0a97 → payi-0.1.0a98}/src/payi/lib/VertexInstrumentor.py

@@ -5,12 +5,18 @@ from wrapt import wrap_function_wrapper  # type: ignore
 
 from .instrument import _ChunkResult, _IsStreaming, _PayiInstrumentor
 from .VertexRequest import _VertexRequest
+from .version_helper import get_version_helper
 
 
 class VertexInstrumentor:
+    _module_name: str = "google-cloud-aiplatform"
+    _module_version: str = ""
+
     @staticmethod
     def instrument(instrumentor: _PayiInstrumentor) -> None:
         try:
+            VertexInstrumentor._module_version = get_version_helper(VertexInstrumentor._module_name)
+
             wrap_function_wrapper(
                 "vertexai.generative_models",
                 "GenerativeModel.generate_content",
@@ -85,6 +91,8 @@ class _GoogleVertexRequest(_VertexRequest):
     def __init__(self, instrumentor: _PayiInstrumentor):
         super().__init__(
             instrumentor=instrumentor,
+            module_name=VertexInstrumentor._module_name,
+            module_version=VertexInstrumentor._module_version,
             )
         self._prompt_character_count = 0
         self._candidates_character_count = 0

{payi-0.1.0a97 → payi-0.1.0a98}/src/payi/lib/VertexRequest.py

@@ -12,11 +12,18 @@ from .instrument import _ChunkResult, _StreamingType, _ProviderRequest, _PayiIns
 class _VertexRequest(_ProviderRequest): # type: ignore
     KNOWN_MODALITIES = ("VIDEO", "AUDIO", "TEXT", "VISION", "IMAGE")
 
-    def __init__(self, instrumentor: _PayiInstrumentor):
+    def __init__(
+            self,
+            instrumentor: _PayiInstrumentor,
+            module_name: str,
+            module_version: str
+            ) -> None:
         super().__init__(
             instrumentor=instrumentor,
             category=PayiCategories.google_vertex,
             streaming_type=_StreamingType.generator,
+            module_name=module_name,
+            module_version=module_version,
             is_google_vertex_or_genai_client=True,
             )
         self._prompt_character_count = 0

{payi-0.1.0a97 → payi-0.1.0a98}/src/payi/lib/instrument.py

@@ -37,13 +37,18 @@ class _ChunkResult:
     
 class _ProviderRequest:
     def __init__(
-            self, instrumentor: '_PayiInstrumentor',
+            self, 
+            instrumentor: '_PayiInstrumentor',
             category: str,
             streaming_type: '_StreamingType',
+            module_name: str,
+            module_version: str,
             is_aws_client: Optional[bool] = None,
             is_google_vertex_or_genai_client: Optional[bool] = None,
             ) -> None:
         self._instrumentor: '_PayiInstrumentor' = instrumentor
+        self._module_name: str = module_name
+        self._module_version: str = module_version  
         self._estimated_prompt_tokens: Optional[int] = None
         self._category: str = category
         self._ingest: IngestUnitsParams = { "category": category, "units": {} } # type: ignore
@@ -205,6 +210,7 @@ class _InternalTrackContext:
 
 class _PayiInstrumentor:
     _not_instrumented: str = "<not_instrumented>"
+    _instrumented_module_header_name: str = "xProxy-Instrumented-Module"
 
     def __init__(
         self,
@@ -371,9 +377,15 @@ class _PayiInstrumentor:
 
         return log_ingest_units
         
-    def _process_ingest_units(self, request: _ProviderRequest, log_data: 'dict[str, str]') -> None:
+    def _process_ingest_units(
+            self,
+            request: _ProviderRequest, log_data: 'dict[str, str]',
+            extra_headers: 'dict[str, str]') -> None:
         ingest_units = request._ingest
 
+        if request._module_version:
+            extra_headers[_PayiInstrumentor._instrumented_module_header_name] = f'{request._module_name}/{request._module_version}'
+
         if request._function_call_builder:
             # convert the function call builder to a list of function calls
             ingest_units["provider_response_function_calls"] = list(request._function_call_builder.values())
@@ -455,17 +467,18 @@ class _PayiInstrumentor:
 
         # return early if there are no units to ingest and on a successul ingest request
         log_data: 'dict[str,str]' = {}
+        extra_headers: 'dict[str, str]' = {}
 
-        self._process_ingest_units(request, log_data)
+        self._process_ingest_units(request, log_data=log_data, extra_headers=extra_headers)
 
         try:
             if self._logger.isEnabledFor(logging.DEBUG):
                 self._logger.debug(f"_aingest_units: sending ({self._create_logged_ingest_units(ingest_units)})")
 
             if self._apayi:    
-                ingest_response = await self._apayi.ingest.units(**ingest_units)
+                ingest_response = await self._apayi.ingest.units(**ingest_units, extra_headers=extra_headers)
             elif self._payi:
-                ingest_response = self._payi.ingest.units(**ingest_units)
+                ingest_response = self._payi.ingest.units(**ingest_units, extra_headers=extra_headers)
             else:
                 self._logger.error("No payi instance to ingest units")
                 return XproxyError(code="configuration_error", message="No Payi or AsyncPayi instance configured for ingesting units")
@@ -572,15 +585,15 @@ class _PayiInstrumentor:
 
         # return early if there are no units to ingest and on a successul ingest request
         log_data: 'dict[str,str]' = {}
-
-        self._process_ingest_units(request, log_data)
+        extra_headers: 'dict[str, str]' = {}
+        self._process_ingest_units(request, log_data=log_data, extra_headers=extra_headers)
 
         try:
             if self._payi:
                 if self._logger.isEnabledFor(logging.DEBUG):
                     self._logger.debug(f"_ingest_units: sending ({self._create_logged_ingest_units(ingest_units)})")
 
-                ingest_response = self._payi.ingest.units(**ingest_units)
+                ingest_response = self._payi.ingest.units(**ingest_units, extra_headers=extra_headers)
                 self._logger.debug(f"_ingest_units: success ({ingest_response})")
 
                 self._process_ingest_units_response(ingest_response)

payi-0.1.0a98/src/payi/lib/version_helper.py

@@ -0,0 +1,21 @@
+from importlib.metadata import version
+
+
+def get_version_helper(module:str) -> str:
+    """
+    Get the version of the specified module.
+    
+    Args:
+        module (str): The name of the module to query.
+    
+    Returns:
+        str: The version of the module, or an empty string if not found.
+    """
+    try:
+        return version(module)
+    except Exception:
+        try:
+            imported_module = __import__(module)
+            return getattr(imported_module, "__version__", "")
+        except Exception:
+            return ""

{payi-0.1.0a97 → payi-0.1.0a98}/tests/test_models.py

@@ -889,3 +889,48 @@ def test_discriminated_union_case() -> None:
     )
 
     assert isinstance(m, ModelB)
+
+
+def test_nested_discriminated_union() -> None:
+    class InnerType1(BaseModel):
+        type: Literal["type_1"]
+
+    class InnerModel(BaseModel):
+        inner_value: str
+
+    class InnerType2(BaseModel):
+        type: Literal["type_2"]
+        some_inner_model: InnerModel
+
+    class Type1(BaseModel):
+        base_type: Literal["base_type_1"]
+        value: Annotated[
+            Union[
+                InnerType1,
+                InnerType2,
+            ],
+            PropertyInfo(discriminator="type"),
+        ]
+
+    class Type2(BaseModel):
+        base_type: Literal["base_type_2"]
+
+    T = Annotated[
+        Union[
+            Type1,
+            Type2,
+        ],
+        PropertyInfo(discriminator="base_type"),
+    ]
+
+    model = construct_type(
+        type_=T,
+        value={
+            "base_type": "base_type_1",
+            "value": {
+                "type": "type_2",
+            },
+        },
+    )
+    assert isinstance(model, Type1)
+    assert isinstance(model.value, InnerType2)

payi-0.1.0a97/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.1.0-alpha.97"
-}