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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jentic-openapi-datamodels
-Version: 1.0.0a19
+Version: 1.0.0a20
 Summary: Jentic OpenAPI Data Models
 Author: Jentic
 Author-email: Jentic <hello@jentic.com>
@@ -66,12 +66,13 @@ pip install jentic-openapi-datamodels
 The main use case is parsing complete OpenAPI Documents:
 
 ```python
-from ruamel.yaml import YAML
+from jentic.apitools.openapi.parser.core import OpenAPIParser
+from jentic.apitools.openapi.parser.backends.ruamel_ast import MappingNode
 from jentic.apitools.openapi.datamodels.low.v30 import build
 
 # Parse OpenAPI document
-yaml = YAML()
-root = yaml.compose("""
+parser = OpenAPIParser("ruamel-ast")
+root = parser.parse("""
 openapi: 3.0.4
 info:
   title: Pet Store API
@@ -83,7 +84,7 @@ paths:
       responses:
         '200':
           description: A list of pets
-""")
+""", return_type=MappingNode)
 
 # Build OpenAPI document model
 openapi_doc = build(root)
@@ -106,12 +107,13 @@ for path_key, path_item in openapi_doc.paths.value.path_items.items():
 OpenAPI 3.1 fully supports JSON Schema 2020-12, including advanced features like boolean schemas, conditional validation and vocabulary declarations:
 
 ```python
-from ruamel.yaml import YAML
+from jentic.apitools.openapi.parser.core import OpenAPIParser
+from jentic.apitools.openapi.parser.backends.ruamel_ast import MappingNode
 from jentic.apitools.openapi.datamodels.low.v31 import build
 
 # Parse OpenAPI 3.1 document with JSON Schema 2020-12 features
-yaml = YAML()
-root = yaml.compose("""
+parser = OpenAPIParser("ruamel-ast")
+root = parser.parse("""
 openapi: 3.1.2
 info:
   title: Pet Store API
@@ -133,7 +135,7 @@ paths:
                 contains:
                   type: object
                   required: [id]
-""")
+""", return_type=MappingNode)
 
 openapi_doc = build(root)
 
@@ -149,16 +151,17 @@ print(schema.contains.value.required.value[0].value)  # "id"
 You can also parse individual OpenAPI specification objects:
 
 ```python
-from ruamel.yaml import YAML
+from jentic.apitools.openapi.parser.core import OpenAPIParser
+from jentic.apitools.openapi.parser.backends.ruamel_ast import MappingNode
 from jentic.apitools.openapi.datamodels.low.v30.security_scheme import build as build_security_scheme
 
 # Parse a Security Scheme object
-yaml = YAML()
-root = yaml.compose("""
+parser = OpenAPIParser("ruamel-ast")
+root = parser.parse("""
 type: http
 scheme: bearer
 bearerFormat: JWT
-""")
+""", return_type=MappingNode)
 
 security_scheme = build_security_scheme(root)
 
@@ -173,12 +176,13 @@ print(security_scheme.bearer_format.key_node.start_mark.line)  # Line number
 You can also parse OpenAPI 3.1 Schema objects with JSON Schema 2020-12 features:
 
 ```python
-from ruamel.yaml import YAML
+from jentic.apitools.openapi.parser.core import OpenAPIParser
+from jentic.apitools.openapi.parser.backends.ruamel_ast import MappingNode
 from jentic.apitools.openapi.datamodels.low.v31.schema import build as build_schema
 
 # Parse a Schema object with JSON Schema 2020-12 features
-yaml = YAML()
-root = yaml.compose("""
+parser = OpenAPIParser("ruamel-ast")
+root = parser.parse("""
 type: object
 properties:
   id:
@@ -199,7 +203,7 @@ if:
       const: true
 then:
   required: [support_tier]
-""")
+""", return_type=MappingNode)
 
 schema = build_schema(root)
 
@@ -255,18 +259,19 @@ The package provides three immutable wrapper types for preserving source informa
 - Example: Values in `Discriminator.mapping` are `ValueSource[str]`
 
 ```python
-from ruamel.yaml import YAML
+from jentic.apitools.openapi.parser.core import OpenAPIParser
+from jentic.apitools.openapi.parser.backends.ruamel_ast import MappingNode
 from jentic.apitools.openapi.datamodels.low.v30 import build
 
 # FieldSource: Fixed specification fields in OpenAPI document
-yaml = YAML()
-root = yaml.compose("""
+parser = OpenAPIParser("ruamel-ast")
+root = parser.parse("""
 openapi: 3.0.4
 info:
   title: Pet Store API
   version: 1.0.0
 paths: {}
-""")
+""", return_type=MappingNode)
 openapi_doc = build(root)
 
 field = openapi_doc.info.value.title  # FieldSource[str]
@@ -276,7 +281,7 @@ print(field.value_node)  # YAML node for "Pet Store API"
 
 # KeySource/ValueSource: Dictionary fields (extensions, mapping)
 # Extensions in OpenAPI objects use KeySource/ValueSource
-root = yaml.compose("""
+root = parser.parse("""
 openapi: 3.0.4
 info:
   title: API
@@ -284,7 +289,7 @@ info:
   x-custom: value
   x-another: data
 paths: {}
-""")
+""", return_type=MappingNode)
 openapi_doc = build(root)
 
 for key, value in openapi_doc.info.value.extensions.items():
@@ -299,7 +304,8 @@ for key, value in openapi_doc.info.value.extensions.items():
 Access precise location ranges within the source document using start_mark and end_mark:
 
 ```python
-from ruamel.yaml import YAML
+from jentic.apitools.openapi.parser.core import OpenAPIParser
+from jentic.apitools.openapi.parser.backends.ruamel_ast import MappingNode
 from jentic.apitools.openapi.datamodels.low.v30 import build
 
 yaml_content = """
@@ -311,8 +317,8 @@ info:
 paths: {}
 """
 
-yaml = YAML()
-root = yaml.compose(yaml_content)
+parser = OpenAPIParser("ruamel-ast")
+root = parser.parse(yaml_content, return_type=MappingNode)
 openapi_doc = build(root)
 
 # Access location information for any field
@@ -337,17 +343,18 @@ print(f"Field range: ({start.line}:{start.column}) to ({end.line}:{end.column})"
 Low-level models preserve invalid data without validation:
 
 ```python
-from ruamel.yaml import YAML
+from jentic.apitools.openapi.parser.core import OpenAPIParser
+from jentic.apitools.openapi.parser.backends.ruamel_ast import MappingNode
 from jentic.apitools.openapi.datamodels.low.v30 import build
 
-yaml = YAML()
-root = yaml.compose("""
+parser = OpenAPIParser("ruamel-ast")
+root = parser.parse("""
 openapi: 3.0.4
 info:
   title: 123  # Intentionally wrong type for demonstration (should be string)
   version: 1.0.0
 paths: {}
-""")
+""", return_type=MappingNode)
 
 openapi_doc = build(root)
 print(openapi_doc.info.value.title.value)  # 123 (preserved as-is)

{jentic_openapi_datamodels-1.0.0a19.dist-info → jentic_openapi_datamodels-1.0.0a20.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.0a19.dist-info/licenses/LICENSE,sha256=WNHhf_5RCaeuKWyq_K39vmp9F28LxKsB4SpomwSZ2L0,11357
-jentic_openapi_datamodels-1.0.0a19.dist-info/licenses/NOTICE,sha256=pAOGW-rGw9KNc2cuuLWZkfx0GSTV4TicbgBKZSLPMIs,168
-jentic_openapi_datamodels-1.0.0a19.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-jentic_openapi_datamodels-1.0.0a19.dist-info/METADATA,sha256=Thjm5eYidVkFu7DD0PQxAbnhmhhjv-JLhThd9tp4wsg,11349
-jentic_openapi_datamodels-1.0.0a19.dist-info/RECORD,,
+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,,