jentic-openapi-parser 1.0.0a21__py3-none-any.whl → 1.0.0a23__py3-none-any.whl

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__}"

{jentic_openapi_parser-1.0.0a21.dist-info → jentic_openapi_parser-1.0.0a23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jentic-openapi-parser
-Version: 1.0.0a21
+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.0a21
-Requires-Dist: jentic-openapi-datamodels~=1.0.0a21
+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.0a21.dist-info → jentic_openapi_parser-1.0.0a23.dist-info}/RECORD

@@ -8,12 +8,12 @@ jentic/apitools/openapi/parser/backends/ruamel_safe.py,sha256=9WNBgcU9wotBWIYOgA
 jentic/apitools/openapi/parser/core/__init__.py,sha256=FChrSb22a7m9LOku4KG0_Vsm4ConyEAlrFW3qLXjMAY,578
 jentic/apitools/openapi/parser/core/exceptions.py,sha256=wtH_kRvn3b3TsM4HEkTKLCdIQVEfsN-dEct8oVlnGrM,693
 jentic/apitools/openapi/parser/core/loader.py,sha256=Q57UiWiJACeuxMdroHAAEcoU-lwvxiRBcdz106N2VVQ,1462
-jentic/apitools/openapi/parser/core/openapi_parser.py,sha256=GCFEZZ6g4CrqJauz7AilEAxT-v31D8TP6zsIms9jLl8,7551
+jentic/apitools/openapi/parser/core/openapi_parser.py,sha256=ACoiv4bTYhmZQizkzhkMTKbkE0iMBg-dGmaPj9oGbJg,8309
 jentic/apitools/openapi/parser/core/py.typed,sha256=uEf7mrkecd7wYBi4Jxa95cHb65ZSz_tMK6UDi55KymA,33
 jentic/apitools/openapi/parser/core/serialization.py,sha256=qr9CBgZzb9GKRPTwOb_MmS0-GdHpVZLmXiHiX1n1cIM,2810
-jentic_openapi_parser-1.0.0a21.dist-info/licenses/LICENSE,sha256=WNHhf_5RCaeuKWyq_K39vmp9F28LxKsB4SpomwSZ2L0,11357
-jentic_openapi_parser-1.0.0a21.dist-info/licenses/NOTICE,sha256=pAOGW-rGw9KNc2cuuLWZkfx0GSTV4TicbgBKZSLPMIs,168
-jentic_openapi_parser-1.0.0a21.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-jentic_openapi_parser-1.0.0a21.dist-info/entry_points.txt,sha256=eMCrbxAvCRJRKUU4ZwsD-soLKoDomhzrJ19ayMyeXNo,497
-jentic_openapi_parser-1.0.0a21.dist-info/METADATA,sha256=wdF9u8LKJvZ1rsVgkbJWeJXtG4escW6bprhlmupT3-M,11772
-jentic_openapi_parser-1.0.0a21.dist-info/RECORD,,
+jentic_openapi_parser-1.0.0a23.dist-info/licenses/LICENSE,sha256=WNHhf_5RCaeuKWyq_K39vmp9F28LxKsB4SpomwSZ2L0,11357
+jentic_openapi_parser-1.0.0a23.dist-info/licenses/NOTICE,sha256=pAOGW-rGw9KNc2cuuLWZkfx0GSTV4TicbgBKZSLPMIs,168
+jentic_openapi_parser-1.0.0a23.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+jentic_openapi_parser-1.0.0a23.dist-info/entry_points.txt,sha256=eMCrbxAvCRJRKUU4ZwsD-soLKoDomhzrJ19ayMyeXNo,497
+jentic_openapi_parser-1.0.0a23.dist-info/METADATA,sha256=2T-h8lJuzA8MLbC_DNBz7pbbpo40Rb5E4Ne3IKd6csQ,12330
+jentic_openapi_parser-1.0.0a23.dist-info/RECORD,,