zs-yaml 0.8.2.dev1__tar.gz → 0.8.3.dev3__tar.gz

zs_yaml-0.8.3.dev3/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.8.2] - 2025-12-06
+
+### Added
+- `bin_to_dict` function to deserialize binary directly to dict
+
+## [0.8.1] - 2025-12-03
+
+### Added
+- Cache management: `YamlTransformer.clear_cache()` method for explicit cache invalidation
+
+### Changed
+- Performance: Skip transformation processing entirely when YAML contains no function invocations
+
+## [0.8.0] - 2025-07-03
+
+### Added
+- `pyobj_to_yaml` conversion function for dumping Python objects to YAML files
+- Dedicated exceptions and more informative error messages
+
+## [0.7.0] - 2024-12-09
+
+### Added
+- `py_eval` transformation function for generating node values via Python snippets
+- `extract_extern_as_yaml` supports compressed externals (gzip, zstd, lz4, brotli)
+- `extract_extern_as_yaml` supports generating YAMLs without null-value fields
+
+## [0.6.1] - 2024-12-04
+
+### Changed
+- Minimum zserio version updated to 2.15.0
+
+## [0.6.0] - 2024-11-08
+
+### Fixed
+- Crash that hid zserio exception messages in some cases
+
+## [0.5.0] - 2024-10-07
+
+### Added
+- `yaml_to_pyobj` conversion function (library API only)
+
+## [0.4.0] - 2024-08-10
+
+### Added
+- Initial release
+- YAML format support for zserio serialization
+- Automatic metadata inclusion in YAML
+- Bidirectional conversion between YAML, JSON, and binary formats
+- Template substitution for flexible YAML content generation
+- Built-in transformations: `insert_yaml_as_extern`, `insert_yaml`, `repeat_node`
+- Custom transformation hooks

{zs_yaml-0.8.2.dev1/zs_yaml.egg-info → zs_yaml-0.8.3.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zs-yaml
-Version: 0.8.2.dev1
+Version: 0.8.3.dev3
 Summary: YAML support for zserio
 Author-email: "Navigation Data Standard e.V." <support@nds-association.org>
 License-Expression: MIT

{zs_yaml-0.8.2.dev1 → zs_yaml-0.8.3.dev3}/zs_yaml/__init__.py

@@ -1,4 +1,4 @@
-from .convert import yaml_to_json, yaml_to_bin, bin_to_yaml, json_to_yaml
+from .convert import yaml_to_json, yaml_to_bin, bin_to_yaml, bin_to_dict, json_to_yaml
 from .yaml_transformer import YamlTransformer
 
 try:

{zs_yaml-0.8.2.dev1 → zs_yaml-0.8.3.dev3}/zs_yaml/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.8.2.dev1'
-__version_tuple__ = version_tuple = (0, 8, 2, 'dev1')
+__version__ = version = '0.8.3.dev3'
+__version_tuple__ = version_tuple = (0, 8, 3, 'dev3')
 
-__commit_id__ = commit_id = 'gc7f65daf1'
+__commit_id__ = commit_id = 'gc8ec0d36c'

{zs_yaml-0.8.2.dev1 → zs_yaml-0.8.3.dev3}/zs_yaml/convert.py

@@ -199,6 +199,58 @@ def json_to_yaml(json_input_path, yaml_output_path):
         yaml.safe_dump(data, yaml_file, default_flow_style=False, sort_keys=False)
 
 
+def bin_to_dict(bin_input, schema_module, schema_type, init_args=None):
+    """
+    Converts binary data to a Python dictionary using Zserio deserialization.
+
+    Args:
+        bin_input (str or bytes): Path to the input binary file, or binary data as bytes.
+        schema_module (str): The schema module name (e.g., 'ndslive.schema.smart.v2024_11.tile.api').
+        schema_type (str): The schema type name (e.g., 'SmartLayerTile').
+        init_args (list, optional): Initialization arguments for zserio deserialization.
+
+    Returns:
+        tuple: (data_dict, metadata_dict) where data_dict is the deserialized data
+               and metadata_dict contains schema_module and schema_type.
+
+    Raises:
+        TransformationError: If deserialization fails.
+    """
+    if init_args is None:
+        init_args = []
+
+    try:
+        module = importlib.import_module(schema_module)
+        ImportedType = getattr(module, schema_type)
+        if ImportedType is None:
+            raise ValueError(f"Type {schema_type} not found in module {schema_module}")
+
+        # Handle both file path and bytes input
+        if isinstance(bin_input, bytes):
+            zserio_object = zserio.deserialize_from_bytes(ImportedType, bin_input, *init_args)
+        else:
+            zserio_object = zserio.deserialize_from_file(ImportedType, bin_input, *init_args)
+
+        json_data = zserio.to_json_string(zserio_object)
+        data = json.loads(json_data)
+
+        metadata = {
+            'schema_module': schema_module,
+            'schema_type': schema_type
+        }
+        if init_args:
+            metadata['initialization_args'] = init_args
+
+        return data, metadata
+    except Exception as e:
+        file_info = bin_input if isinstance(bin_input, str) else "<bytes>"
+        raise TransformationError(
+            f"Failed to convert binary to dict: {e}",
+            file_path=file_info,
+            original_error=e
+        )
+
+
 def bin_to_yaml(bin_input_path, yaml_output_path):
     """
     Converts a binary file to a YAML file using Zserio deserialization.
@@ -223,15 +275,7 @@ def bin_to_yaml(bin_input_path, yaml_output_path):
         if not schema_module or not schema_type:
             raise ValueError("Error: schema_module and schema_type must be specified in the _meta section of the YAML file")
 
-        module = importlib.import_module(schema_module)
-        ImportedType = getattr(module, schema_type)
-        if ImportedType is None:
-            raise ValueError(f"Type {schema_type} not found in module {schema_module}")
-
-        zserio_object = zserio.deserialize_from_file(ImportedType, bin_input_path, *init_args)
-        json_data = zserio.to_json_string(zserio_object)
-
-        data = json.loads(json_data)
+        data, metadata = bin_to_dict(bin_input_path, schema_module, schema_type, init_args)
 
         # Create a new dictionary to ensure _meta comes first
         final_data = {'_meta': meta['_meta']}
@@ -239,6 +283,8 @@ def bin_to_yaml(bin_input_path, yaml_output_path):
 
         with open(yaml_output_path, 'w') as yaml_file:
             yaml.safe_dump(final_data, yaml_file, default_flow_style=False, sort_keys=False)
+    except TransformationError:
+        raise
     except Exception as e:
         raise TransformationError(
             f"Failed to convert binary to YAML: {e}",

{zs_yaml-0.8.2.dev1 → zs_yaml-0.8.3.dev3/zs_yaml.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zs-yaml
-Version: 0.8.2.dev1
+Version: 0.8.3.dev3
 Summary: YAML support for zserio
 Author-email: "Navigation Data Standard e.V." <support@nds-association.org>
 License-Expression: MIT

{zs_yaml-0.8.2.dev1 → zs_yaml-0.8.3.dev3}/zs_yaml.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 .gitignore
+CHANGELOG.md
 LICENSE
 README.md
 pyproject.toml