jentic-openapi-datamodels 1.0.0a20__py3-none-any.whl → 1.0.0a21__py3-none-any.whl

{jentic_openapi_datamodels-1.0.0a20.dist-info → jentic_openapi_datamodels-1.0.0a21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jentic-openapi-datamodels
-Version: 1.0.0a20
+Version: 1.0.0a21
 Summary: Jentic OpenAPI Data Models
 Author: Jentic
 Author-email: Jentic <hello@jentic.com>
@@ -61,9 +61,64 @@ pip install jentic-openapi-datamodels
 
 ## Quick Start
 
-### Parsing OpenAPI 3.0 Documents
+### Parsing with the `datamodel-low` Parser Backend (Recommended)
 
-The main use case is parsing complete OpenAPI Documents:
+The easiest way to parse OpenAPI documents into datamodels is using the `datamodel-low` backend from `jentic-openapi-parser`. This backend automatically detects the OpenAPI version and returns the appropriate typed datamodel:
+
+```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
+
+# Create parser with datamodel-low backend
+parser = OpenAPIParser("datamodel-low")
+
+# Parse OpenAPI 3.0 document - automatically returns OpenAPI30
+doc = parser.parse("""
+openapi: 3.0.4
+info:
+  title: Pet Store API
+  version: 1.0.0
+paths:
+  /pets:
+    get:
+      summary: List all pets
+      responses:
+        '200':
+          description: A list of pets
+""", return_type=DataModelLow)
+
+assert isinstance(doc, OpenAPI30)
+print(doc.openapi.value)  # "3.0.4"
+print(doc.info.value.title.value)  # "Pet Store API"
+
+# Parse OpenAPI 3.1 document - automatically returns OpenAPI31
+doc = parser.parse("""
+openapi: 3.1.2
+info:
+  title: Pet Store API
+  version: 1.0.0
+paths: {}
+""", return_type=DataModelLow)
+
+assert isinstance(doc, OpenAPI31)
+print(doc.openapi.value)  # "3.1.2"
+```
+
+**Benefits of `datamodel-low` backend:**
+- Automatic version detection (no manual version checking)
+- Returns strongly-typed `OpenAPI30` or `OpenAPI31` objects
+- Complete source tracking preserved
+- Single-step parsing (no need to manually call `build()`)
+
+### Manual Parsing with Builder Functions
+
+For advanced use cases or custom workflows, you can manually parse and build datamodels:
+
+#### Parsing OpenAPI 3.0 Documents
+
+The manual approach uses the `ruamel-ast` backend followed by calling the builder function:
 
 ```python
 from jentic.apitools.openapi.parser.core import OpenAPIParser
@@ -102,7 +157,7 @@ for path_key, path_item in openapi_doc.paths.value.path_items.items():
         print(f"  Summary: {operation.summary.value}")  # "List all pets"
 ```
 
-### Parsing OpenAPI 3.1 Documents with JSON Schema 2020-12
+#### Parsing OpenAPI 3.1 Documents with JSON Schema 2020-12
 
 OpenAPI 3.1 fully supports JSON Schema 2020-12, including advanced features like boolean schemas, conditional validation and vocabulary declarations:
 

{jentic_openapi_datamodels-1.0.0a20.dist-info → jentic_openapi_datamodels-1.0.0a21.dist-info}/RECORD

@@ -68,8 +68,8 @@ jentic/apitools/openapi/datamodels/low/v31/server.py,sha256=IA-dDnhqdD6WCZ_bjdGw
 jentic/apitools/openapi/datamodels/low/v31/server_variable.py,sha256=UfGDky_NVUF_WQc5ZIU947MjmpxaO__VIv6sq8HMsk0,2762
 jentic/apitools/openapi/datamodels/low/v31/tag.py,sha256=8-QfVk4dUp3r-LbseMSvlCcAWeZkzlhZP3giVKNgaPI,2359
 jentic/apitools/openapi/datamodels/low/v31/xml.py,sha256=SFLNLrhiZRWVH_CBV8SqtO4C4qjDjGtqz_lYpp84BnE,1930
-jentic_openapi_datamodels-1.0.0a20.dist-info/licenses/LICENSE,sha256=WNHhf_5RCaeuKWyq_K39vmp9F28LxKsB4SpomwSZ2L0,11357
-jentic_openapi_datamodels-1.0.0a20.dist-info/licenses/NOTICE,sha256=pAOGW-rGw9KNc2cuuLWZkfx0GSTV4TicbgBKZSLPMIs,168
-jentic_openapi_datamodels-1.0.0a20.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-jentic_openapi_datamodels-1.0.0a20.dist-info/METADATA,sha256=7Q28pNaN1yY8_95wbff-bV1izBBWiitL5HZNLAMq3ME,12466
-jentic_openapi_datamodels-1.0.0a20.dist-info/RECORD,,
+jentic_openapi_datamodels-1.0.0a21.dist-info/licenses/LICENSE,sha256=WNHhf_5RCaeuKWyq_K39vmp9F28LxKsB4SpomwSZ2L0,11357
+jentic_openapi_datamodels-1.0.0a21.dist-info/licenses/NOTICE,sha256=pAOGW-rGw9KNc2cuuLWZkfx0GSTV4TicbgBKZSLPMIs,168
+jentic_openapi_datamodels-1.0.0a21.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+jentic_openapi_datamodels-1.0.0a21.dist-info/METADATA,sha256=DNCYjrFBmVPrNG-8RRf8IrC8yEkyGZeJRd6tF3JNv4Q,14260
+jentic_openapi_datamodels-1.0.0a21.dist-info/RECORD,,