jentic-openapi-traverse 1.0.0a29__tar.gz → 1.0.0a31__tar.gz

{jentic_openapi_traverse-1.0.0a29 → jentic_openapi_traverse-1.0.0a31}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: jentic-openapi-traverse
-Version: 1.0.0a29
+Version: 1.0.0a31
 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.0a29
+Requires-Dist: jentic-openapi-datamodels~=1.0.0a31
 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.0a29 → jentic_openapi_traverse-1.0.0a31}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "jentic-openapi-traverse"
-version = "1.0.0-alpha.29"
+version = "1.0.0-alpha.31"
 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.29",
+    "jentic-openapi-datamodels~=1.0.0-alpha.31",
     "jsonpointer~=3.0.0"
 ]
 

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

@@ -118,43 +118,62 @@ class NodePath:
             "$['paths']['/users/{id}']['parameters'][0]"
             "$['components']['schemas']['User']['properties']['name']"
         """
+        parts = self.to_parts()
+
         # Root node
-        if self.parent_path is None:
+        if not parts:
             return "$" if path_format == "jsonpath" else ""
 
-        # Walk back collecting all segments
-        segments: list[str | int] = []
-        current = self
-        while current.parent_path is not None:
-            # Add in reverse order (key first, then field) because we'll reverse the list
-            # This ensures field comes before key in the final path
-            if current.parent_key is not None:
-                segments.append(current.parent_key)
-            if 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
-
         if path_format == "jsonpath":
             # RFC 9535 Normalized JSONPath: $['field'][index]['key']
             result = ["$"]
-            for segment in segments:
-                if isinstance(segment, int):
+            for part in parts:
+                if isinstance(part, int):
                     # Array index: $[0]
-                    result.append(f"[{segment}]")
+                    result.append(f"[{part}]")
                 else:
                     # Member name: $['field']
                     # Escape single quotes in the string
-                    escaped = str(segment).replace("'", "\\'")
+                    escaped = str(part).replace("'", "\\'")
                     result.append(f"['{escaped}']")
             return "".join(result)
 
         # RFC 6901 JSON Pointer
-        return JsonPointer.from_parts(segments).path
+        return JsonPointer.from_parts(parts).path
+
+    def to_parts(self) -> list[str | int]:
+        """
+        Return path as a list of path parts (field names, keys, and array indices).
+
+        Can be used with JsonPointer.from_parts() for conversion.
+
+        Returns:
+            List of path parts from root to this node.
+            Empty list for root node.
+
+        Examples:
+            [] (root)
+            ["info"]
+            ["paths", "/users", "get"]
+            ["paths", "/users", "get", "parameters", 0]
+            ["components", "schemas", "User", "properties", "name"]
+        """
+        if self.parent_path is None:
+            return []
+
+        parts: list[str | int] = []
+        current = self
+        while current.parent_path is not None:
+            if current.parent_key is not None:
+                parts.append(current.parent_key)
+            if current.parent_field:
+                parent_class = type(current.parent_path.node)
+                yaml_name = get_yaml_field_name(parent_class, current.parent_field)
+                parts.append(yaml_name)
+            current = current.parent_path
+
+        parts.reverse()
+        return parts
 
     def get_root(self) -> Any:
         """