audiometa-python 0.6.0__py3-none-any.whl

audiometa/test/tests/integration/audio_format/mp3/test_mp3_writing.py

@@ -0,0 +1,60 @@
+import pytest
+
+from audiometa import get_unified_metadata, update_metadata
+from audiometa.exceptions import MetadataFormatNotSupportedByAudioFormatError
+from audiometa.test.helpers.id3v2.id3v2_metadata_getter import ID3v2MetadataGetter
+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 TestMp3Writing:
+    def test_writing_default_format_mp3(self):
+        with temp_file_with_metadata({}, "mp3") as temp_mp3_file_path:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title Default"}
+            update_metadata(temp_mp3_file_path, metadata)
+
+            id3v2_title = ID3v2MetadataGetter.get_title(temp_mp3_file_path)
+            assert id3v2_title == "Test Title Default"
+
+    def test_id3v1_metadata_writing_mp3(self):
+        with temp_file_with_metadata({}, "mp3") as temp_audio_file_path:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title ID3v1"}
+            update_metadata(temp_audio_file_path, metadata, metadata_format=MetadataFormat.ID3V1)
+            read_metadata = get_unified_metadata(temp_audio_file_path, metadata_format=MetadataFormat.ID3V1)
+            assert read_metadata[UnifiedMetadataKey.TITLE] == "Test Title ID3v1"
+
+    def test_id3v2_3_metadata_writing_mp3(self):
+        with temp_file_with_metadata({}, "id3v2.3") as test_file:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title ID3v2.3"}
+            update_metadata(test_file, metadata, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 3, 0))
+            read_metadata = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert read_metadata[UnifiedMetadataKey.TITLE] == "Test Title ID3v2.3"
+
+    def test_id3v2_4_metadata_writing_mp3(self):
+        with temp_file_with_metadata({}, "id3v2.4") as test_file:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title ID3v2.4"}
+            update_metadata(test_file, metadata, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 4, 0))
+            read_metadata = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert read_metadata[UnifiedMetadataKey.TITLE] == "Test Title ID3v2.4"
+
+    def test_riff_metadata_writing_mp3(self):
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            update_metadata(
+                test_file, {UnifiedMetadataKey.TITLE: "Test Title RIFF"}, metadata_format=MetadataFormat.RIFF
+            )
+
+    def test_vorbis_metadata_writing_mp3(self):
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            update_metadata(
+                test_file,
+                {UnifiedMetadataKey.TITLE: "Test Title Vorbis"},
+                metadata_format=MetadataFormat.VORBIS,
+            )

audiometa/test/tests/integration/audio_format/wav/test_wav_delete_all.py

@@ -0,0 +1,87 @@
+import pytest
+
+from audiometa import delete_all_metadata, get_unified_metadata
+from audiometa.exceptions import MetadataFormatNotSupportedByAudioFormatError
+from audiometa.test.helpers.id3v1 import ID3v1MetadataSetter
+from audiometa.test.helpers.id3v2 import ID3v2MetadataSetter
+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 TestDeleteAllMetadataFormatSpecificWAV:
+    def test_delete_all_metadata_formats_wav(self):
+        with temp_file_with_metadata({"title": "ID3v1 Title", "artist": "ID3v1 Artist"}, "id3v1") as test_file:
+            # Verify ID3v1 has metadata before adding ID3v2
+            id3v1_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_before.get(UnifiedMetadataKey.TITLE) == "ID3v1 Title"
+
+            # Add ID3v2 metadata using external tools for proper test isolation
+            ID3v2MetadataSetter.set_metadata(test_file, {"title": "ID3v2 Title", "artist": "ID3V2 Artist"})
+
+            # Verify ID3v2 has metadata
+            id3v2_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_before.get(UnifiedMetadataKey.TITLE) == "ID3v2 Title"
+
+            # Delete all metadata
+            result = delete_all_metadata(test_file)
+            assert result is True
+
+            # Verify both formats were deleted
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test RIFF Title", "artist": "Test RIFF Artist"}, "wav") as test_file:
+            # Verify RIFF metadata is set
+            riff_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.RIFF)
+            assert riff_before.get(UnifiedMetadataKey.TITLE) == "Test RIFF Title"
+
+            result = delete_all_metadata(test_file, metadata_format=MetadataFormat.RIFF)
+            assert result is True
+
+            # Verify RIFF metadata is deleted
+            riff_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.RIFF)
+            assert riff_after.get(UnifiedMetadataKey.TITLE) is None
+
+    def test_id3v2(self):
+        with temp_file_with_metadata({"title": "Test RIFF Title", "artist": "Test RIFF Artist"}, "wav") as test_file:
+            # Add ID3V2 metadata
+            ID3v2MetadataSetter.set_metadata(test_file, {"title": "ID3V2 Title", "artist": "ID3V2 Artist"})
+
+            # Verify ID3V2 metadata is set
+            id3v2_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_before.get(UnifiedMetadataKey.TITLE) == "ID3V2 Title"
+
+            result = delete_all_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert result is True
+
+            # Verify ID3V2 metadata is deleted
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+
+    def test_id3v1(self):
+        with temp_file_with_metadata({"title": "Test RIFF Title", "artist": "Test RIFF Artist"}, "wav") as test_file:
+            # Add ID3V1 metadata
+            ID3v1MetadataSetter.set_metadata(test_file, {"title": "ID3V1 Title", "artist": "ID3V1 Artist"})
+
+            # Verify ID3V1 metadata is set
+            id3v1_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_before.get(UnifiedMetadataKey.TITLE) == "ID3V1 Title"
+
+            result = delete_all_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert result is True
+
+            # Verify ID3V1 metadata is deleted
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+
+    def test_vorbis(self):
+        with (
+            temp_file_with_metadata({"title": "Test RIFF Title", "artist": "Test RIFF Artist"}, "wav") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            delete_all_metadata(test_file, metadata_format=MetadataFormat.VORBIS)

audiometa/test/tests/integration/audio_format/wav/test_wav_reading_all.py

@@ -0,0 +1,62 @@
+import pytest
+
+from audiometa import get_unified_metadata
+from audiometa.exceptions import MetadataFormatNotSupportedByAudioFormatError
+from audiometa.test.helpers.id3v1.id3v1_metadata_getter import ID3v1MetadataGetter
+from audiometa.test.helpers.id3v1.id3v1_metadata_setter import ID3v1MetadataSetter
+from audiometa.test.helpers.id3v2.id3v2_metadata_setter import ID3v2MetadataSetter
+from audiometa.test.helpers.riff.riff_metadata_setter 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 TestWavReading:
+    def test_all_metadata_reading_wav(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            ID3v1MetadataSetter.set_metadata(test_file, {"title": "a" * 30})
+            assert ID3v1MetadataGetter.get_title(test_file) == "a" * 30
+
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.TITLE) == "a" * 30
+
+    def test_id3v2_3_metadata_reading_wav(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            ID3v2MetadataSetter.set_metadata(
+                test_file, {"title": "ID3v2.3 Long Title That Exceeds ID3v1 Limits"}, version="2.3"
+            )
+
+            metadata = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 3, 0))
+            assert metadata.get(UnifiedMetadataKey.TITLE) == "ID3v2.3 Long Title That Exceeds ID3v1 Limits"
+
+    def test_id3v2_4_metadata_reading_wav(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            ID3v2MetadataSetter.set_metadata(
+                test_file, {"title": "ID3v2.4 Long Title That Exceeds ID3v1 Limits"}, version="2.4"
+            )
+
+            metadata = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 4, 0))
+            assert metadata.get(UnifiedMetadataKey.TITLE) == "ID3v2.4 Long Title That Exceeds ID3v1 Limits"
+
+    def test_id3v1_metadata_reading_wav(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            ID3v1MetadataSetter.set_metadata(test_file, {"title": "a" * 30})
+            assert ID3v1MetadataGetter.get_title(test_file) == "a" * 30
+
+            metadata = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert metadata.get(UnifiedMetadataKey.TITLE) == "a" * 30
+
+    def test_riff_metadata_reading_wav(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            RIFFMetadataSetter.set_title(test_file, "a" * 30)
+
+            metadata = get_unified_metadata(test_file, metadata_format=MetadataFormat.RIFF)
+            assert metadata.get(UnifiedMetadataKey.TITLE) == "a" * 30
+
+    def test_vorbis_metadata_reading_wav(self):
+        with (
+            temp_file_with_metadata({}, "wav") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)

audiometa/test/tests/integration/audio_format/wav/test_wav_reading_field.py

@@ -0,0 +1,57 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.exceptions import MetadataFormatNotSupportedByAudioFormatError
+from audiometa.test.helpers.id3v1.id3v1_metadata_setter import ID3v1MetadataSetter
+from audiometa.test.helpers.id3v2.id3v2_header_verifier import ID3v2HeaderVerifier
+from audiometa.test.helpers.id3v2.id3v2_metadata_setter import ID3v2MetadataSetter
+from audiometa.test.helpers.riff.riff_metadata_setter 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 TestWavReading:
+    def test_all_metadata_format_reading_wav(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            ID3v1MetadataSetter.set_metadata(test_file, {"title": "Title ID3v1"})
+
+            title = get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE)
+            assert title == "Title ID3v1"
+
+    def test_riff_metadata_reading_wav(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            RIFFMetadataSetter.set_title(test_file, "RIFF Small Title")
+
+            title = get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.RIFF)
+            assert title == "RIFF Small Title"
+
+    def test_id3v2_3_metadata_reading_wav(self):
+        with temp_file_with_metadata({}, "id3v2.3") as test_file:
+            ID3v2MetadataSetter.set_title(test_file, "ID3v2.3 Long Title That Exceeds RIFF Limits", version="2.3")
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 3, 0)
+
+            title = get_unified_metadata_field(
+                test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 3, 0)
+            )
+            assert title == "ID3v2.3 Long Title That Exceeds RIFF Limits"
+
+    def test_id3v2_4_metadata_reading_wav(self):
+        with temp_file_with_metadata({}, "id3v2.4") as test_file:
+            ID3v2MetadataSetter.set_metadata(test_file, {"title": "ID3v2.4 Long Title That Exceeds RIFF Limits"})
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 4, 0)
+
+            title = get_unified_metadata_field(
+                test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 4, 0)
+            )
+            assert title == "ID3v2.4 Long Title That Exceeds RIFF Limits"
+
+    def test_vorbis_metadata_reading_wav(self):
+        with (
+            temp_file_with_metadata({}, "wav") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.VORBIS)

audiometa/test/tests/integration/audio_format/wav/test_wav_with_id3v2_tags.py

@@ -0,0 +1,83 @@
+import pytest
+
+from audiometa import get_unified_metadata, update_metadata
+from audiometa.test.helpers.id3v2.id3v2_metadata_getter import ID3v2MetadataGetter
+from audiometa.test.helpers.riff.riff_metadata_getter import RIFFMetadataGetter
+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 TestWavWithId3v2Tags:
+    """Test WAV files that have ID3v2 tags, which are placed at the beginning of the file."""
+
+    def test_wav_with_id3v2_tags_audiofile_instantiation(self):
+        # Create a WAV file and add ID3v2 metadata (which places ID3v2 tags at the start)
+        with temp_file_with_metadata({}, "wav") as test_file:
+            # Write ID3v2 metadata to create the problematic file structure
+            id3v2_metadata = {UnifiedMetadataKey.TITLE: "ID3v2 Title"}
+            update_metadata(test_file, id3v2_metadata, metadata_format=MetadataFormat.ID3V2)
+
+            # The key test: _AudioFile instantiation should not fail
+            from audiometa._audio_file import _AudioFile
+
+            audio_file = _AudioFile(test_file)  # Should not raise FileCorruptedError
+
+            # Verify the file is properly recognized as a WAV
+            assert audio_file.file_extension == ".wav"
+            assert audio_file.get_audio_format_name() == "WAV"
+
+    def test_wav_with_id3v2_tags_validation_and_reading(self):
+        # Create a WAV file with some initial RIFF metadata
+        with temp_file_with_metadata(
+            {"title": "Original RIFF Title", "artist": "Original RIFF Artist"}, "wav"
+        ) as test_file:
+            # Verify initial RIFF metadata
+            initial_metadata = get_unified_metadata(test_file)
+            assert initial_metadata.get(UnifiedMetadataKey.TITLE) == "Original RIFF Title"
+            assert initial_metadata.get(UnifiedMetadataKey.ARTISTS) == ["Original RIFF Artist"]
+
+            # Now write metadata using SYNC strategy (writes to all formats including ID3v2)
+            # This will add ID3v2 tags at the beginning of the file while preserving RIFF
+            sync_metadata = {
+                UnifiedMetadataKey.TITLE: "Sync Title",
+                UnifiedMetadataKey.ARTISTS: ["Sync Artist"],
+                UnifiedMetadataKey.ALBUM: "Sync Album",
+            }
+            update_metadata(test_file, sync_metadata)
+
+            # Verify that the file can still be validated (_AudioFile creation doesn't fail)
+            # and that metadata can be read
+            final_metadata = get_unified_metadata(test_file)
+            assert final_metadata.get(UnifiedMetadataKey.TITLE) == "Sync Title"
+            assert final_metadata.get(UnifiedMetadataKey.ARTISTS) == ["Sync Artist"]
+            assert final_metadata.get(UnifiedMetadataKey.ALBUM) == "Sync Album"
+
+            # Verify both ID3v2 and RIFF metadata exist
+            id3v2_title = ID3v2MetadataGetter.get_title(test_file)
+            riff_title = RIFFMetadataGetter.get_title(test_file)
+            assert id3v2_title == "Sync Title"
+            assert riff_title == "Sync Title"
+
+    def test_wav_sync_strategy_with_id3v2_and_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            # Use SYNC strategy (default) to write to all supported formats
+            sync_metadata = {
+                UnifiedMetadataKey.TITLE: "Sync Title",
+                UnifiedMetadataKey.ARTISTS: ["Sync Artist"],
+                UnifiedMetadataKey.ALBUM: "Sync Album",
+            }
+            update_metadata(test_file, sync_metadata)
+
+            # File should be valid and readable
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.TITLE) == "Sync Title"
+            assert metadata.get(UnifiedMetadataKey.ARTISTS) == ["Sync Artist"]
+            assert metadata.get(UnifiedMetadataKey.ALBUM) == "Sync Album"
+
+            # Both formats should have the metadata
+            id3v2_title = ID3v2MetadataGetter.get_title(test_file)
+            riff_title = RIFFMetadataGetter.get_title(test_file)
+            assert id3v2_title == "Sync Title"
+            assert riff_title == "Sync Title"

audiometa/test/tests/integration/audio_format/wav/test_wav_writing.py

@@ -0,0 +1,62 @@
+import pytest
+
+from audiometa import update_metadata
+from audiometa.exceptions import MetadataFormatNotSupportedByAudioFormatError
+from audiometa.test.helpers.id3v2.id3v2_header_verifier import ID3v2HeaderVerifier
+from audiometa.test.helpers.id3v2.id3v2_metadata_getter import ID3v2MetadataGetter
+from audiometa.test.helpers.riff.riff_metadata_getter import RIFFMetadataGetter
+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 TestWavWriting:
+    def test_writing_default_format_wav(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title Default"}
+            update_metadata(test_file, metadata)
+
+            title = RIFFMetadataGetter.get_title(test_file)
+            assert title == "Test Title Default"
+
+    def test_riff_metadata_writing_wav(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title RIFF"}
+            update_metadata(test_file, metadata, metadata_format=MetadataFormat.RIFF)
+
+            title = RIFFMetadataGetter.get_title(test_file)
+            assert title == "Test Title RIFF"
+
+    def test_id3v2_3_metadata_writing_wav(self):
+        with temp_file_with_metadata({}, "id3v2.3") as test_file:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title ID3v2.3"}
+            update_metadata(
+                test_file, unified_metadata=metadata, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 3, 0)
+            )
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 3, 0)
+
+            title = ID3v2MetadataGetter.get_title(test_file)
+            assert title == "Test Title ID3v2.3"
+
+    def test_id3v2_4_metadata_writing_wav(self):
+        with temp_file_with_metadata({}, "id3v2.4") as test_file:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title ID3v2.4"}
+            update_metadata(test_file, metadata, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 4, 0))
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 4, 0)
+
+            title = ID3v2MetadataGetter.get_title(test_file)
+            assert title == "Test Title ID3v2.4"
+
+    def test_vorbis_metadata_writing_wav(self):
+        with (
+            temp_file_with_metadata({}, "wav") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            update_metadata(
+                test_file,
+                {UnifiedMetadataKey.TITLE: "Test Title Vorbis"},
+                metadata_format=MetadataFormat.VORBIS,
+            )

audiometa/test/tests/integration/conftest.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+import pytest
+
+
+# Test tracks with rating
+@pytest.fixture
+def rating_id3v2_base_100_0_star_wav(assets_dir: Path) -> Path:
+    return assets_dir / "rating_id3v2_base 100=0 star.wav"
+
+
+@pytest.fixture
+def rating_id3v2_base_100_5_star_wav(assets_dir: Path) -> Path:
+    return assets_dir / "rating_id3v2_base 100=5 star.wav"
+
+
+@pytest.fixture
+def rating_id3v2_base_255_5_star_mp3(assets_dir: Path) -> Path:
+    return assets_dir / "rating_id3v2_base 255_kid3=5 star.mp3"
+
+
+@pytest.fixture
+def rating_riff_base_100_5_star_wav(assets_dir: Path) -> Path:
+    return assets_dir / "rating_riff_base 100_kid3=5 star.wav"
+
+
+@pytest.fixture
+def rating_vorbis_base_100_5_star_flac(assets_dir: Path) -> Path:
+    return assets_dir / "rating_vorbis=5 star.flac"

audiometa/test/tests/integration/delete_all_metadata/__init__.py

@@ -0,0 +1 @@
+"""Tests for delete_all_metadata functionality."""

audiometa/test/tests/integration/delete_all_metadata/test_audio_format_all.py

@@ -0,0 +1,102 @@
+import pytest
+
+from audiometa import delete_all_metadata, get_unified_metadata
+from audiometa.test.helpers.id3v2 import ID3v2MetadataSetter
+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 TestDeleteAllMetadataAllFormats:
+    def test_delete_all_metadata_formats_mp3(self):
+        with temp_file_with_metadata({"title": "ID3v1 Title", "artist": "ID3v1 Artist"}, "id3v1") as test_file:
+            # Verify ID3v1 has metadata before adding ID3v2
+            id3v1_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_before.get(UnifiedMetadataKey.TITLE) == "ID3v1 Title"
+
+            # Add ID3v2 metadata using external tools for proper test isolation
+            ID3v2MetadataSetter.set_metadata(test_file, {"title": "ID3v2 Title", "artist": "ID3v2 Artist"})
+
+            # Verify ID3v2 has metadata
+            id3v2_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_before.get(UnifiedMetadataKey.TITLE) == "ID3v2 Title"
+
+            # Delete all metadata
+            result = delete_all_metadata(test_file)
+            assert result is True
+
+            # Verify both formats were deleted
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+
+    def test_delete_all_metadata_formats_flac(self):
+        with temp_file_with_metadata({"title": "ID3v1 Title", "artist": "ID3v1 Artist"}, "id3v1") as test_file:
+            # Verify ID3v1 has metadata before adding ID3v2
+            id3v1_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_before.get(UnifiedMetadataKey.TITLE) == "ID3v1 Title"
+
+            # Add ID3v2 metadata using external tools for proper test isolation
+            ID3v2MetadataSetter.set_metadata(test_file, {"title": "ID3v2 Title", "artist": "ID3v2 Artist"})
+
+            # Verify ID3v2 has metadata
+            id3v2_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_before.get(UnifiedMetadataKey.TITLE) == "ID3v2 Title"
+
+            # Delete all metadata
+            result = delete_all_metadata(test_file)
+            assert result is True
+
+            # Verify both formats were deleted
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+
+    def test_delete_all_metadata_formats_wav(self):
+        with temp_file_with_metadata({"title": "ID3v1 Title", "artist": "ID3v1 Artist"}, "id3v1") as test_file:
+            # Verify ID3v1 has metadata before adding ID3v2
+            id3v1_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_before.get(UnifiedMetadataKey.TITLE) == "ID3v1 Title"
+
+            # Add ID3v2 metadata using external tools for proper test isolation
+            ID3v2MetadataSetter.set_metadata(test_file, {"title": "ID3v2 Title", "artist": "ID3v2 Artist"})
+
+            # Verify ID3v2 has metadata
+            id3v2_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_before.get(UnifiedMetadataKey.TITLE) == "ID3v2 Title"
+
+            # Delete all metadata
+            result = delete_all_metadata(test_file)
+            assert result is True
+
+            # Verify both formats were deleted
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+
+    def test_delete_all_metadata_removes_all_formats(self):
+        with temp_file_with_metadata({"title": "ID3v1 Title", "artist": "ID3v1 Artist"}, "id3v1") as test_file:
+            # Verify ID3v1 has metadata before adding ID3v2
+            id3v1_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_before.get(UnifiedMetadataKey.TITLE) == "ID3v1 Title"
+
+            # Add ID3v2 metadata using external tools for proper test isolation
+            ID3v2MetadataSetter.set_metadata(test_file, {"title": "ID3v2 Title", "artist": "ID3v2 Artist"})
+
+            # Verify ID3v2 has metadata
+            id3v2_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_before.get(UnifiedMetadataKey.TITLE) == "ID3v2 Title"
+
+            # Delete all metadata
+            result = delete_all_metadata(test_file)
+            assert result is True
+
+            # Verify both formats were deleted
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None

audiometa/test/tests/integration/delete_all_metadata/test_audio_format_header_deletion.py

@@ -0,0 +1,77 @@
+import pytest
+
+from audiometa import delete_all_metadata, update_metadata
+from audiometa.test.helpers.id3v1.id3v1_header_verifier import ID3v1HeaderVerifier
+from audiometa.test.helpers.id3v2.id3v2_header_verifier import ID3v2HeaderVerifier
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.test.helpers.vorbis.vorbis_header_verifier import VorbisHeaderVerifier
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestAudioFormatHeaderDeletion:
+    def test_header_detection_flac(self):
+        with temp_file_with_metadata({"title": "FLAC Test"}, "flac") as flac_file:
+            vorbis_metadata = {UnifiedMetadataKey.TITLE: "FLAC Vorbis Title"}
+            update_metadata(flac_file, vorbis_metadata, metadata_format=MetadataFormat.VORBIS)
+
+            id3v2_metadata = {UnifiedMetadataKey.ARTISTS: ["FLAC ID3v2 Artist"]}
+            update_metadata(flac_file, id3v2_metadata, metadata_format=MetadataFormat.ID3V2)
+
+            id3v1_metadata = {UnifiedMetadataKey.ALBUM: "FLAC ID3v1 Album"}
+            update_metadata(flac_file, id3v1_metadata, metadata_format=MetadataFormat.ID3V1)
+
+            assert VorbisHeaderVerifier.has_vorbis_comments(flac_file)
+            assert ID3v1HeaderVerifier.has_id3v1_header(flac_file)
+            assert ID3v2HeaderVerifier.has_id3v2_header(flac_file)
+
+            # Test header removal
+            result = delete_all_metadata(flac_file)
+            assert result is True
+
+            # After deletion, headers should be removed
+            assert not VorbisHeaderVerifier.has_vorbis_comments(flac_file)
+            assert not ID3v1HeaderVerifier.has_id3v1_header(flac_file)
+            assert not ID3v2HeaderVerifier.has_id3v2_header(flac_file)
+
+    def test_header_detection_wav(self):
+        with temp_file_with_metadata({"title": "WAV Test"}, "wav") as wav_file:
+            riff_metadata = {UnifiedMetadataKey.TITLE: "WAV RIFF Title"}
+            update_metadata(wav_file, riff_metadata, metadata_format=MetadataFormat.RIFF)
+
+            id3v2_metadata = {UnifiedMetadataKey.ARTISTS: ["WAV ID3v2 Artist"]}
+            update_metadata(wav_file, id3v2_metadata, metadata_format=MetadataFormat.ID3V2)
+
+            id3v1_metadata = {UnifiedMetadataKey.ALBUM: "WAV ID3v1 Album"}
+            update_metadata(wav_file, id3v1_metadata, metadata_format=MetadataFormat.ID3V1)
+
+            assert ID3v1HeaderVerifier.has_id3v1_header(wav_file)
+            assert ID3v2HeaderVerifier.has_id3v2_header(wav_file)
+
+            # Test header removal
+            result = delete_all_metadata(wav_file)
+            assert result is True
+
+            # After deletion, headers should be removed
+            assert not ID3v1HeaderVerifier.has_id3v1_header(wav_file)
+            assert not ID3v2HeaderVerifier.has_id3v2_header(wav_file)
+
+    def test_header_detection_mp3(self):
+        with temp_file_with_metadata({"title": "MP3 Test"}, "mp3") as mp3_file:
+            id3v2_metadata = {UnifiedMetadataKey.TITLE: "MP3 ID3v2 Title"}
+            update_metadata(mp3_file, id3v2_metadata, metadata_format=MetadataFormat.ID3V2)
+
+            id3v1_metadata = {UnifiedMetadataKey.ALBUM: "MP3 ID3v1 Album"}
+            update_metadata(mp3_file, id3v1_metadata, metadata_format=MetadataFormat.ID3V1)
+
+            assert ID3v1HeaderVerifier.has_id3v1_header(mp3_file)
+            assert ID3v2HeaderVerifier.has_id3v2_header(mp3_file)
+
+            # Test header removal
+            result = delete_all_metadata(mp3_file)
+            assert result is True
+
+            # After deletion, headers should be removed
+            assert not ID3v1HeaderVerifier.has_id3v1_header(mp3_file)
+            assert not ID3v2HeaderVerifier.has_id3v2_header(mp3_file)