audiometa-python 0.9.0__tar.gz → 0.10.0__tar.gz

{audiometa_python-0.9.0/audiometa_python.egg-info → audiometa_python-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audiometa-python
-Version: 0.9.0
+Version: 0.10.0
 Summary: A comprehensive Python library for reading and writing audio metadata across multiple formats
 Author: AudioMeta Python Contributors
 Author-email: Andreas Garcia <garcia.andreas.1991@gmail.com>

{audiometa_python-0.9.0 → audiometa_python-0.10.0}/audiometa/cli.py

@@ -94,6 +94,8 @@ def format_as_table(data: dict[str, Any]) -> str:
             "replaygain",
             "archival_location",
             "isrc",
+            "description",
+            "originator",
         }
         if unified_keys.intersection(set(data.keys())):
             # This is a unified metadata dict, wrap it
@@ -188,6 +190,8 @@ def _write_metadata(args: argparse.Namespace) -> None:
         metadata[UnifiedMetadataKey.COMMENT] = args.comment
     if args.description and args.description.strip():
         metadata[UnifiedMetadataKey.DESCRIPTION] = args.description
+    if args.originator and args.originator.strip():
+        metadata[UnifiedMetadataKey.ORIGINATOR] = args.originator
     if args.replaygain and args.replaygain.strip():
         metadata[UnifiedMetadataKey.REPLAYGAIN] = args.replaygain
     if args.archival_location and args.archival_location.strip():
@@ -432,6 +436,7 @@ Examples:
     write_parser.add_argument("--lyrics", help="Unsynchronized lyrics text")
     write_parser.add_argument("--comment", help="Comment")
     write_parser.add_argument("--description", help="Description")
+    write_parser.add_argument("--originator", help="Originator")
     write_parser.add_argument("--replaygain", help="ReplayGain information")
     write_parser.add_argument("--archival-location", help="Archival location")
     write_parser.add_argument("--isrc", help="International Standard Recording Code (12 characters)")

{audiometa_python-0.9.0 → audiometa_python-0.10.0}/audiometa/manager/_rating_supporting/riff/_RiffManager.py

@@ -15,7 +15,13 @@ from ....utils.rating_profiles import RatingWriteProfile
 from ....utils.types import RawMetadataDict, RawMetadataKey, UnifiedMetadata, UnifiedMetadataValue
 from ....utils.unified_metadata_key import UnifiedMetadataKey
 from .._RatingSupportingMetadataManager import _RatingSupportingMetadataManager
-from ._riff_bext_chunk import extract_bext_chunk, find_bext_chunk, find_fmt_chunk, update_bext_description_in_riff_data
+from ._riff_bext_chunk import (
+    extract_bext_chunk,
+    find_bext_chunk,
+    find_fmt_chunk,
+    update_bext_description_in_riff_data,
+    update_bext_originator_in_riff_data,
+)
 from ._riff_constants import (
     RIFF_AUDIO_FORMAT_IEEE_FLOAT,
     RIFF_FORMAT_CHUNK_MIN_SIZE,
@@ -139,6 +145,7 @@ class _RiffManager(_RatingSupportingMetadataManager):
             UnifiedMetadataKey.TRACK_NUMBER: self.RiffTagKey.TRACK_NUMBER,
             UnifiedMetadataKey.ISRC: self.RiffTagKey.ISRC,
             UnifiedMetadataKey.DESCRIPTION: None,
+            UnifiedMetadataKey.ORIGINATOR: None,
         }
         metadata_keys_direct_map_write: dict[UnifiedMetadataKey, RawMetadataKey | None] = {
             UnifiedMetadataKey.TITLE: self.RiffTagKey.TITLE,
@@ -157,6 +164,7 @@ class _RiffManager(_RatingSupportingMetadataManager):
             UnifiedMetadataKey.TRACK_NUMBER: self.RiffTagKey.TRACK_NUMBER,
             UnifiedMetadataKey.ISRC: self.RiffTagKey.ISRC,
             UnifiedMetadataKey.DESCRIPTION: None,
+            UnifiedMetadataKey.ORIGINATOR: None,
         }
         super().__init__(
             audio_file=audio_file,
@@ -280,6 +288,17 @@ class _RiffManager(_RatingSupportingMetadataManager):
             except Exception:
                 pass
             return None
+        if unified_metadata_key == UnifiedMetadataKey.ORIGINATOR:
+            # Read from bext chunk
+            try:
+                self.audio_file.seek(0)
+                file_data = self.audio_file.read()
+                bext_data = self._extract_bext_chunk(file_data)
+                if bext_data and "Originator" in bext_data:
+                    return cast(str, bext_data["Originator"])
+            except Exception:
+                pass
+            return None
         msg = f"Metadata key not handled: {unified_metadata_key}"
         raise MetadataFieldNotSupportedByMetadataFormatError(msg)
 
@@ -459,6 +478,9 @@ class _RiffManager(_RatingSupportingMetadataManager):
         if UnifiedMetadataKey.DESCRIPTION in merged_metadata:
             description_value = merged_metadata[UnifiedMetadataKey.DESCRIPTION]
             update_bext_description_in_riff_data(riff_data, cast(str | None, description_value))
+        if UnifiedMetadataKey.ORIGINATOR in merged_metadata:
+            originator_value = merged_metadata[UnifiedMetadataKey.ORIGINATOR]
+            update_bext_originator_in_riff_data(riff_data, cast(str | None, originator_value))
 
     def _update_riff_chunk_size(self, riff_data: bytearray) -> None:
         """Update RIFF chunk size in RIFF data.

{audiometa_python-0.9.0 → audiometa_python-0.10.0}/audiometa/manager/_rating_supporting/riff/_riff_bext_chunk.py

@@ -210,25 +210,33 @@ def extract_bext_chunk(file_data: bytes, skip_id3v2_tags_func: Callable[[bytes],
     return None
 
 
-def update_bext_description_in_riff_data(riff_data: bytearray, value: str | None) -> None:
-    """Update the Description field in the bext chunk within RIFF data.
+def _update_bext_field_in_riff_data(
+    riff_data: bytearray, value: str | None, field_size: int, field_offset: int
+) -> None:
+    """Update a field in the bext chunk within RIFF data.
 
     This function modifies the riff_data bytearray in-place to update or create
-    the bext chunk with the Description field. This is integrated into the main
+    the bext chunk with the specified field. This is integrated into the main
     update flow to avoid multiple file writes.
 
     Args:
         riff_data: RIFF data bytearray (modified in-place)
-        value: Description value to write, or None/empty string to clear
+        value: Field value to write, or None/empty string to clear
+        field_size: Size of the field in bytes
+        field_offset: Offset of the field within the bext chunk
     """
-    encoded = b"\x00" * 256 if value is None or value == "" else value.encode("utf-8")[:255].ljust(256, b"\x00")
+    encoded = (
+        b"\x00" * field_size
+        if value is None or value == ""
+        else value.encode("utf-8")[: field_size - 1].ljust(field_size, b"\x00")
+    )
 
     # Find bext chunk in RIFF data (no ID3v2 tags in riff_data at this point)
     pos = find_bext_chunk_in_riff_data(riff_data)
     if pos != -1:
-        # Update existing bext chunk Description field
+        # Update existing bext chunk field
         bext_start = pos + 8
-        riff_data[bext_start : bext_start + 256] = encoded
+        riff_data[bext_start + field_offset : bext_start + field_offset + field_size] = encoded
     else:
         # No bext chunk, create one
         fmt_pos = find_fmt_chunk_in_riff_data(riff_data)
@@ -237,12 +245,24 @@ def update_bext_description_in_riff_data(riff_data: bytearray, value: str | None
         fmt_size = int.from_bytes(bytes(riff_data[fmt_pos + 4 : fmt_pos + 8]), "little")
         insert_pos = fmt_pos + 8 + fmt_size
         # Create bext chunk data: 602 bytes v1
-        bext_data = b"bext" + (602).to_bytes(4, "little") + encoded + b"\x00" * 346
+        # Fill with zeros, then set the specific field
+        bext_data = bytearray(b"bext" + (602).to_bytes(4, "little") + b"\x00" * 602)
+        bext_data[8 + field_offset : 8 + field_offset + field_size] = encoded
         # Insert bext chunk after fmt chunk
         riff_data[insert_pos:insert_pos] = bext_data
         # Note: RIFF chunk size will be updated by caller after this method
 
 
+def update_bext_description_in_riff_data(riff_data: bytearray, value: str | None) -> None:
+    """Update the Description field in the bext chunk within RIFF data."""
+    _update_bext_field_in_riff_data(riff_data, value, 256, 0)
+
+
+def update_bext_originator_in_riff_data(riff_data: bytearray, value: str | None) -> None:
+    """Update the Originator field in the bext chunk within RIFF data."""
+    _update_bext_field_in_riff_data(riff_data, value, 32, 256)
+
+
 def find_bext_chunk_in_riff_data(riff_data: bytearray) -> int:
     """Find the position of the bext chunk in RIFF data.
 

{audiometa_python-0.9.0 → audiometa_python-0.10.0}/audiometa/test/helpers/riff/riff_metadata_setter.py

@@ -35,6 +35,7 @@ class RIFFMetadataSetter:
             "copyright": "--ICOP",
             "isrc": "--ISRC",
             "description": "--Description",
+            "originator": "--Originator",
         }
 
         # Handle list values - include first value in main command to avoid overwriting

{audiometa_python-0.9.0 → audiometa_python-0.10.0}/audiometa/test/tests/e2e/cli/read/test_comprehensive.py

@@ -129,6 +129,7 @@ class TestCLIReadComprehensive:
                 "copyright": "© WAV",
                 "comment": "WAV comment",
                 "description": "WAV description",
+                "originator": "WAV originator",
                 "isrc": "GBUM71505078",
             },
             "wav",
@@ -155,6 +156,7 @@ class TestCLIReadComprehensive:
             assert unified.get(UnifiedMetadataKey.COPYRIGHT) == "© WAV"
             assert unified.get(UnifiedMetadataKey.COMMENT) == "WAV comment"
             assert unified.get(UnifiedMetadataKey.DESCRIPTION) == "WAV description"
+            assert unified.get(UnifiedMetadataKey.ORIGINATOR) == "WAV originator"
             assert unified.get(UnifiedMetadataKey.ISRC) == "GBUM71505078"
 
     def test_cli_read_comprehensive_roundtrip(self):

{audiometa_python-0.9.0 → audiometa_python-0.10.0}/audiometa/test/tests/e2e/cli/write/test_comprehensive.py

@@ -191,6 +191,8 @@ class TestCLIWriteComprehensive:
                     "WAV comment",
                     "--description",
                     "WAV description",
+                    "--originator",
+                    "WAV originator",
                     "--isrc",
                     "GBUM71505078",
                 ],
@@ -213,4 +215,5 @@ class TestCLIWriteComprehensive:
             assert metadata.get(UnifiedMetadataKey.COPYRIGHT) == "© WAV"
             assert metadata.get(UnifiedMetadataKey.COMMENT) == "WAV comment"
             assert metadata.get(UnifiedMetadataKey.DESCRIPTION) == "WAV description"
+            assert metadata.get(UnifiedMetadataKey.ORIGINATOR) == "WAV originator"
             assert metadata.get(UnifiedMetadataKey.ISRC) == "GBUM71505078"

audiometa_python-0.10.0/audiometa/test/tests/integration/metadata_field/originator/test_deleting.py

@@ -0,0 +1,50 @@
+import pytest
+
+from audiometa import get_unified_metadata_field, update_metadata
+from audiometa.exceptions import MetadataFieldNotSupportedByMetadataFormatError
+from audiometa.test.helpers.riff import RIFFMetadataSetter
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestOriginatorDeleting:
+    def test_delete_originator_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            RIFFMetadataSetter.set_metadata(test_file, {"originator": "Test originator"})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR) == "Test originator"
+
+            update_metadata(test_file, {UnifiedMetadataKey.ORIGINATOR: None}, metadata_format=MetadataFormat.RIFF)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR) is None
+
+    def test_delete_originator_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            RIFFMetadataSetter.set_metadata(test_file, {"originator": "Test originator", "title": "Test Title"})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR) == "Test originator"
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) == "Test Title"
+
+            update_metadata(test_file, {UnifiedMetadataKey.ORIGINATOR: None}, metadata_format=MetadataFormat.RIFF)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR) is None
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) == "Test Title"
+
+    def test_delete_originator_vorbis_raises(self):
+        with (
+            temp_file_with_metadata({}, "flac") as test_file,
+            pytest.raises(MetadataFieldNotSupportedByMetadataFormatError),
+        ):
+            update_metadata(test_file, {UnifiedMetadataKey.ORIGINATOR: None}, metadata_format=MetadataFormat.VORBIS)
+
+    def test_delete_originator_id3v1_raises(self):
+        with (
+            temp_file_with_metadata({}, "id3v1") as test_file,
+            pytest.raises(MetadataFieldNotSupportedByMetadataFormatError),
+        ):
+            update_metadata(test_file, {UnifiedMetadataKey.ORIGINATOR: None}, metadata_format=MetadataFormat.ID3V1)
+
+    def test_delete_originator_id3v2_raises(self):
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(MetadataFieldNotSupportedByMetadataFormatError),
+        ):
+            update_metadata(test_file, {UnifiedMetadataKey.ORIGINATOR: None}, metadata_format=MetadataFormat.ID3V2)

audiometa_python-0.10.0/audiometa/test/tests/integration/metadata_field/originator/test_reading.py

@@ -0,0 +1,37 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.exceptions import MetadataFieldNotSupportedByMetadataFormatError
+from audiometa.test.helpers.riff import RIFFMetadataSetter
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestOriginatorReading:
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "wav") as test_file:
+            RIFFMetadataSetter.set_metadata(test_file, {"originator": "Test Originator RIFF"})
+            originator = get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR)
+            assert originator == "Test Originator RIFF"
+
+    def test_vorbis(self):
+        with (
+            temp_file_with_metadata({"title": "Test Song"}, "flac") as test_file,
+            pytest.raises(MetadataFieldNotSupportedByMetadataFormatError),
+        ):
+            get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR)
+
+    def test_id3v1(self):
+        with (
+            temp_file_with_metadata({"title": "Test Song"}, "id3v1") as test_file,
+            pytest.raises(MetadataFieldNotSupportedByMetadataFormatError),
+        ):
+            get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR)
+
+    def test_id3v2(self):
+        with (
+            temp_file_with_metadata({"title": "Test Song"}, "mp3") as test_file,
+            pytest.raises(MetadataFieldNotSupportedByMetadataFormatError),
+        ):
+            get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR)

audiometa_python-0.10.0/audiometa/test/tests/integration/metadata_field/originator/test_writing.py

@@ -0,0 +1,60 @@
+import pytest
+
+from audiometa import get_unified_metadata_field, update_metadata
+from audiometa.exceptions import MetadataFieldNotSupportedByMetadataFormatError
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestOriginatorWriting:
+    def test_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            test_originator = "Test Originator RIFF"
+            test_metadata = {UnifiedMetadataKey.ORIGINATOR: test_originator}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            originator = get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR)
+            assert originator == test_originator
+
+    def test_riff_empty(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            test_metadata = {UnifiedMetadataKey.ORIGINATOR: ""}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            originator = get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR)
+            assert originator is None
+
+    def test_riff_long_originator_truncated(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            long_originator = "A" * 50  # Over 32 bytes
+            test_metadata = {UnifiedMetadataKey.ORIGINATOR: long_originator}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            originator = get_unified_metadata_field(test_file, UnifiedMetadataKey.ORIGINATOR)
+            assert originator is not None
+            assert len(originator.encode("utf-8")) <= 32
+
+    def test_vorbis_raises(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            test_metadata = {UnifiedMetadataKey.ORIGINATOR: "Test Originator"}
+            with pytest.raises(MetadataFieldNotSupportedByMetadataFormatError):
+                update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.VORBIS)
+
+    def test_id3v1_raises(self):
+        with temp_file_with_metadata({}, "id3v1") as test_file:
+            test_metadata = {UnifiedMetadataKey.ORIGINATOR: "Test Originator"}
+            with pytest.raises(MetadataFieldNotSupportedByMetadataFormatError):
+                update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V1)
+
+    def test_id3v2_raises(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_metadata = {UnifiedMetadataKey.ORIGINATOR: "Test Originator"}
+            with pytest.raises(MetadataFieldNotSupportedByMetadataFormatError):
+                update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V2)
+
+    def test_invalid_type_raises(self):
+        from audiometa.exceptions import InvalidMetadataFieldTypeError
+
+        with temp_file_with_metadata({}, "wav") as test_file:
+            bad_metadata = {UnifiedMetadataKey.ORIGINATOR: 12345}
+            with pytest.raises(InvalidMetadataFieldTypeError):
+                update_metadata(test_file, bad_metadata)

{audiometa_python-0.9.0 → audiometa_python-0.10.0}/audiometa/utils/unified_metadata_key.py

@@ -32,6 +32,7 @@ class UnifiedMetadataKey(str, Enum):
     ARCHIVAL_LOCATION = "archival_location"
     ISRC = "isrc"
     DESCRIPTION = "description"
+    ORIGINATOR = "originator"
 
     def can_semantically_have_multiple_values(self) -> bool:
         """Check if the metadata key can semantically have multiple values.
@@ -81,6 +82,7 @@ class UnifiedMetadataKey(str, Enum):
             UnifiedMetadataKey.ARCHIVAL_LOCATION: str,
             UnifiedMetadataKey.ISRC: str,
             UnifiedMetadataKey.DESCRIPTION: str,
+            UnifiedMetadataKey.ORIGINATOR: str,
         }
         result_type = app_metadata_keys_optional_types_map.get(self)
         if not result_type:

{audiometa_python-0.9.0 → audiometa_python-0.10.0/audiometa_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audiometa-python
-Version: 0.9.0
+Version: 0.10.0
 Summary: A comprehensive Python library for reading and writing audio metadata across multiple formats
 Author: AudioMeta Python Contributors
 Author-email: Andreas Garcia <garcia.andreas.1991@gmail.com>

{audiometa_python-0.9.0 → audiometa_python-0.10.0}/audiometa_python.egg-info/SOURCES.txt

@@ -202,6 +202,10 @@ audiometa/test/tests/integration/metadata_field/lyrics/__init__.py
 audiometa/test/tests/integration/metadata_field/lyrics/test_deleting.py
 audiometa/test/tests/integration/metadata_field/lyrics/test_reading.py
 audiometa/test/tests/integration/metadata_field/lyrics/test_writing.py
+audiometa/test/tests/integration/metadata_field/originator/__init__.py
+audiometa/test/tests/integration/metadata_field/originator/test_deleting.py
+audiometa/test/tests/integration/metadata_field/originator/test_reading.py
+audiometa/test/tests/integration/metadata_field/originator/test_writing.py
 audiometa/test/tests/integration/metadata_field/publisher/__init__.py
 audiometa/test/tests/integration/metadata_field/publisher/test_deleting.py
 audiometa/test/tests/integration/metadata_field/publisher/test_reading.py

{audiometa_python-0.9.0 → audiometa_python-0.10.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "audiometa-python"
-version = "0.9.0"
+version = "0.10.0"
 description = "A comprehensive Python library for reading and writing audio metadata across multiple formats"
 readme = "README.md"
 requires-python = ">=3.12"