audiometa-python 0.6.0__py3-none-any.whl

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

@@ -0,0 +1,73 @@
+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 TestTitleDeleting:
+    def test_delete_title_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_title(test_file, "Test Title")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) == "Test Title"
+
+            # Delete metadata using library API
+            update_metadata(test_file, {UnifiedMetadataKey.TITLE: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) is None
+
+    def test_delete_title_id3v1(self):
+        with temp_file_with_metadata({}, "id3v1") as test_file:
+            ID3v1MetadataSetter.set_title(test_file, "Test Title")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) == "Test Title"
+
+            # Delete metadata using library API
+            update_metadata(test_file, {UnifiedMetadataKey.TITLE: None}, metadata_format=MetadataFormat.ID3V1)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) is None
+
+    def test_delete_title_riff(self):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            RIFFMetadataSetter.set_title(test_file, "Test Title")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) == "Test Title"
+
+            # Delete metadata using library API
+            update_metadata(test_file, {UnifiedMetadataKey.TITLE: None}, metadata_format=MetadataFormat.RIFF)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) is None
+
+    def test_delete_title_vorbis(self):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            VorbisMetadataSetter.add_title(test_file, "Test Title")
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) == "Test Title"
+
+            # Delete metadata using library API
+            update_metadata(test_file, {UnifiedMetadataKey.TITLE: None}, metadata_format=MetadataFormat.VORBIS)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) is None
+
+    def test_delete_title_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_title(test_file, "Test Title")
+            ID3v2MetadataSetter.set_artists(test_file, "Test Artist")
+            ID3v2MetadataSetter.set_album(test_file, "Test Album")
+
+            # Delete only title using library API
+            update_metadata(test_file, {UnifiedMetadataKey.TITLE: None}, metadata_format=MetadataFormat.ID3V2)
+
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) is None
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ARTISTS) == ["Test Artist"]
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.ALBUM) == "Test Album"
+
+    def test_delete_title_already_none(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            # Try to delete title that doesn't exist
+            update_metadata(test_file, {UnifiedMetadataKey.TITLE: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) is None
+
+    def test_delete_title_empty_string(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.TITLE: ""}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE) is None

audiometa/test/tests/integration/metadata_field/title/test_error_handling.py

@@ -0,0 +1,47 @@
+from pathlib import Path
+
+import pytest
+
+from audiometa import get_unified_metadata_field, update_metadata
+from audiometa.exceptions import FileTypeNotSupportedError
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestTitleErrorHandling:
+    def test_title_unsupported_file_type(self):
+        with temp_file_with_metadata({}, "mp3") as temp_file_path:
+            temp_file_path.write_bytes(b"fake audio content")
+            temp_txt = temp_file_path.with_suffix(".txt")
+            temp_txt.write_bytes(b"fake audio content")
+
+            with pytest.raises(FileTypeNotSupportedError):
+                get_unified_metadata_field(str(temp_txt), UnifiedMetadataKey.TITLE)
+
+            with pytest.raises(FileTypeNotSupportedError):
+                update_metadata(str(temp_txt), {UnifiedMetadataKey.TITLE: "Test Title"})
+
+    def test_title_nonexistent_file(self):
+        nonexistent_file = "nonexistent_file.mp3"
+
+        with pytest.raises(FileNotFoundError):
+            get_unified_metadata_field(nonexistent_file, UnifiedMetadataKey.TITLE)
+
+        with pytest.raises(FileNotFoundError):
+            update_metadata(nonexistent_file, {UnifiedMetadataKey.TITLE: "Test Title"})
+
+    def test_title_empty_values(self, sample_mp3_file: Path):
+        # Test with empty title values using temp file with sample content
+        with temp_file_with_metadata({}, "mp3") as temp_file_path:
+            temp_file_path.write_bytes(sample_mp3_file.read_bytes())
+
+            # Empty string should be handled gracefully
+            update_metadata(temp_file_path, {UnifiedMetadataKey.TITLE: ""})
+            title = get_unified_metadata_field(temp_file_path, UnifiedMetadataKey.TITLE)
+            assert title == "" or title is None
+
+            # None should be handled gracefully
+            update_metadata(temp_file_path, {UnifiedMetadataKey.TITLE: None})
+            title = get_unified_metadata_field(temp_file_path, UnifiedMetadataKey.TITLE)
+            assert title is None or title == ""

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

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

@@ -0,0 +1,64 @@
+"""Tests for writing title metadata using external scripts.
+
+This refactored version uses external scripts instead of the app's update functions to prevent circular dependencies in
+tests.
+"""
+
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestTitleWriting:
+    def test_id3v2(self):
+        test_title = "Test Title ID3v2"
+        test_metadata = {"title": test_title}
+
+        # Use external script to set metadata instead of app's update function
+        with temp_file_with_metadata(test_metadata, "mp3") as test_file:
+            # Now test that our reading logic works correctly
+            title = get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE)
+            assert title == test_title
+
+    def test_riff(self):
+        test_title = "Test Title RIFF"
+        test_metadata = {"title": test_title}
+
+        # Use external script to set metadata instead of app's update function
+        with temp_file_with_metadata(test_metadata, "wav") as test_file:
+            # Now test that our reading logic works correctly
+            title = get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE)
+            assert title == test_title
+
+    def test_vorbis(self):
+        test_title = "Test Title Vorbis"
+        test_metadata = {"title": test_title}
+
+        # Use external script to set metadata instead of app's update function
+        with temp_file_with_metadata(test_metadata, "flac") as test_file:
+            # Now test that our reading logic works correctly
+            title = get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE)
+            assert title == test_title
+
+    def test_id3v1(self):
+        from audiometa import update_metadata
+        from audiometa.utils.metadata_format import MetadataFormat
+
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_title = "Test Title ID3v1"
+            test_metadata = {UnifiedMetadataKey.TITLE: test_title}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V1)
+            title = get_unified_metadata_field(test_file, UnifiedMetadataKey.TITLE)
+            assert title == test_title
+
+    def test_invalid_type_raises(self):
+        from audiometa import update_metadata
+        from audiometa.exceptions import InvalidMetadataFieldTypeError
+
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            bad_metadata = {UnifiedMetadataKey.TITLE: 123}
+            with pytest.raises(InvalidMetadataFieldTypeError):
+                update_metadata(test_file, bad_metadata)

audiometa/test/tests/integration/metadata_field/track_number/reading/test_edge_cases.py

@@ -0,0 +1,43 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestTrackNumberReadingEdgeCases:
+    def test_trailing_slash(self):
+        with temp_file_with_metadata({"track_number": "5/"}, "mp3") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == "5/"
+
+    def test_leading_slash_no_track(self):
+        with temp_file_with_metadata({"track_number": "/12"}, "mp3") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number is None
+
+    def test_non_numeric_values(self):
+        with temp_file_with_metadata({"track_number": "abc/def"}, "mp3") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number is None
+
+    def test_empty_string(self):
+        with temp_file_with_metadata({"track_number": ""}, "mp3") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number is None
+
+    def test_multiple_slashes(self):
+        with temp_file_with_metadata({"track_number": "5/12/15"}, "mp3") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number is None
+
+    def test_different_separator(self):
+        with temp_file_with_metadata({"track_number": "5-12"}, "mp3") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == "5-12"
+
+    def test_leading_zeros_preserved(self):
+        with temp_file_with_metadata({"track_number": "01"}, "mp3") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == "01"

audiometa/test/tests/integration/metadata_field/track_number/reading/test_metadata_format.py

@@ -0,0 +1,32 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.test.helpers.id3v1.id3v1_metadata_getter import ID3v1MetadataGetter
+from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestTrackNumberReading:
+    def test_id3v1_1(self):
+        with temp_file_with_metadata({"title": "Test Song", "track": "99"}, "id3v1") as test_file:
+            raw_metadata = ID3v1MetadataGetter.get_raw_metadata(test_file)
+            assert raw_metadata.get("track") == 99
+
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == "99"
+
+    def test_id3v2(self):
+        with temp_file_with_metadata({"title": "Test Song", "track_number": "99/99"}, "mp3") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == "99/99"
+
+    def test_vorbis(self):
+        with temp_file_with_metadata({"title": "Test Song", "track_number": "99"}, "flac") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == "99"
+
+    def test_riff(self):
+        with temp_file_with_metadata({"title": "Test Song", "track_number": None}, "wav") as test_file:
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number is None

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

@@ -0,0 +1,59 @@
+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 TestTrackNumberDeleting:
+    def test_delete_track_number_id3v2(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.TRACK_NUMBER: 5}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER) == "5"
+
+            update_metadata(test_file, {UnifiedMetadataKey.TRACK_NUMBER: None}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER) is None
+
+    def test_delete_track_number_id3v1(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.TRACK_NUMBER: 3}, metadata_format=MetadataFormat.ID3V1)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER) == "3"
+
+            update_metadata(test_file, {UnifiedMetadataKey.TRACK_NUMBER: None}, metadata_format=MetadataFormat.ID3V1)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER) is None
+
+    def test_delete_track_number_preserves_other_fields(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(
+                test_file,
+                {
+                    UnifiedMetadataKey.TRACK_NUMBER: 7,
+                    UnifiedMetadataKey.TITLE: "Test Title",
+                    UnifiedMetadataKey.ARTISTS: ["Test Artist"],
+                },
+            )
+
+            update_metadata(test_file, {UnifiedMetadataKey.TRACK_NUMBER: None})
+
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER) 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_track_number_already_none(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.TRACK_NUMBER: None})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER) is None
+
+    def test_delete_track_number_zero(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.TRACK_NUMBER: 0})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER) == "0"
+            update_metadata(test_file, {UnifiedMetadataKey.TRACK_NUMBER: None})
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER) is None
+
+    def test_delete_track_number_empty_string(self):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            update_metadata(test_file, {UnifiedMetadataKey.TRACK_NUMBER: ""}, metadata_format=MetadataFormat.ID3V2)
+            assert get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER) is None

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

@@ -0,0 +1,73 @@
+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 TestTrackNumberWriting:
+    @pytest.mark.parametrize(
+        ("input_value", "expected"),
+        [
+            (5, "5"),
+            ("5", "5"),
+            ("5/12", "5"),
+            ("99/99", "99"),
+        ],
+    )
+    def test_id3v1_track_number_writing(self, input_value, expected):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_metadata = {UnifiedMetadataKey.TRACK_NUMBER: input_value}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V1)
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == expected
+
+    @pytest.mark.parametrize(
+        ("input_value", "expected"),
+        [
+            (5, "5"),
+            ("5", "5"),
+            ("5/12", "5/12"),
+            ("99/99", "99/99"),
+        ],
+    )
+    def test_id3v2_track_number_writing(self, input_value, expected):
+        with temp_file_with_metadata({}, "mp3") as test_file:
+            test_metadata = {UnifiedMetadataKey.TRACK_NUMBER: input_value}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.ID3V2)
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == expected
+
+    @pytest.mark.parametrize(
+        ("input_value", "expected"),
+        [
+            (5, "5"),
+            ("5", "5"),
+            ("5/12", "5/12"),
+            ("99/99", "99/99"),
+        ],
+    )
+    def test_riff_track_number_writing(self, input_value, expected):
+        with temp_file_with_metadata({}, "wav") as test_file:
+            test_metadata = {UnifiedMetadataKey.TRACK_NUMBER: input_value}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.RIFF)
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == expected
+
+    @pytest.mark.parametrize(
+        ("input_value", "expected"),
+        [
+            (5, "5"),
+            ("5", "5"),
+            ("5/12", "5/12"),
+            ("99/99", "99/99"),
+        ],
+    )
+    def test_vorbis_track_number_writing(self, input_value, expected):
+        with temp_file_with_metadata({}, "flac") as test_file:
+            test_metadata = {UnifiedMetadataKey.TRACK_NUMBER: input_value}
+            update_metadata(test_file, test_metadata, metadata_format=MetadataFormat.VORBIS)
+            track_number = get_unified_metadata_field(test_file, UnifiedMetadataKey.TRACK_NUMBER)
+            assert track_number == expected

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

@@ -0,0 +1 @@
+"""Tests for multiple entries for the same tag."""

audiometa/test/tests/integration/multiple_values/reading/__init__.py

@@ -0,0 +1 @@
+"""Tests for reading multiple entries for the same tag."""

audiometa/test/tests/integration/multiple_values/reading/metadata_format/__init__.py

@@ -0,0 +1 @@
+"""Tests for reading multiple entries for the same tag in different metadata formats."""

audiometa/test/tests/integration/multiple_values/reading/metadata_format/test_id3v1.py

@@ -0,0 +1,23 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.test.helpers.id3v1.id3v1_metadata_setter import ID3v1MetadataSetter
+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 TestId3v1:
+    def test_semicolon_separated_artists(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "mp3") as test_file:
+            ID3v1MetadataSetter.set_artist(test_file, "Artist One;Artist Two")
+
+            artists = get_unified_metadata_field(
+                test_file, UnifiedMetadataKey.ARTISTS, metadata_format=MetadataFormat.ID3V1
+            )
+
+            assert isinstance(artists, list)
+            assert len(artists) == 2
+            assert "Artist One" in artists
+            assert "Artist Two" in artists

audiometa/test/tests/integration/multiple_values/reading/metadata_format/test_id3v2_3.py

@@ -0,0 +1,92 @@
+import pytest
+
+from audiometa import get_unified_metadata_field
+from audiometa.test.helpers.id3v2 import ID3v2HeaderVerifier
+from audiometa.test.helpers.id3v2.id3v2_metadata_getter import ID3v2MetadataGetter
+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 TestId3v23:
+    def test_semicolon_separated_artists(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_artists(
+                test_file, ["Artist One;Artist Two;Artist Three"], in_separate_frames=False, version="2.3"
+            )
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 3, 0)
+
+            raw_metadata = ID3v2MetadataGetter.get_raw_metadata(test_file, version="2.3")
+            assert raw_metadata["TPE1"] == ["Artist One;Artist Two;Artist Three"]
+
+            artists = get_unified_metadata_field(
+                test_file,
+                unified_metadata_key=UnifiedMetadataKey.ARTISTS,
+                metadata_format=MetadataFormat.ID3V2,
+                id3v2_version=(2, 3, 0),
+            )
+
+            assert isinstance(artists, list)
+            assert len(artists) == 3
+            assert "Artist One" in artists
+            assert "Artist Two" in artists
+            assert "Artist Three" in artists
+
+    def test_multiple_entries(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_artists(test_file, ["One", "Two", "Three"], version="2.3", in_separate_frames=True)
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 3, 0)
+
+            raw_metadata = ID3v2MetadataGetter.get_raw_metadata(test_file, version="2.3")
+            assert raw_metadata["TPE1"] == ["One", "Two", "Three"]
+
+            artists = get_unified_metadata_field(
+                test_file, UnifiedMetadataKey.ARTISTS, metadata_format=MetadataFormat.ID3V2
+            )
+
+            assert isinstance(artists, list)
+            assert len(artists) == 3
+            assert "One" in artists
+            assert "Two" in artists
+            assert "Three" in artists
+
+    def test_mixed_separators_and_multiple_entries(self):
+        with temp_file_with_metadata({"title": "Test Song"}, "id3v2.3") as test_file:
+            ID3v2MetadataSetter.set_artists(
+                test_file, ["Artist 1;Artist 2", "Artist 3"], version="2.3", in_separate_frames=True
+            )
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 3, 0)
+
+            raw_metadata = ID3v2MetadataGetter.get_raw_metadata(test_file, version="2.3")
+            assert raw_metadata["TPE1"] == ["Artist 1;Artist 2", "Artist 3"]
+
+            artists = get_unified_metadata_field(
+                test_file, UnifiedMetadataKey.ARTISTS, metadata_format=MetadataFormat.ID3V2
+            )
+            assert isinstance(artists, list)
+            assert len(artists) == 2
+            assert "Artist 1;Artist 2" in artists
+            assert "Artist 3" in artists
+
+    def test_multiple_title_entries_then_first_one(self):
+        with temp_file_with_metadata({"title": "Initial Title"}, "mp3") as test_file:
+            ID3v2MetadataSetter.set_titles(
+                test_file, ["Title One", "Title Two", "Title Three"], version="2.3", in_separate_frames=True
+            )
+
+            assert ID3v2HeaderVerifier.get_id3v2_version(test_file) == (2, 3, 0)
+
+            raw_metadata = ID3v2MetadataGetter.get_raw_metadata(test_file, version="2.3")
+            assert raw_metadata["TIT2"] == ["Title One", "Title Two", "Title Three"]
+
+            title = get_unified_metadata_field(
+                test_file, UnifiedMetadataKey.TITLE, metadata_format=MetadataFormat.ID3V2
+            )
+
+            assert isinstance(title, str)
+            assert title == "Title One"