audiometa-python 0.6.0__py3-none-any.whl

audiometa/test/tests/integration/metadata_field/comment/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 TestCommentDeleting:
+    def test_delete_comment_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_metadata(test_file, {"comment": "Test comment"})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) == "Test comment"
+
+            update_metadata(test_file, {UnifiedMetadataKey.COMMENT: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) is None
+
+    def test_delete_comment_id3v1(self):
+        with temp_file_with_metadata({}, "id3v1") as test_file:
+            ID3v1MetadataSetter.set_comment(test_file, "Test comment")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) == "Test comment"
+
+            update_metadata(test_file, {UnifiedMetadataKey.COMMENT: None}, metadata_format=MetadataFormat.ID3V1)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) is None
+
+    def test_delete_comment_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            RIFFMetadataSetter.set_comment(test_file, "Test comment")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) == "Test comment"
+
+            update_metadata(test_file, {UnifiedMetadataKey.COMMENT: None}, metadata_format=MetadataFormat.RIFF)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) is None
+
+    def test_delete_comment_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            VorbisMetadataSetter.set_comment(test_file, "Test comment")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) == "Test comment"
+
+            update_metadata(test_file, {UnifiedMetadataKey.COMMENT: None}, metadata_format=MetadataFormat.VORBIS)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) is None
+
+    def test_delete_comment_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_metadata(test_file, {"comment": "Test comment"})
+            ID3v2MetadataSetter.set_title(test_file, "Test Title")
+            ID3v2MetadataSetter.set_artists(test_file, "Test Artist")
+
+            update_metadata(test_file, {UnifiedMetadataKey.COMMENT: None}, metadata_format=MetadataFormat.ID3V2)
+            update_metadata(test_file, {UnifiedMetadataKey.COMMENT: None}, metadata_format=MetadataFormat.ID3V2)
+
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) 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_comment_already_none(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.COMMENT: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) is None
+
+    def test_delete_comment_empty_string(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.COMMENT: ""}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT) is None

audiometa/test/tests/integration/metadata_field/comment/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 TestCommentReading:
+    def test_id3v1(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "id3v1") as test_file:
+            ID3v1MetadataSetter.set_max_metadata(test_file)
+            comment = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT)
+            assert comment == "a" * 28
+
+    def test_id3v2(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_max_metadata(test_file)
+            comment = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT)
+            assert comment == "a" * 4000
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "flac") as test_file:
+            VorbisMetadataSetter.set_max_metadata(test_file)
+            comment = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT)
+            assert comment == "a" * 1000
+
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "wav") as test_file:
+            RIFFMetadataSetter.set_metadata(test_file, {"comment": "Test Comment RIFF"})
+            comment = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT)
+            assert comment == "Test Comment RIFF"

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

@@ -0,0 +1,49 @@
+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 TestCommentWriting:
+    def test_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_comment = "Test Comment ID3v2"
+            test_metadata = {UnifiedMetadataKey.COMMENT: test_comment}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V2)
+            comment = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT)
+            assert comment == test_comment
+
+    def test_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            test_comment = "Test Comment RIFF"
+            test_metadata = {UnifiedMetadataKey.COMMENT: test_comment}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            comment = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT)
+            assert comment == test_comment
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            test_comment = "Test Comment Vorbis"
+            test_metadata = {UnifiedMetadataKey.COMMENT: test_comment}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.VORBIS)
+            comment = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT)
+            assert comment == test_comment
+
+    def test_id3v1(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_comment = "Test Comment ID3v1"
+            test_metadata = {UnifiedMetadataKey.COMMENT: test_comment}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V1)
+            comment = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMMENT)
+            assert comment == test_comment
+
+    def test_invalid_type_raises(self):
+        from audiometa.exceptions import InvalidMetadataFieldTypeError
+
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            bad_metadata = {UnifiedMetadataKey.COMMENT: 12345}
+            with pytest.raises(InvalidMetadataFieldTypeError):
+                update_metadata(test_file, bad_metadata)

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

@@ -0,0 +1,75 @@
+import pytest
+
+from audiometa import get_unified_metadata_field, update_metadata
+from audiometa.exceptions import MetadataFieldNotSupportedByMetadataFormatError
+from audiometa.test.helpers.id3v2 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 TestComposerDeleting:
+    def test_delete_composer_id3v1(self):
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(
+                MetadataFieldNotSupportedByMetadataFormatError,
+                match="UnifiedMetadataKey.COMPOSERS metadata not supported by ID3v1 format",
+            ),
+        ):
+            update_metadata(
+                test_file,
+                {UnifiedMetadataKey.COMPOSERS: ["Test Composer"]},
+                metadata_format=MetadataFormat.ID3V1,
+            )
+
+    def test_delete_composer_id3v2(self):
+        with temp_file_with_metadata({"composer": "Test Composer"}, "id3v2.4") as test_file:
+            raw_metadata = ID3v2MetadataGetter.get_raw_metadata(test_file, version="2.4")
+            assert raw_metadata["TCOM"] == ["Test Composer"]
+
+            update_metadata(test_file, {UnifiedMetadataKey.COMPOSERS: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS) is None
+
+    def test_delete_composer_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            update_metadata(
+                test_file, {UnifiedMetadataKey.COMPOSERS: ["Test Composer"]}, metadata_format=MetadataFormat.RIFF
+            )
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS) == ["Test Composer"]
+
+            update_metadata(test_file, {UnifiedMetadataKey.COMPOSERS: None}, metadata_format=MetadataFormat.RIFF)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS) is None
+
+    def test_delete_composer_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            update_metadata(
+                test_file, {UnifiedMetadataKey.COMPOSERS: ["Test Composer"]}, metadata_format=MetadataFormat.VORBIS
+            )
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS) == ["Test Composer"]
+
+            update_metadata(test_file, {UnifiedMetadataKey.COMPOSERS: None}, metadata_format=MetadataFormat.VORBIS)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS) is None
+
+    def test_delete_composer_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(
+                test_file,
+                {
+                    UnifiedMetadataKey.COMPOSERS: ["Test Composer"],
+                    UnifiedMetadataKey.TITLE: "Test Title",
+                    UnifiedMetadataKey.ARTISTS: ["Test Artist"],
+                },
+            )
+
+            update_metadata(test_file, {UnifiedMetadataKey.COMPOSERS: None})
+
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS) 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_composer_already_none(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.COMPOSERS: None})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS) is None

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

@@ -0,0 +1,34 @@
+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.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 TestComposerReading:
+    def test_id3v1(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "id3v1") as test_file:
+            ID3v1MetadataSetter.set_max_metadata(test_file)
+            composer = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS)
+            assert composer is None
+
+    def test_id3v2(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_max_metadata(test_file)
+            composer = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS)
+            assert composer == ["a" * 1000]
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "flac") as test_file:
+            VorbisMetadataSetter.set_max_metadata(test_file)
+            composer = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS)
+            assert composer == ["a" * 1000]
+
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "wav") as test_file:
+            composer = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS)
+            assert composer is None

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

@@ -0,0 +1,41 @@
+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 TestComposerWriting:
+    def test_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_composer = "Test Composer ID3v2"
+            test_metadata = {UnifiedMetadataKey.COMPOSERS: [test_composer]}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V2)
+            composer = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS)
+            assert composer == [test_composer]
+
+    def test_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            test_composer = "Test Composer RIFF"
+            test_metadata = {UnifiedMetadataKey.COMPOSERS: [test_composer]}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            composer = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS)
+            assert composer == [test_composer]
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            test_composer = "Test Composer Vorbis"
+            test_metadata = {UnifiedMetadataKey.COMPOSERS: [test_composer]}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.VORBIS)
+            composer = get_unified_metadata_field(test_file, UnifiedMetadataKey.COMPOSERS)
+            assert composer == [test_composer]
+
+    def test_invalid_type_raises(self):
+        from audiometa.exceptions import InvalidMetadataFieldTypeError
+
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            bad_metadata = {UnifiedMetadataKey.COMPOSERS: 12345}
+            with pytest.raises(InvalidMetadataFieldTypeError):
+                update_metadata(test_file, bad_metadata)

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

@@ -0,0 +1,81 @@
+import pytest
+
+from audiometa import get_unified_metadata_field, update_metadata
+from audiometa.exceptions import MetadataFieldNotSupportedByMetadataFormatError
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.utils.metadata_format import MetadataFormat
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestCopyrightDeleting:
+    def test_delete_copyright_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(
+                test_file, {UnifiedMetadataKey.COPYRIGHT: "Test Copyright"}, metadata_format=MetadataFormat.ID3V2
+            )
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT) == "Test Copyright"
+
+            update_metadata(test_file, {UnifiedMetadataKey.COPYRIGHT: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT) is None
+
+    def test_delete_copyright_id3v1(self):
+        with (
+            temp_file_with_metadata({}, "mp3") as test_file,
+            pytest.raises(
+                MetadataFieldNotSupportedByMetadataFormatError,
+                match="UnifiedMetadataKey.COPYRIGHT metadata not supported by ID3v1 format",
+            ),
+        ):
+            update_metadata(
+                test_file,
+                {UnifiedMetadataKey.COPYRIGHT: "Test Copyright"},
+                metadata_format=MetadataFormat.ID3V1,
+            )
+
+    def test_delete_copyright_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            update_metadata(
+                test_file, {UnifiedMetadataKey.COPYRIGHT: "Test Copyright"}, metadata_format=MetadataFormat.RIFF
+            )
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT) == "Test Copyright"
+
+            update_metadata(test_file, {UnifiedMetadataKey.COPYRIGHT: None}, metadata_format=MetadataFormat.RIFF)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT) is None
+
+    def test_delete_copyright_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            update_metadata(
+                test_file, {UnifiedMetadataKey.COPYRIGHT: "Test Copyright"}, metadata_format=MetadataFormat.VORBIS
+            )
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT) == "Test Copyright"
+
+            update_metadata(test_file, {UnifiedMetadataKey.COPYRIGHT: None}, metadata_format=MetadataFormat.VORBIS)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT) is None
+
+    def test_delete_copyright_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(
+                test_file,
+                {
+                    UnifiedMetadataKey.COPYRIGHT: "Test Copyright",
+                    UnifiedMetadataKey.TITLE: "Test Title",
+                    UnifiedMetadataKey.ARTISTS: ["Test Artist"],
+                },
+            )
+
+            update_metadata(test_file, {UnifiedMetadataKey.COPYRIGHT: None})
+
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT) 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_copyright_already_none(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.COPYRIGHT: None})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT) is None
+
+    def test_delete_copyright_empty_string(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.COPYRIGHT: ""}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT) is None

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

@@ -0,0 +1,35 @@
+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 TestCopyrightReading:
+    def test_id3v1(self):
+        with (
+            temp_file_with_metadata({"title": "Test Song"}, "id3v1") as test_file,
+            pytest.raises(
+                MetadataFieldNotSupportedByMetadataFormatError,
+                match="UnifiedMetadataKey.COPYRIGHT metadata not supported by ID3v1 format",
+            ),
+        ):
+            get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT, metadata_format=MetadataFormat.ID3V1)
+
+    def test_id3v2(self):
+        with temp_file_with_metadata({"title": "Test Song", "copyright": "Test Copyright"}, "mp3") as test_file:
+            copyright_info = get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT)
+            assert copyright_info == "Test Copyright"
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({"title": "Test Song", "copyright": "Test Copyright"}, "flac") as test_file:
+            copyright_info = get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT)
+            assert copyright_info == "Test Copyright"
+
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "wav") as test_file:
+            copyright_info = get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT)
+            assert copyright_info is None

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

@@ -0,0 +1,41 @@
+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 TestCopyrightWriting:
+    def test_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_copyright = "© 2024 Test Label ID3v2"
+            test_metadata = {UnifiedMetadataKey.COPYRIGHT: test_copyright}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V2)
+            copyright_info = get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT)
+            assert copyright_info == test_copyright
+
+    def test_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            test_copyright = "© 2024 Test Label RIFF"
+            test_metadata = {UnifiedMetadataKey.COPYRIGHT: test_copyright}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            copyright_info = get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT)
+            assert copyright_info == test_copyright
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            test_copyright = "© 2024 Test Label Vorbis"
+            test_metadata = {UnifiedMetadataKey.COPYRIGHT: test_copyright}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.VORBIS)
+            copyright_info = get_unified_metadata_field(test_file, UnifiedMetadataKey.COPYRIGHT)
+            assert copyright_info == test_copyright
+
+    def test_invalid_type_raises(self):
+        from audiometa.exceptions import InvalidMetadataFieldTypeError
+
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            bad_metadata = {UnifiedMetadataKey.COPYRIGHT: 123}
+            with pytest.raises(InvalidMetadataFieldTypeError):
+                update_metadata(test_file, bad_metadata)

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

@@ -0,0 +1,97 @@
+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 TestDiscNumberDeleting:
+    def test_delete_disc_number_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(
+                test_file,
+                {UnifiedMetadataKey.DISC_NUMBER: 1, UnifiedMetadataKey.DISC_TOTAL: 2},
+                metadata_format=MetadataFormat.ID3V2,
+            )
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) == 1
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) == 2
+
+            update_metadata(test_file, {UnifiedMetadataKey.DISC_NUMBER: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) is None
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) is None
+
+    def test_delete_disc_total_only_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(
+                test_file,
+                {UnifiedMetadataKey.DISC_NUMBER: 1, UnifiedMetadataKey.DISC_TOTAL: 2},
+                metadata_format=MetadataFormat.ID3V2,
+            )
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) == 1
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) == 2
+
+            update_metadata(test_file, {UnifiedMetadataKey.DISC_TOTAL: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) == 1
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) is None
+
+    def test_delete_disc_number_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            update_metadata(
+                test_file,
+                {UnifiedMetadataKey.DISC_NUMBER: 1, UnifiedMetadataKey.DISC_TOTAL: 2},
+                metadata_format=MetadataFormat.VORBIS,
+            )
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) == 1
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) == 2
+
+            update_metadata(test_file, {UnifiedMetadataKey.DISC_NUMBER: None}, metadata_format=MetadataFormat.VORBIS)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) is None
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) is None
+
+    def test_delete_disc_total_only_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            update_metadata(
+                test_file,
+                {UnifiedMetadataKey.DISC_NUMBER: 1, UnifiedMetadataKey.DISC_TOTAL: 2},
+                metadata_format=MetadataFormat.VORBIS,
+            )
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) == 1
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) == 2
+
+            update_metadata(test_file, {UnifiedMetadataKey.DISC_TOTAL: None}, metadata_format=MetadataFormat.VORBIS)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) == 1
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) is None
+
+    def test_delete_disc_number_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(
+                test_file,
+                {
+                    UnifiedMetadataKey.DISC_NUMBER: 1,
+                    UnifiedMetadataKey.DISC_TOTAL: 2,
+                    UnifiedMetadataKey.TITLE: "Test Title",
+                    UnifiedMetadataKey.ARTISTS: ["Test Artist"],
+                },
+            )
+
+            update_metadata(test_file, {UnifiedMetadataKey.DISC_NUMBER: None})
+
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) is None
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) 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_disc_number_already_none(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.DISC_NUMBER: None})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) is None
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_TOTAL) is None
+
+    def test_delete_disc_number_zero(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.DISC_NUMBER: 0}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) == 0
+            update_metadata(test_file, {UnifiedMetadataKey.DISC_NUMBER: None})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.DISC_NUMBER) is None