feat: v0.4.0 - Architecture refactor, bug fixes, and quality improvementsfeat/architecture-and-quality-improvements

- Fixed #25: config_file_save/load now include path: [] in payload
- Added exception hierarchy (SDKError, HttpError, ApiError, ValidationError)
- Added utility functions (json, ids, paths)
- Added structured logging with request ID tracking
- Added optional Pydantic validation models
- Refactored to pyvyos.core.* structure with backward compatibility shims
- Moved JSON specs to docs/development/vyos_api/
- Added comprehensive test suite (19 shim tests, 16 utils tests, 6 exception tests)
- Updated pyproject.toml for uv sync editable installation
- Added development documentation (architecture, roadmap, quality guidelines)

Maintains 100% backward compatibility with 0.3.0

1 files changed, 30 insertions, 0 deletions

diff --git a/pyvyos/utils/paths.py b/pyvyos/utils/paths.py
new file mode 100644
index 0000000..b591b09
--- /dev/null
+++ b/pyvyos/utils/paths.py
@@ -0,0 +1,30 @@
+"""Path building utilities for VyOS configuration paths."""
+
+from typing import List, Union
+
+
+def build_path(*segments: Union[str, List[str]]) -> List[str]:
+    """
+    Build a configuration path from segments.
+    
+    Args:
+        *segments: Path segments (strings or lists of strings)
+    
+    Returns:
+        Flattened list of path segments
+    
+    Examples:
+        build_path("interfaces", "ethernet", "eth0") 
+        -> ["interfaces", "ethernet", "eth0"]
+        
+        build_path(["interfaces", "ethernet"], "address", "192.168.1.1/24")
+        -> ["interfaces", "ethernet", "address", "192.168.1.1/24"]
+    """
+    result = []
+    for segment in segments:
+        if isinstance(segment, list):
+            result.extend(segment)
+        else:
+            result.append(str(segment))
+    return result
+