jentic-openapi-traverse 1.0.0a24__tar.gz → 1.0.0a25__tar.gz

{jentic_openapi_traverse-1.0.0a24 → jentic_openapi_traverse-1.0.0a25}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: jentic-openapi-traverse
-Version: 1.0.0a24
+Version: 1.0.0a25
 Summary: Jentic OpenAPI Traversal Utilities
 Author: Jentic
 Author-email: Jentic <hello@jentic.com>
 License-Expression: Apache-2.0
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: jentic-openapi-datamodels~=1.0.0a24
+Requires-Dist: jentic-openapi-datamodels~=1.0.0a25
 Requires-Dist: jsonpointer~=3.0.0
 Requires-Python: >=3.11
 Project-URL: Homepage, https://github.com/jentic/jentic-openapi-tools

{jentic_openapi_traverse-1.0.0a24 → jentic_openapi_traverse-1.0.0a25}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "jentic-openapi-traverse"
-version = "1.0.0-alpha.24"
+version = "1.0.0-alpha.25"
 description = "Jentic OpenAPI Traversal Utilities"
 readme = "README.md"
 authors = [{ name = "Jentic", email = "hello@jentic.com" }]
@@ -8,7 +8,7 @@ license = "Apache-2.0"
 license-files = ["LICENSE", "NOTICE"]
 requires-python = ">=3.11"
 dependencies = [
-    "jentic-openapi-datamodels~=1.0.0-alpha.24",
+    "jentic-openapi-datamodels~=1.0.0-alpha.25",
     "jsonpointer~=3.0.0"
 ]
 

{jentic_openapi_traverse-1.0.0a24 → jentic_openapi_traverse-1.0.0a25}/src/jentic/apitools/openapi/traverse/datamodels/low/introspection.py

@@ -15,9 +15,33 @@ __all__ = [
     "get_traversable_fields",
     "unwrap_value",
     "is_datamodel_node",
+    "get_yaml_field_name",
 ]
 
 
+def get_yaml_field_name(node_class: type, python_field_name: str) -> str:
+    """
+    Convert Python field name to YAML field name using metadata.
+
+    Args:
+        node_class: Datamodel class type
+        python_field_name: Python attribute name (e.g., "external_docs")
+
+    Returns:
+        YAML field name from metadata, or python_field_name if not found
+        (e.g., "externalDocs")
+    """
+    fixed = fixed_fields(node_class)
+    patterned = patterned_fields(node_class)
+
+    # Try fixed fields first, then patterned
+    field_obj = fixed.get(python_field_name) or patterned.get(python_field_name)
+    if field_obj:
+        return field_obj.metadata.get("yaml_name", python_field_name)
+
+    return python_field_name
+
+
 # Cache of field names to check per class type
 # {Info: ["title", "description", "contact", ...], Operation: [...], ...}
 _FIELD_NAMES_CACHE: dict[type, list[str]] = {}

{jentic_openapi_traverse-1.0.0a24 → jentic_openapi_traverse-1.0.0a25}/src/jentic/apitools/openapi/traverse/datamodels/low/path.py

@@ -5,6 +5,8 @@ from typing import Any, Literal
 
 from jsonpointer import JsonPointer
 
+from .introspection import get_yaml_field_name
+
 
 __all__ = ["NodePath"]
 
@@ -129,7 +131,10 @@ class NodePath:
             if current.parent_key is not None:
                 segments.append(current.parent_key)
             if current.parent_field:
-                segments.append(current.parent_field)
+                # Convert Python field name to YAML name for output
+                parent_class = type(current.parent_path.node)
+                yaml_name = get_yaml_field_name(parent_class, current.parent_field)
+                segments.append(yaml_name)
             current = current.parent_path
 
         segments.reverse()  # Root to leaf order