jentic-openapi-parser 1.0.0a22__tar.gz → 1.0.0a23__tar.gz

{jentic_openapi_parser-1.0.0a22 → jentic_openapi_parser-1.0.0a23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jentic-openapi-parser
-Version: 1.0.0a22
+Version: 1.0.0a23
 Summary: Jentic OpenAPI Parser
 Author: Jentic
 Author-email: Jentic <hello@jentic.com>
@@ -8,8 +8,8 @@ License-Expression: Apache-2.0
 License-File: LICENSE
 License-File: NOTICE
 Requires-Dist: attrs~=25.4.0
-Requires-Dist: jentic-openapi-common~=1.0.0a22
-Requires-Dist: jentic-openapi-datamodels~=1.0.0a22
+Requires-Dist: jentic-openapi-common~=1.0.0a23
+Requires-Dist: jentic-openapi-datamodels~=1.0.0a23
 Requires-Dist: pyyaml~=6.0.3
 Requires-Dist: requests~=2.32.5
 Requires-Dist: ruamel-yaml~=0.18.15
@@ -337,24 +337,34 @@ Low-level OpenAPI data model parser that automatically detects the OpenAPI versi
 
 ```python
 from jentic.apitools.openapi.parser.core import OpenAPIParser
+from jentic.apitools.openapi.parser.backends.datamodel_low import DataModelLow
 from jentic.apitools.openapi.datamodels.low.v30.openapi import OpenAPI30
 from jentic.apitools.openapi.datamodels.low.v31.openapi import OpenAPI31
 
+
 parser = OpenAPIParser("datamodel-low")
 
 # Parse OpenAPI 3.0.x document
-doc = parser.parse("file:///path/to/openapi-3.0.yaml")
+doc = parser.parse("file:///path/to/openapi-3.0.yaml", return_type=OpenAPI30)
 assert isinstance(doc, OpenAPI30)
 print(doc.openapi.value)  # "3.0.4"
 print(doc.info.value.title.value)  # Access with source tracking
 
 # Parse OpenAPI 3.1.x document
-doc = parser.parse("file:///path/to/openapi-3.1.yaml")
+doc = parser.parse("file:///path/to/openapi-3.1.yaml", return_type=OpenAPI31)
 assert isinstance(doc, OpenAPI31)
 print(doc.openapi.value)  # "3.1.2"
 
 # Access fields with source information
 print(f"Title at line {doc.info.key_node.start_mark.line}")
+
+doc = parser.parse("file:///path/to/openapi.yaml", return_type=DataModelLow)
+# Type checker sees 'Any', runtime type will be one of: OpenAPI30, OpenAPI31, or ValueSource
+print(type(doc).__name__)  # "OpenAPI30" or "OpenAPI31"
+
+# Optional: Enable strict runtime validation
+doc = parser.parse("file:///path/to/openapi.yaml", return_type=DataModelLow, strict=True)
+# Raises TypeConversionError if result is not one of the union types
 ```
 
 **Features:**

{jentic_openapi_parser-1.0.0a22 → jentic_openapi_parser-1.0.0a23}/README.md

@@ -318,24 +318,34 @@ Low-level OpenAPI data model parser that automatically detects the OpenAPI versi
 
 ```python
 from jentic.apitools.openapi.parser.core import OpenAPIParser
+from jentic.apitools.openapi.parser.backends.datamodel_low import DataModelLow
 from jentic.apitools.openapi.datamodels.low.v30.openapi import OpenAPI30
 from jentic.apitools.openapi.datamodels.low.v31.openapi import OpenAPI31
 
+
 parser = OpenAPIParser("datamodel-low")
 
 # Parse OpenAPI 3.0.x document
-doc = parser.parse("file:///path/to/openapi-3.0.yaml")
+doc = parser.parse("file:///path/to/openapi-3.0.yaml", return_type=OpenAPI30)
 assert isinstance(doc, OpenAPI30)
 print(doc.openapi.value)  # "3.0.4"
 print(doc.info.value.title.value)  # Access with source tracking
 
 # Parse OpenAPI 3.1.x document
-doc = parser.parse("file:///path/to/openapi-3.1.yaml")
+doc = parser.parse("file:///path/to/openapi-3.1.yaml", return_type=OpenAPI31)
 assert isinstance(doc, OpenAPI31)
 print(doc.openapi.value)  # "3.1.2"
 
 # Access fields with source information
 print(f"Title at line {doc.info.key_node.start_mark.line}")
+
+doc = parser.parse("file:///path/to/openapi.yaml", return_type=DataModelLow)
+# Type checker sees 'Any', runtime type will be one of: OpenAPI30, OpenAPI31, or ValueSource
+print(type(doc).__name__)  # "OpenAPI30" or "OpenAPI31"
+
+# Optional: Enable strict runtime validation
+doc = parser.parse("file:///path/to/openapi.yaml", return_type=DataModelLow, strict=True)
+# Raises TypeConversionError if result is not one of the union types
 ```
 
 **Features:**

{jentic_openapi_parser-1.0.0a22 → jentic_openapi_parser-1.0.0a23}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "jentic-openapi-parser"
-version = "1.0.0-alpha.22"
+version = "1.0.0-alpha.23"
 description = "Jentic OpenAPI Parser"
 readme = "README.md"
 authors = [{ name = "Jentic", email = "hello@jentic.com" }]
@@ -9,8 +9,8 @@ license-files = ["LICENSE", "NOTICE"]
 requires-python = ">=3.11"
 dependencies = [
     "attrs~=25.4.0",
-    "jentic-openapi-common~=1.0.0-alpha.22",
-    "jentic-openapi-datamodels~=1.0.0-alpha.22",
+    "jentic-openapi-common~=1.0.0-alpha.23",
+    "jentic-openapi-datamodels~=1.0.0-alpha.23",
     "pyyaml~=6.0.3",
     "requests~=2.32.5",
     "ruamel-yaml~=0.18.15"

{jentic_openapi_parser-1.0.0a22 → jentic_openapi_parser-1.0.0a23}/src/jentic/apitools/openapi/parser/core/openapi_parser.py

@@ -1,5 +1,6 @@
 import importlib.metadata
 import logging
+import types
 import warnings
 from typing import Any, Mapping, Optional, Sequence, Type, TypeVar, cast, overload
 
@@ -106,8 +107,17 @@ class OpenAPIParser:
     @overload
     def parse(self, document: str, *, return_type: type[T], strict: bool = False) -> T: ...
 
+    @overload
+    def parse(
+        self, document: str, *, return_type: types.UnionType, strict: bool = False
+    ) -> Any: ...
+
     def parse(
-        self, document: str, *, return_type: type[T] | None = None, strict: bool = False
+        self,
+        document: str,
+        *,
+        return_type: type[T] | types.UnionType | None = None,
+        strict: bool = False,
     ) -> Any:
         try:
             raw = self._parse(document)
@@ -119,6 +129,17 @@ class OpenAPIParser:
         if return_type is None:
             return self._to_plain(raw)
 
+        # Handle union types
+        if isinstance(return_type, types.UnionType):
+            if strict:
+                # Python 3.11+ supports isinstance with UnionType directly
+                if not isinstance(raw, return_type):
+                    type_names = " | ".join(t.__name__ for t in return_type.__args__)
+                    self.logger.error(f"Expected {type_names}, got {type(raw).__name__}")
+                    raise TypeConversionError(f"Expected {type_names}, got {type(raw).__name__}")
+            return raw
+
+        # Handle concrete types
         if strict:
             if not isinstance(raw, return_type):
                 msg = f"Expected {getattr(return_type, '__name__', return_type)}, got {type(raw).__name__}"