audiometa-python 0.6.0__py3-none-any.whl

audiometa/test/tests/integration/metadata_field/album/test_reading.py

@@ -0,0 +1,36 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.test.helpers.id3v1 import ID3v1MetadataSetter
+from audiometa.test.helpers.id3v2 import ID3v2MetadataSetter
+from audiometa.test.helpers.riff import RIFFMetadataSetter
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.test.helpers.vorbis import VorbisMetadataSetter
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestAlbumReading:
+    def test_id3v1(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "id3v1") as test_file:
+            ID3v1MetadataSetter.set_max_metadata(test_file)
+            album = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM)
+            assert album == "a" * 30
+
+    def test_id3v2(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_max_metadata(test_file)
+            album = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM)
+            assert album == "a" * 1000
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "flac") as test_file:
+            VorbisMetadataSetter.set_max_metadata(test_file)
+            album = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM)
+            assert album == "a" * 1000
+
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "wav") as test_file:
+            RIFFMetadataSetter.set_max_metadata(test_file)
+            album = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM)
+            assert album == "a" * 1000

audiometa/test/tests/integration/metadata_field/album/test_writing.py

@@ -0,0 +1,50 @@
+import pytest
+
+from audiometa import 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.integration
+class TestAlbumWriting:
+    def test_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_album = "Test Album ID3v2"
+            test_metadata = {UnifiedMetadataKey.ALBUM: test_album}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V2)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ALBUM) == test_album
+
+    def test_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            test_album = "Test Album RIFF"
+            test_metadata = {UnifiedMetadataKey.ALBUM: test_album}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ALBUM) == test_album
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            test_album = "Test Album Vorbis"
+            test_metadata = {UnifiedMetadataKey.ALBUM: test_album}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.VORBIS)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ALBUM) == test_album
+
+    def test_id3v1(self):
+        with temp_file_with_metadata({}, "id3v1") as test_file:
+            test_album = "Test Album ID3v1"
+            test_metadata = {UnifiedMetadataKey.ALBUM: test_album}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V1)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ALBUM) == test_album
+
+    def test_invalid_type_raises(self):
+        from audiometa.exceptions import InvalidMetadataFieldTypeError
+
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            # pass an int where a string is expected
+            bad_metadata = {UnifiedMetadataKey.ALBUM: 123}
+            with pytest.raises(InvalidMetadataFieldTypeError):
+                update_metadata(test_file, bad_metadata)

audiometa/test/tests/integration/metadata_field/album_artists/test_deleting.py

@@ -0,0 +1,83 @@
+import pytest
+
+from audiometa import get_unified_metadata_field, update_metadata
+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 import VorbisMetadataSetter
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestAlbumArtistsDeleting:
+    def test_delete_album_artists_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            # Set metadata using max metadata method (includes album artists)
+            ID3v2MetadataSetter.set_max_metadata(test_file)
+            # Verify album artists are set
+            album_artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS)
+            assert album_artists is not None
+
+            # Delete metadata by setting to None
+            update_metadata(test_file, {UnifiedMetadataKey.ALBUM_ARTISTS: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS) is None
+
+    def test_delete_album_artists_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            # Set album artists using the unified API
+            update_metadata(
+                test_file,
+                {UnifiedMetadataKey.ALBUM_ARTISTS: ["Test Album Artist"]},
+                metadata_format=MetadataFormat.RIFF,
+            )
+            # Verify album artists are set
+            album_artists = get_unified_metadata_field(
+                test_file, UnifiedMetadataKey.ALBUM_ARTISTS, metadata_format=MetadataFormat.RIFF
+            )
+            assert album_artists == ["Test Album Artist"]
+
+            # Delete metadata by setting to None
+            update_metadata(test_file, {UnifiedMetadataKey.ALBUM_ARTISTS: None}, metadata_format=MetadataFormat.RIFF)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS) is None
+
+    def test_delete_album_artists_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            # Set metadata using max metadata method (includes album artists)
+            VorbisMetadataSetter.set_max_metadata(test_file)
+            # Verify album artists are set
+            album_artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS)
+            assert album_artists is not None
+
+            # Delete metadata by setting to None
+            update_metadata(test_file, {UnifiedMetadataKey.ALBUM_ARTISTS: None}, metadata_format=MetadataFormat.VORBIS)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS) is None
+
+    def test_delete_album_artists_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            # Set metadata using max metadata method (includes album artists and other fields)
+            ID3v2MetadataSetter.set_max_metadata(test_file)
+            # Verify album artists are set
+            album_artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS)
+            assert album_artists is not None
+
+            # Delete only album artists
+            update_metadata(test_file, {UnifiedMetadataKey.ALBUM_ARTISTS: None}, metadata_format=MetadataFormat.ID3V2)
+
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS) is None
+            # Verify other fields are preserved
+            title = get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE)
+            assert title is not None
+
+    def test_delete_album_artists_already_none(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            # Try to delete album artists that don't exist
+            update_metadata(test_file, {UnifiedMetadataKey.ALBUM_ARTISTS: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS) is None
+
+    def test_delete_album_artists_with_existing_metadata(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            # Set metadata using max metadata method (includes album artists)
+            ID3v2MetadataSetter.set_max_metadata(test_file)
+            # Delete the album artists
+            update_metadata(test_file, {UnifiedMetadataKey.ALBUM_ARTISTS: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS) is None

audiometa/test/tests/integration/metadata_field/album_artists/test_reading.py

@@ -0,0 +1,38 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.test.helpers.id3v2.id3v2_metadata_setter import ID3v2MetadataSetter
+from audiometa.test.helpers.riff.riff_metadata_getter import RIFFMetadataGetter
+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.test.helpers.vorbis.vorbis_metadata_setter import VorbisMetadataSetter
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestAlbumArtistsReading:
+    def test_id3v1(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "id3v1") as test_file:
+            album_artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS)
+            assert album_artists is None
+
+    def test_id3v2(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_max_metadata(test_file)
+            album_artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS)
+            assert album_artists == ["a" * 1000]
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "flac") as test_file:
+            VorbisMetadataSetter.set_max_metadata(test_file)
+            album_artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS)
+            assert album_artists == ["a" * 1000]
+
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "wav") as test_file:
+            RIFFMetadataSetter.set_multiple_album_artists(test_file, ["Test Album Artist"])
+            raw_metadata = RIFFMetadataGetter.get_raw_metadata(test_file)
+            assert "TAG:IAAR=Test Album Artist" in raw_metadata
+
+            album_artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM_ARTISTS)
+            assert album_artists == ["Test Album Artist"]

audiometa/test/tests/integration/metadata_field/album_artists/test_writing.py

@@ -0,0 +1,52 @@
+import pytest
+
+from audiometa import get_unified_metadata, update_metadata
+from audiometa.exceptions import InvalidMetadataFieldTypeError
+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 TestAlbumArtistsWriting:
+    def test_id3v2(self):
+        test_album_artists = ["Album Artist 1", "Album Artist 2"]
+        test_metadata = {UnifiedMetadataKey.ALBUM_ARTISTS: test_album_artists}
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V2)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ALBUM_ARTISTS) == test_album_artists
+
+    def test_riff(self):
+        test_album_artists = ["RIFF Album Artist 1", "RIFF Album Artist 2"]
+        test_metadata = {UnifiedMetadataKey.ALBUM_ARTISTS: test_album_artists}
+        with temp_file_with_metadata({}, "wav") as test_file:
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ALBUM_ARTISTS) == test_album_artists
+
+    def test_vorbis(self):
+        test_album_artists = ["Vorbis Album Artist 1", "Vorbis Album Artist 2"]
+        test_metadata = {UnifiedMetadataKey.ALBUM_ARTISTS: test_album_artists}
+        with temp_file_with_metadata({}, "flac") as test_file:
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.VORBIS)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ALBUM_ARTISTS) == test_album_artists
+
+    def test_id3v1(self):
+        from audiometa.exceptions import MetadataFieldNotSupportedByMetadataFormatError
+
+        test_album_artists = ["ID3v1 Album Artist"]
+        test_metadata = {UnifiedMetadataKey.ALBUM_ARTISTS: test_album_artists}
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(
+                MetadataFieldNotSupportedByMetadataFormatError,
+                match="UnifiedMetadataKey.ALBUM_ARTISTS metadata not supported by ID3v1 format",
+            ),
+        ):
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V1)
+
+    def test_invalid_type_raises(self):
+        with temp_file_with_metadata({}, "mp3") as test_file, pytest.raises(InvalidMetadataFieldTypeError):
+            update_metadata(test_file, {UnifiedMetadataKey.ALBUM_ARTISTS: "Single Album Artist"})

audiometa/test/tests/integration/metadata_field/artists/test_deleting.py

@@ -0,0 +1,68 @@
+import pytest
+
+from audiometa import get_unified_metadata_field, update_metadata
+from audiometa.test.helpers.id3v1 import ID3v1MetadataSetter
+from audiometa.test.helpers.id3v2 import ID3v2MetadataSetter
+from audiometa.test.helpers.riff import RIFFMetadataSetter
+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 TestArtistsDeleting:
+    def test_delete_artists_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_artists(test_file, "Artist 1; Artist 2")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) == ["Artist 1", "Artist 2"]
+
+            # Delete metadata using library API
+            update_metadata(test_file, {UnifiedMetadataKey.ARTISTS: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) is None
+
+    def test_delete_artists_id3v1(self):
+        with temp_file_with_metadata({}, "id3v1") as test_file:
+            ID3v1MetadataSetter.set_artist(test_file, "Artist 1")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) == ["Artist 1"]
+
+            # Delete metadata using library API
+            update_metadata(test_file, {UnifiedMetadataKey.ARTISTS: None}, metadata_format=MetadataFormat.ID3V1)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) is None
+
+    def test_delete_artists_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            RIFFMetadataSetter.set_artist(test_file, "Artist 1")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) == ["Artist 1"]
+
+            # Delete metadata using library API
+            update_metadata(test_file, {UnifiedMetadataKey.ARTISTS: None}, metadata_format=MetadataFormat.RIFF)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) is None
+
+    def test_delete_artists_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            VorbisMetadataSetter.set_artists(test_file, ["Artist 1", "Artist 2"])
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) == ["Artist 1", "Artist 2"]
+
+            # Delete metadata using library API
+            update_metadata(test_file, {UnifiedMetadataKey.ARTISTS: None}, metadata_format=MetadataFormat.VORBIS)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) is None
+
+    def test_delete_artists_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_artists(test_file, "Test Artist")
+            ID3v2MetadataSetter.set_title(test_file, "Test Title")
+            ID3v2MetadataSetter.set_album(test_file, "Test Album")
+
+            # Delete only artists using library API
+            update_metadata(test_file, {UnifiedMetadataKey.ARTISTS: None}, metadata_format=MetadataFormat.ID3V2)
+
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) is None
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) == "Test Title"
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM) == "Test Album"
+
+    def test_delete_artists_already_none(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            # Try to delete artists that don't exist
+            update_metadata(test_file, {UnifiedMetadataKey.ARTISTS: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) is None

audiometa/test/tests/integration/metadata_field/artists/test_reading.py

@@ -0,0 +1,36 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.test.helpers.id3v1 import ID3v1MetadataSetter
+from audiometa.test.helpers.id3v2 import ID3v2MetadataSetter
+from audiometa.test.helpers.riff import RIFFMetadataSetter
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.test.helpers.vorbis import VorbisMetadataSetter
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestArtistsReading:
+    def test_id3v1(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "id3v1") as test_file:
+            ID3v1MetadataSetter.set_max_metadata(test_file)
+            artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS)
+            assert artists == ["a" * 30]
+
+    def test_id3v2(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_max_metadata(test_file)
+            artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS)
+            assert artists == ["a" * 1000]
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "flac") as test_file:
+            VorbisMetadataSetter.set_max_metadata(test_file)
+            artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS)
+            assert artists == ["a" * 1000]
+
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "wav") as test_file:
+            RIFFMetadataSetter.set_max_metadata(test_file)
+            artists = get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS)
+            assert artists == ["a" * 1000]

audiometa/test/tests/integration/metadata_field/artists/test_writing.py

@@ -0,0 +1,46 @@
+import pytest
+
+from audiometa import get_unified_metadata, update_metadata
+from audiometa.exceptions import InvalidMetadataFieldTypeError
+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 TestArtistsWriting:
+    def test_id3v2(self):
+        test_artists = ["Test Artist 1", "Test Artist 2"]
+        test_metadata = {UnifiedMetadataKey.ARTISTS: test_artists}
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V2)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ARTISTS) == test_artists
+
+    def test_riff(self):
+        test_artists = ["RIFF Artist 1", "RIFF Artist 2"]
+        test_metadata = {UnifiedMetadataKey.ARTISTS: test_artists}
+        with temp_file_with_metadata({}, "wav") as test_file:
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ARTISTS) == test_artists
+
+    def test_vorbis(self):
+        test_artists = ["Vorbis Artist 1", "Vorbis Artist 2"]
+        test_metadata = {UnifiedMetadataKey.ARTISTS: test_artists}
+        with temp_file_with_metadata({}, "flac") as test_file:
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.VORBIS)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ARTISTS) == test_artists
+
+    def test_id3v1(self):
+        test_artists = ["ID3v1 Artist"]
+        test_metadata = {UnifiedMetadataKey.ARTISTS: test_artists}
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V1)
+            metadata = get_unified_metadata(test_file)
+            assert metadata.get(UnifiedMetadataKey.ARTISTS) == test_artists
+
+    def test_invalid_type_raises(self):
+        with temp_file_with_metadata({}, "mp3") as test_file, pytest.raises(InvalidMetadataFieldTypeError):
+            update_metadata(test_file, {UnifiedMetadataKey.ARTISTS: "Single Artist"})

audiometa/test/tests/integration/metadata_field/bpm/test_deleting.py

@@ -0,0 +1,75 @@
+import pytest
+
+from audiometa import get_unified_metadata_field, update_metadata
+from audiometa.test.helpers.id3v2 import ID3v2MetadataSetter
+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.test.helpers.vorbis import VorbisMetadataSetter
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestBpmDeleting:
+    def test_delete_bpm_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_bpm(test_file, 120)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM) == 120
+
+            # Delete metadata using library API
+            update_metadata(test_file, {UnifiedMetadataKey.BPM: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM) is None
+
+    def test_delete_bpm_id3v1(self):
+        from audiometa.exceptions import MetadataFieldNotSupportedByMetadataFormatError
+
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(MetadataFieldNotSupportedByMetadataFormatError),
+        ):
+            update_metadata(test_file, {UnifiedMetadataKey.BPM: None}, metadata_format=MetadataFormat.ID3V1)
+
+    def test_delete_bpm_riff(self):
+        with temp_file_with_metadata({"bpm": 120}, "wav") as test_file:
+            raw_metadata = RIFFMetadataGetter.get_raw_metadata(test_file)
+            assert "ibpm=120" in raw_metadata
+
+            update_metadata(test_file, {UnifiedMetadataKey.BPM: None}, metadata_format=MetadataFormat.RIFF)
+            raw_metadata_after = RIFFMetadataGetter.get_raw_metadata(test_file)
+            assert "ibpm=120" not in raw_metadata_after
+
+    def test_delete_bpm_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            VorbisMetadataSetter.set_bpm(test_file, 120)
+            assert (
+                get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM, metadata_format=MetadataFormat.VORBIS)
+                == 120
+            )
+
+            update_metadata(test_file, {UnifiedMetadataKey.BPM: None}, metadata_format=MetadataFormat.VORBIS)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM) is None
+
+    def test_delete_bpm_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_bpm(test_file, 120)
+            ID3v2MetadataSetter.set_title(test_file, "Test Title")
+            ID3v2MetadataSetter.set_artists(test_file, "Test Artist")
+
+            update_metadata(test_file, {UnifiedMetadataKey.BPM: None}, metadata_format=MetadataFormat.ID3V2)
+
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM) is None
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) == "Test Title"
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) == ["Test Artist"]
+
+    def test_delete_bpm_already_none(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.BPM: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM) is None
+
+    def test_delete_bpm_zero(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_bpm(test_file, 0)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM) == 0
+
+            update_metadata(test_file, {UnifiedMetadataKey.BPM: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM) is None

audiometa/test/tests/integration/metadata_field/bpm/test_reading.py

@@ -0,0 +1,32 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+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 TestBpmReading:
+    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.BPM, metadata_format=MetadataFormat.ID3V1)
+
+    def test_id3v2(self):
+        with temp_file_with_metadata({"title": "Test Song", "bpm": 999}, "id3v2.4") as test_file:
+            bpm = get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM, metadata_format=MetadataFormat.ID3V2)
+            assert bpm == 999
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({"title": "Test Song", "bpm": 999}, "flac") as test_file:
+            bpm = get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM, metadata_format=MetadataFormat.VORBIS)
+            assert bpm == 999
+
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test Song", "bpm": 999}, "wav") as test_file:
+            bpm = get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM, metadata_format=MetadataFormat.RIFF)
+            assert bpm == 999

audiometa/test/tests/integration/metadata_field/bpm/test_writing.py

@@ -0,0 +1,56 @@
+import pytest
+
+from audiometa import get_unified_metadata_field, 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.integration
+class TestBpmWriting:
+    def test_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_bpm = 128
+            test_metadata = {UnifiedMetadataKey.BPM: test_bpm}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V2)
+            bpm = get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM)
+            assert bpm == test_bpm
+
+    def test_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            test_bpm = 120
+            test_metadata = {UnifiedMetadataKey.BPM: test_bpm}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+
+            raw_metadata = get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM)
+            assert raw_metadata == test_bpm
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            test_bpm = 140
+            test_metadata = {UnifiedMetadataKey.BPM: test_bpm}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.VORBIS)
+            bpm = get_unified_metadata_field(test_file, UnifiedMetadataKey.BPM)
+            assert bpm == test_bpm
+
+    def test_id3v1(self):
+        from audiometa.exceptions import MetadataFieldNotSupportedByMetadataFormatError
+
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_bpm = 128
+            test_metadata = {UnifiedMetadataKey.BPM: test_bpm}
+
+            # ID3v1 format raises exception for unsupported metadata when format is forced
+            with pytest.raises(
+                MetadataFieldNotSupportedByMetadataFormatError,
+                match="UnifiedMetadataKey.BPM metadata not supported by ID3v1 format",
+            ):
+                update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V1)
+
+    def test_invalid_type_raises(self):
+        from audiometa.exceptions import InvalidMetadataFieldTypeError
+
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            bad_metadata = {UnifiedMetadataKey.BPM: "not-an-int"}
+            with pytest.raises(InvalidMetadataFieldTypeError):
+                update_metadata(test_file, bad_metadata)