audiometa-python 0.2.2__py3-none-any.whl

audiometa/test/tests/e2e/workflows/test_rating_workflows.py

@@ -0,0 +1,124 @@
+"""End-to-end tests for rating normalization workflows.
+
+These tests verify that the system correctly handles different rating scales and normalization values across different
+audio formats.
+"""
+
+import pytest
+
+from audiometa import delete_all_metadata, get_unified_metadata, update_metadata
+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.e2e
+class TestRatingWorkflows:
+    def test_metadata_with_different_rating_normalizations(self):
+        # Use external script to set initial metadata
+        initial_metadata = {"title": "Initial Rating Test", "artist": "Initial Artist"}
+        with temp_file_with_metadata(initial_metadata, "mp3") as test_file:
+            # Test with 0-100 rating scale
+            test_metadata_100 = {UnifiedMetadataKey.TITLE: "Rating Test 100", UnifiedMetadataKey.RATING: 60}
+            update_metadata(
+                test_file, test_metadata_100, normalized_rating_max_value=100, metadata_format=MetadataFormat.ID3V2
+            )
+
+            metadata_100 = get_unified_metadata(test_file, normalized_rating_max_value=100)
+            assert metadata_100.get(UnifiedMetadataKey.TITLE) == "Rating Test 100"
+            assert metadata_100.get(UnifiedMetadataKey.RATING) == 60
+
+            # Test with 0-255 rating scale
+            test_metadata_255 = {
+                UnifiedMetadataKey.TITLE: "Rating Test 255",
+                UnifiedMetadataKey.RATING: 153,  # 60% of 255
+            }
+            update_metadata(
+                test_file, test_metadata_255, normalized_rating_max_value=255, metadata_format=MetadataFormat.ID3V2
+            )
+
+            metadata_255 = get_unified_metadata(test_file, normalized_rating_max_value=255)
+            assert metadata_255.get(UnifiedMetadataKey.TITLE) == "Rating Test 255"
+            assert metadata_255.get(UnifiedMetadataKey.RATING) == 153
+
+    def test_rating_deletion_workflow(self):
+        # E2E test for deleting ratings with different normalizations
+        initial_metadata = {"title": "Rating Deletion Test", "artist": "Rating Deletion Artist"}
+
+        with temp_file_with_metadata(initial_metadata, "mp3") as test_file:
+            # 1. Add rating with 100 scale
+            rating_metadata_100 = {UnifiedMetadataKey.RATING: 80}
+            update_metadata(
+                test_file,
+                rating_metadata_100,
+                normalized_rating_max_value=100,
+                metadata_format=MetadataFormat.ID3V2,
+            )
+
+            # 2. Verify rating was added
+            metadata_with_rating = get_unified_metadata(test_file, normalized_rating_max_value=100)
+            assert metadata_with_rating.get(UnifiedMetadataKey.RATING) == 80
+
+            # 3. Delete rating by setting to None
+            rating_deletion = {UnifiedMetadataKey.RATING: None}
+            update_metadata(
+                test_file, rating_deletion, normalized_rating_max_value=100, metadata_format=MetadataFormat.ID3V2
+            )
+
+            # 4. Verify rating was deleted
+            metadata_after_deletion = get_unified_metadata(test_file, normalized_rating_max_value=100)
+            assert metadata_after_deletion.get(UnifiedMetadataKey.RATING) is None
+
+            # 5. Add rating with 255 scale
+            rating_metadata_255 = {UnifiedMetadataKey.RATING: 204}  # 80% of 255
+            update_metadata(
+                test_file,
+                rating_metadata_255,
+                normalized_rating_max_value=255,
+                metadata_format=MetadataFormat.ID3V2,
+            )
+
+            # 6. Verify rating was added with 255 scale
+            metadata_with_rating_255 = get_unified_metadata(test_file, normalized_rating_max_value=255)
+            assert metadata_with_rating_255.get(UnifiedMetadataKey.RATING) == 204
+
+            # 7. Delete rating with 255 scale
+            update_metadata(
+                test_file, rating_deletion, normalized_rating_max_value=255, metadata_format=MetadataFormat.ID3V2
+            )
+
+            # 8. Verify rating was deleted
+            final_metadata = get_unified_metadata(test_file, normalized_rating_max_value=255)
+            assert final_metadata.get(UnifiedMetadataKey.RATING) is None
+
+    def test_complete_rating_cleanup_workflow(self):
+        # E2E test for complete cleanup including ratings
+        initial_metadata = {"title": "Complete Rating Cleanup", "artist": "Complete Rating Artist"}
+
+        with temp_file_with_metadata(initial_metadata, "mp3") as test_file:
+            # 1. Add comprehensive metadata including rating
+            comprehensive_metadata = {
+                UnifiedMetadataKey.RATING: 90,
+                UnifiedMetadataKey.BPM: 130,
+                UnifiedMetadataKey.COMMENT: "Rating cleanup test",
+            }
+            update_metadata(test_file, comprehensive_metadata, normalized_rating_max_value=100)
+
+            # 2. Verify all metadata exists
+            full_metadata = get_unified_metadata(test_file, normalized_rating_max_value=100)
+            assert full_metadata.get(UnifiedMetadataKey.RATING) == 90
+            assert full_metadata.get(UnifiedMetadataKey.BPM) == 130
+            assert full_metadata.get(UnifiedMetadataKey.COMMENT) == "Rating cleanup test"
+
+            # 3. Delete all metadata including rating
+            delete_result = delete_all_metadata(test_file)
+            assert delete_result is True
+
+            # 4. Verify all metadata including rating was deleted
+            cleaned_metadata = get_unified_metadata(test_file, normalized_rating_max_value=100)
+            assert cleaned_metadata.get(UnifiedMetadataKey.RATING) is None
+            assert cleaned_metadata.get(UnifiedMetadataKey.BPM) is None
+            assert (
+                cleaned_metadata.get(UnifiedMetadataKey.COMMENT) is None
+                or cleaned_metadata.get(UnifiedMetadataKey.COMMENT) != "Rating cleanup test"
+            )

audiometa/test/tests/integration/audio_format/flac/test_flac_delete_all.py

@@ -0,0 +1,108 @@
+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.test.helpers.vorbis.vorbis_metadata_setter import VorbisMetadataSetter
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestDeleteAllMetadataFormatSpecificFLAC:
+    def test_flac(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            # Add ID3v1 metadata using external tools for proper test isolation
+            ID3v1MetadataSetter.set_metadata(test_file, {"title": "ID3v1 Title", "artist": "ID3v1 Artist"})
+
+            # 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"
+
+            # Add Vorbis metadata using external tools for proper test isolation
+            VorbisMetadataSetter.add_title(test_file, "Vorbis Title")
+
+            # Verify Vorbis has metadata
+            vorbis_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_before.get(UnifiedMetadataKey.TITLE) == "Vorbis 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)
+            vorbis_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+            assert vorbis_after.get(UnifiedMetadataKey.TITLE) is None
+
+    def test_vorbis(self):
+        with temp_file_with_metadata(
+            {"title": "Test Vorbis Title", "artist": "Test Vorbis Artist"}, "flac"
+        ) as test_file:
+            # Verify Vorbis metadata is set
+            vorbis_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_before.get(UnifiedMetadataKey.TITLE) == "Test Vorbis Title"
+
+            result = delete_all_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert result is True
+
+            # Verify Vorbis metadata is deleted
+            vorbis_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_after.get(UnifiedMetadataKey.TITLE) is None
+
+    def test_id3v2(self):
+        with temp_file_with_metadata(
+            {"title": "Test Vorbis Title", "artist": "Test Vorbis Artist"}, "flac"
+        ) 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 Vorbis Title", "artist": "Test Vorbis Artist"}, "flac"
+        ) 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_riff(self):
+        with (
+            temp_file_with_metadata(
+                {"title": "Test Vorbis Title", "artist": "Test Vorbis Artist"}, "flac"
+            ) as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            delete_all_metadata(test_file, metadata_format=MetadataFormat.RIFF)

audiometa/test/tests/integration/audio_format/flac/test_flac_reading_all.py

@@ -0,0 +1,61 @@
+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.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.test.helpers.vorbis import VorbisMetadataSetter
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestFlacReading:
+    def test_all_metadata_reading_flac(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            VorbisMetadataSetter.add_title(test_file, "a" * 30)
+
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.TITLE) == "a" * 30
+
+    def test_vorbis_metadata_reading_flac(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            VorbisMetadataSetter.add_title(test_file, "a" * 30)
+
+            metadata = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert metadata.get(UnifiedMetadataKey.TITLE) == "a" * 30
+
+    def test_id3v2_3_metadata_reading_flac(self):
+        with temp_file_with_metadata({}, "flac") 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_flac(self):
+        with temp_file_with_metadata({}, "flac") 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_flac(self):
+        with temp_file_with_metadata({}, "flac") 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_flac(self):
+        with (
+            temp_file_with_metadata({}, "flac") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            get_unified_metadata(test_file, metadata_format=MetadataFormat.RIFF)

audiometa/test/tests/integration/audio_format/flac/test_flac_reading_field.py

@@ -0,0 +1,65 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+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.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.test.helpers.vorbis.vorbis_metadata_setter import VorbisMetadataSetter
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestFlacReading:
+    def test_all_metadata_format_reading_flac(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            VorbisMetadataSetter.add_title(test_file, "a" * 30)
+
+            title = get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE)
+            assert title == "a" * 30
+
+    def test_vorbis_metadata_reading_flac(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            VorbisMetadataSetter.add_title(test_file, "a" * 30)
+
+            title = get_unified_metadata_field(
+                test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.VORBIS
+            )
+            assert title == "a" * 30
+
+    def test_id3v2_3_metadata_reading_flac(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            ID3v2MetadataSetter.set_title(test_file, "ID3v2.3 Long Title That Exceeds ID3v1 Limits")
+
+            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 ID3v1 Limits"
+
+    def test_id3v2_4_metadata_reading_flac(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            ID3v2MetadataSetter.set_title(test_file, "ID3v2.4 Long Title That Exceeds ID3v1 Limits")
+
+            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 ID3v1 Limits"
+
+    def test_id3v1_metadata_reading_flac(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            ID3v1MetadataSetter.set_title(test_file, "a" * 30)
+            assert ID3v1MetadataGetter.get_title(test_file) == "a" * 30
+
+            title = get_unified_metadata_field(
+                test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.ID3V1
+            )
+            assert title == "a" * 30
+
+    def test_riff_metadata_reading_flac(self):
+        with (
+            temp_file_with_metadata({}, "flac") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.RIFF)

audiometa/test/tests/integration/audio_format/flac/test_flac_writing.py

@@ -0,0 +1,69 @@
+import pytest
+
+from audiometa import update_metadata
+from audiometa.exceptions import MetadataFormatNotSupportedByAudioFormatError
+from audiometa.test.helpers.id3v1.id3v1_metadata_getter import ID3v1MetadataGetter
+from audiometa.test.helpers.id3v2.id3v2_header_verifier import ID3v2HeaderVerifier
+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.test.helpers.vorbis.vorbis_metadata_getter import VorbisMetadataGetter
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestFlacWriting:
+    def test_writing_default_format_flac(self):
+        with temp_file_with_metadata({}, "flac") as temp_flac_file_path:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title Default"}
+            update_metadata(temp_flac_file_path, metadata)
+
+            vorbis_title = VorbisMetadataGetter.get_title(temp_flac_file_path)
+            assert vorbis_title == "Test Title Default"
+
+    def test_vorbis_metadata_writing_flac(self):
+        with temp_file_with_metadata({}, "flac") as temp_flac_file_path:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title Vorbis"}
+            update_metadata(temp_flac_file_path, metadata, metadata_format=MetadataFormat.VORBIS)
+            title = VorbisMetadataGetter.get_title(temp_flac_file_path)
+            assert title == "Test Title Vorbis"
+
+    def test_id3v2_3_metadata_writing_flac(self):
+        with temp_file_with_metadata({}, "flac") as temp_flac_file_path:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title ID3v2.3"}
+            update_metadata(
+                temp_flac_file_path, metadata, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 3, 0)
+            )
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(temp_flac_file_path) == (2, 3, 0)
+
+            title = ID3v2MetadataGetter.get_title(temp_flac_file_path)
+            assert title == "Test Title ID3v2.3"
+
+    def test_id3v2_4_metadata_writing_flac(self):
+        with temp_file_with_metadata({}, "flac") as temp_flac_file_path:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title ID3v2.4"}
+            update_metadata(
+                temp_flac_file_path, metadata, metadata_format=MetadataFormat.ID3V2, id3v2_version=(2, 4, 0)
+            )
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(temp_flac_file_path) == (2, 4, 0)
+
+            title = ID3v2MetadataGetter.get_title(temp_flac_file_path)
+            assert title == "Test Title ID3v2.4"
+
+    def test_id3v1_metadata_writing_flac(self):
+        with temp_file_with_metadata({}, "flac") as temp_flac_file_path:
+            metadata = {UnifiedMetadataKey.TITLE: "Test Title ID3v1"}
+            update_metadata(temp_flac_file_path, metadata, metadata_format=MetadataFormat.ID3V1)
+            title = ID3v1MetadataGetter.get_title(temp_flac_file_path)
+            assert title == "Test Title ID3v1"
+
+    def test_riff_metadata_writing_flac(self):
+        with (
+            temp_file_with_metadata({}, "flac") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            update_metadata(
+                test_file, {UnifiedMetadataKey.TITLE: "Test Title RIFF"}, metadata_format=MetadataFormat.RIFF
+            )

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

@@ -0,0 +1,79 @@
+import pytest
+
+from audiometa import delete_all_metadata, get_unified_metadata
+from audiometa.exceptions import MetadataFormatNotSupportedByAudioFormatError
+from audiometa.test.helpers.id3v2.id3v2_metadata_setter 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 TestDeleteAllMetadataFormatSpecificMP3:
+    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_id3v2(self):
+        with temp_file_with_metadata({"title": "Test Title", "artist": "Test Artist"}, "mp3") as test_file:
+            # Verify metadata is set
+            id3v2_before = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_before.get(UnifiedMetadataKey.TITLE) == "Test 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 Title", "artist": "Test Artist"}, "mp3") as test_file:
+            # Add ID3V1 metadata
+            from audiometa.test.helpers.id3v1 import ID3v1MetadataSetter
+
+            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 Title", "artist": "Test Artist"}, "mp3") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            delete_all_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+
+    def test_riff(self):
+        with (
+            temp_file_with_metadata({"title": "Test Title", "artist": "Test Artist"}, "mp3") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            delete_all_metadata(test_file, metadata_format=MetadataFormat.RIFF)

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

@@ -0,0 +1,61 @@
+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.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 TestMp3Reading:
+    def test_all_metadata_reading_mp3(self):
+        with temp_file_with_metadata({}, "mp3") 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_mp3(self):
+        with temp_file_with_metadata({}, "id3v2.3") 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_mp3(self):
+        with temp_file_with_metadata({}, "id3v2.4") 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_mp3(self):
+        with temp_file_with_metadata({}, "mp3") 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_mp3(self):
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            get_unified_metadata(test_file, metadata_format=MetadataFormat.RIFF)
+
+    def test_vorbis_metadata_reading_mp3(self):
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)

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

@@ -0,0 +1,67 @@
+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.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 TestMp3Reading:
+    def test_all_metadata_format_reading_mp3(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v1MetadataSetter.set_title(test_file, "Title ID3v1")
+
+            title = get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE)
+            assert title == "Title ID3v1"
+
+    def test_id3v1_metadata_reading_mp3(self):
+        with temp_file_with_metadata({}, "id3v1") as test_file:
+            ID3v1MetadataSetter.set_title(test_file, "Title ID3v1")
+
+            title = get_unified_metadata_field(
+                file=test_file, metadata_format=MetadataFormat.ID3V1, unified_metadata_key=UnifiedMetadataKey.TITLE
+            )
+            assert title == "Title ID3v1"
+
+    def test_id3v2_3_metadata_reading_mp3(self):
+        with temp_file_with_metadata({}, "id3v2.3") as test_file:
+            metadata = {UnifiedMetadataKey.TITLE: "Title ID3v2.3"}
+            ID3v2MetadataSetter.set_metadata(test_file, metadata, version="2.3")
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 3, 0)
+
+            title = get_unified_metadata_field(
+                file=test_file, metadata_format=MetadataFormat.ID3V2, unified_metadata_key=UnifiedMetadataKey.TITLE
+            )
+            assert title == "Title ID3v2.3"
+
+    def test_id3v2_4_metadata_reading_mp3(self):
+        with temp_file_with_metadata({}, "id3v2.4") as test_file:
+            metadata = {UnifiedMetadataKey.TITLE: "Title ID3v2.4"}
+            ID3v2MetadataSetter.set_metadata(test_file, metadata, version="2.4")
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 4, 0)
+
+            title = get_unified_metadata_field(
+                file=test_file, metadata_format=MetadataFormat.ID3V2, unified_metadata_key=UnifiedMetadataKey.TITLE
+            )
+            assert title == "Title ID3v2.4"
+
+    def test_riff_metadata_reading_mp3(self):
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.RIFF)
+
+    def test_vorbis_metadata_reading_mp3(self):
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(MetadataFormatNotSupportedByAudioFormatError),
+        ):
+            get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.VORBIS)