audiometa-python 0.8.0__tar.gz → 0.8.1__tar.gz

{audiometa_python-0.8.0/audiometa_python.egg-info → audiometa_python-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audiometa-python
-Version: 0.8.0
+Version: 0.8.1
 Summary: A comprehensive Python library for reading and writing audio metadata across multiple formats
 Author: AudioMeta Python Contributors
 Author-email: Andreas Garcia <garcia.andreas.1991@gmail.com>
@@ -41,29 +41,29 @@ Requires-Dist: PyYAML==6.0; extra == "yaml"
 Dynamic: license-file
 
 <div align="center">
-  <img src="https://raw.githubusercontent.com/Andreas-Garcia/audiometa/main/assets/logo.png" alt="AudioMeta Logo" width="200"/>
+  <img src="https://raw.githubusercontent.com/BehindTheMusicTree/audiometa/main/assets/logo.png" alt="AudioMeta Logo" width="200"/>
 </div>
 
 # AudioMeta Python
 
-[![CI](https://github.com/Andreas-Garcia/audiometa/actions/workflows/ci.yml/badge.svg)](https://github.com/Andreas-Garcia/audiometa/actions/workflows/ci.yml)
+[![CI](https://github.com/BehindTheMusicTree/audiometa/actions/workflows/ci.yml/badge.svg)](https://github.com/BehindTheMusicTree/audiometa/actions/workflows/ci.yml)
 [![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](LICENSE)
 [![PyPI version](https://img.shields.io/pypi/v/audiometa-python)](https://pypi.org/project/audiometa-python/)
 [![Downloads](https://img.shields.io/pepy/dt/audiometa-python)](https://pepy.tech/project/audiometa-python)
-[![GitHub stars](https://img.shields.io/github/stars/Andreas-Garcia/audiometa?style=social)](https://github.com/Andreas-Garcia/audiometa/stargazers)
+[![GitHub stars](https://img.shields.io/github/stars/BehindTheMusicTree/audiometa?style=social)](https://github.com/BehindTheMusicTree/audiometa/stargazers)
 
 A powerful, unified Python library for reading and writing audio metadata across multiple formats. AudioMeta supports MP3, FLAC, and WAV audio files, working seamlessly with ID3v1, ID3v2, Vorbis, and RIFF metadata formats through a single, consistent API.
 
-**Author**: [Andreas Garcia](https://github.com/Andreas-Garcia)
+**Author**: [Andreas Garcia](https://github.com/BehindTheMusicTree)
 
 ## ⭐ Show Your Support
 
 If you find AudioMeta Python useful, please consider:
 
 - ⭐ **Starring this repository** - It helps others discover the project
-- 🐛 **Reporting bugs** - Help improve the library by [opening an issue](https://github.com/Andreas-Garcia/audiometa/issues)
-- 💡 **Suggesting features** - Share your ideas via [GitHub Discussions](https://github.com/Andreas-Garcia/audiometa/discussions) or [feature requests](https://github.com/Andreas-Garcia/audiometa/issues)
+- 🐛 **Reporting bugs** - Help improve the library by [opening an issue](https://github.com/BehindTheMusicTree/audiometa/issues)
+- 💡 **Suggesting features** - Share your ideas via [GitHub Discussions](https://github.com/BehindTheMusicTree/audiometa/discussions) or [feature requests](https://github.com/BehindTheMusicTree/audiometa/issues)
 - 🤝 **Contributing** - See [CONTRIBUTING.md](CONTRIBUTING.md) for ways to help
 - 📢 **Sharing** - Tell others about AudioMeta Python
 
@@ -111,7 +111,7 @@ Your support helps make this project better for everyone! 🎵
 - [📝 Changelog](#-changelog)
 - [🤝 Contributing](#-contributing)
 - [Code of Conduct](CODE_OF_CONDUCT.md)
-- [Security Policy](https://github.com/Andreas-Garcia/audiometa/security/policy)
+- [Security Policy](https://github.com/BehindTheMusicTree/audiometa/security/policy)
 - [License](#license)
 
 ## ✨ Features
@@ -1561,11 +1561,11 @@ Whether you're fixing bugs, adding features, improving documentation, or sharing
 
 **Ways to contribute:**
 
-- 🐛 **Report bugs** - Use the [bug report template](https://github.com/Andreas-Garcia/audiometa/issues/new?template=bug_report.yml)
-- 💡 **Suggest features** - Use the [feature request template](https://github.com/Andreas-Garcia/audiometa/issues/new?template=feature_request.yml)
+- 🐛 **Report bugs** - Use the [bug report template](https://github.com/BehindTheMusicTree/audiometa/issues/new?template=bug_report.yml)
+- 💡 **Suggest features** - Use the [feature request template](https://github.com/BehindTheMusicTree/audiometa/issues/new?template=feature_request.yml)
 - 🔧 **Submit pull requests** - See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines
 - 📝 **Improve documentation** - Fix typos, clarify explanations, add examples
-- 💬 **Join discussions** - Share ideas and help others in [GitHub Discussions](https://github.com/Andreas-Garcia/audiometa/discussions)
+- 💬 **Join discussions** - Share ideas and help others in [GitHub Discussions](https://github.com/BehindTheMusicTree/audiometa/discussions)
 - ⭐ **Star the repo** - Help others discover the project
 
 For detailed contribution guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).

{audiometa_python-0.8.0 → audiometa_python-0.8.1}/README.md

@@ -1,27 +1,27 @@
 <div align="center">
-  <img src="https://raw.githubusercontent.com/Andreas-Garcia/audiometa/main/assets/logo.png" alt="AudioMeta Logo" width="200"/>
+  <img src="https://raw.githubusercontent.com/BehindTheMusicTree/audiometa/main/assets/logo.png" alt="AudioMeta Logo" width="200"/>
 </div>
 
 # AudioMeta Python
 
-[![CI](https://github.com/Andreas-Garcia/audiometa/actions/workflows/ci.yml/badge.svg)](https://github.com/Andreas-Garcia/audiometa/actions/workflows/ci.yml)
+[![CI](https://github.com/BehindTheMusicTree/audiometa/actions/workflows/ci.yml/badge.svg)](https://github.com/BehindTheMusicTree/audiometa/actions/workflows/ci.yml)
 [![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](LICENSE)
 [![PyPI version](https://img.shields.io/pypi/v/audiometa-python)](https://pypi.org/project/audiometa-python/)
 [![Downloads](https://img.shields.io/pepy/dt/audiometa-python)](https://pepy.tech/project/audiometa-python)
-[![GitHub stars](https://img.shields.io/github/stars/Andreas-Garcia/audiometa?style=social)](https://github.com/Andreas-Garcia/audiometa/stargazers)
+[![GitHub stars](https://img.shields.io/github/stars/BehindTheMusicTree/audiometa?style=social)](https://github.com/BehindTheMusicTree/audiometa/stargazers)
 
 A powerful, unified Python library for reading and writing audio metadata across multiple formats. AudioMeta supports MP3, FLAC, and WAV audio files, working seamlessly with ID3v1, ID3v2, Vorbis, and RIFF metadata formats through a single, consistent API.
 
-**Author**: [Andreas Garcia](https://github.com/Andreas-Garcia)
+**Author**: [Andreas Garcia](https://github.com/BehindTheMusicTree)
 
 ## ⭐ Show Your Support
 
 If you find AudioMeta Python useful, please consider:
 
 - ⭐ **Starring this repository** - It helps others discover the project
-- 🐛 **Reporting bugs** - Help improve the library by [opening an issue](https://github.com/Andreas-Garcia/audiometa/issues)
-- 💡 **Suggesting features** - Share your ideas via [GitHub Discussions](https://github.com/Andreas-Garcia/audiometa/discussions) or [feature requests](https://github.com/Andreas-Garcia/audiometa/issues)
+- 🐛 **Reporting bugs** - Help improve the library by [opening an issue](https://github.com/BehindTheMusicTree/audiometa/issues)
+- 💡 **Suggesting features** - Share your ideas via [GitHub Discussions](https://github.com/BehindTheMusicTree/audiometa/discussions) or [feature requests](https://github.com/BehindTheMusicTree/audiometa/issues)
 - 🤝 **Contributing** - See [CONTRIBUTING.md](CONTRIBUTING.md) for ways to help
 - 📢 **Sharing** - Tell others about AudioMeta Python
 
@@ -69,7 +69,7 @@ Your support helps make this project better for everyone! 🎵
 - [📝 Changelog](#-changelog)
 - [🤝 Contributing](#-contributing)
 - [Code of Conduct](CODE_OF_CONDUCT.md)
-- [Security Policy](https://github.com/Andreas-Garcia/audiometa/security/policy)
+- [Security Policy](https://github.com/BehindTheMusicTree/audiometa/security/policy)
 - [License](#license)
 
 ## ✨ Features
@@ -1519,11 +1519,11 @@ Whether you're fixing bugs, adding features, improving documentation, or sharing
 
 **Ways to contribute:**
 
-- 🐛 **Report bugs** - Use the [bug report template](https://github.com/Andreas-Garcia/audiometa/issues/new?template=bug_report.yml)
-- 💡 **Suggest features** - Use the [feature request template](https://github.com/Andreas-Garcia/audiometa/issues/new?template=feature_request.yml)
+- 🐛 **Report bugs** - Use the [bug report template](https://github.com/BehindTheMusicTree/audiometa/issues/new?template=bug_report.yml)
+- 💡 **Suggest features** - Use the [feature request template](https://github.com/BehindTheMusicTree/audiometa/issues/new?template=feature_request.yml)
 - 🔧 **Submit pull requests** - See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines
 - 📝 **Improve documentation** - Fix typos, clarify explanations, add examples
-- 💬 **Join discussions** - Share ideas and help others in [GitHub Discussions](https://github.com/Andreas-Garcia/audiometa/discussions)
+- 💬 **Join discussions** - Share ideas and help others in [GitHub Discussions](https://github.com/BehindTheMusicTree/audiometa/discussions)
 - ⭐ **Star the repo** - Help others discover the project
 
 For detailed contribution guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).

{audiometa_python-0.8.0 → audiometa_python-0.8.1}/audiometa/__init__.py

@@ -830,6 +830,28 @@ def _handle_metadata_strategy(
         # Then sync all other available formats
         # Note: We need to be careful about the order to avoid conflicts
         for fmt_name, manager in other_managers.items():
+            # Check if this format has existing metadata (for SYNC strategy)
+            has_existing = False
+            if fmt_name == "id3v1":
+                has_existing = audio_file._has_id3v1_tags()
+            elif fmt_name == "id3v2":
+                # Check if file starts with ID3
+                try:
+                    from pathlib import Path
+
+                    with Path(audio_file.file_path).open("rb") as f:
+                        header = f.read(3)
+                        has_existing = header == b"ID3"
+                except Exception:
+                    has_existing = False
+            elif fmt_name == "vorbis":
+                has_existing = audio_file.file_extension == ".flac"  # Vorbis is native for FLAC
+            elif fmt_name == "riff":
+                has_existing = audio_file.file_extension == ".wav"  # RIFF is native for WAV
+
+            if not has_existing:
+                continue
+
             # For non-target formats, filter out unsupported fields and warn about them
             # This allows syncing supported fields even when some fields are not supported
             unsupported_fields = []

{audiometa_python-0.8.0 → audiometa_python-0.8.1}/audiometa/test/tests/e2e/workflows/test_format_specific_workflows.py

@@ -6,8 +6,18 @@ capabilities and limitations.
 
 import pytest
 
-from audiometa import delete_all_metadata, get_bitrate, get_duration_in_sec, get_unified_metadata, update_metadata
+from audiometa import (
+    FlacMd5State,
+    delete_all_metadata,
+    fix_md5_checking,
+    get_bitrate,
+    get_duration_in_sec,
+    get_unified_metadata,
+    is_flac_md5_valid,
+    update_metadata,
+)
 from audiometa.test.helpers.temp_file_with_metadata import temp_file_with_metadata
+from audiometa.test.tests.integration.technical_info.flac_md5.conftest import corrupt_md5, ensure_flac_has_md5
 from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
 
 
@@ -97,6 +107,54 @@ class TestFormatSpecificWorkflows:
             assert bitrate > 0
             assert duration > 0
 
+    def test_flac_md5_validity_workflow(self):
+        """E2E test for FLAC MD5 validity checking and correction workflow."""
+        # Create a FLAC file with initial metadata
+        initial_metadata = {
+            "title": "MD5 Test FLAC Title",
+            "artist": "MD5 Test FLAC Artist",
+            "album": "MD5 Test FLAC Album",
+        }
+        with temp_file_with_metadata(initial_metadata, "flac") as test_file:
+            # Ensure the file has a valid MD5 checksum
+            ensure_flac_has_md5(test_file)
+
+            # 1. Verify initial MD5 is valid
+            initial_md5_state = is_flac_md5_valid(test_file)
+            assert initial_md5_state == FlacMd5State.VALID, "Initial FLAC file should have valid MD5"
+
+            # 2. Corrupt the MD5 checksum
+            corrupt_md5(test_file, "random")
+
+            # 3. Verify MD5 is now invalid
+            corrupted_md5_state = is_flac_md5_valid(test_file)
+            assert corrupted_md5_state == FlacMd5State.INVALID, "Corrupted MD5 should be detected as invalid"
+
+            # 4. Correct the MD5 checksum
+            corrected_file_path = fix_md5_checking(test_file)
+
+            # 5. Verify the corrected file has valid MD5
+            corrected_md5_state = is_flac_md5_valid(corrected_file_path)
+            assert corrected_md5_state == FlacMd5State.VALID, "Corrected file should have valid MD5"
+
+            # 6. Update metadata on the corrected file
+            test_metadata = {
+                UnifiedMetadataKey.TITLE: "Updated MD5 Test Title",
+                UnifiedMetadataKey.ARTISTS: ["Updated MD5 Test Artist"],
+                UnifiedMetadataKey.ALBUM: "Updated MD5 Test Album",
+            }
+            update_metadata(corrected_file_path, test_metadata)
+
+            # 7. Verify metadata was updated
+            updated_metadata = get_unified_metadata(corrected_file_path)
+            assert updated_metadata.get(UnifiedMetadataKey.TITLE) == "Updated MD5 Test Title"
+            assert updated_metadata.get(UnifiedMetadataKey.ARTISTS) == ["Updated MD5 Test Artist"]
+            assert updated_metadata.get(UnifiedMetadataKey.ALBUM) == "Updated MD5 Test Album"
+
+            # 8. Verify MD5 is still valid after metadata update
+            final_md5_state = is_flac_md5_valid(corrected_file_path)
+            assert final_md5_state == FlacMd5State.VALID, "MD5 should remain valid after metadata update"
+
     def test_complete_metadata_workflow_wav(self):
         # Use external script to set initial metadata
         initial_metadata = {"title": "Initial WAV Title", "artist": "Initial WAV Artist", "album": "Initial WAV Album"}

audiometa_python-0.8.1/audiometa/test/tests/integration/writing/writing_strategies/sync_strategy/__init__.py

@@ -0,0 +1 @@
+"""SYNC strategy tests organized by file extension."""

audiometa_python-0.8.1/audiometa/test/tests/integration/writing/writing_strategies/sync_strategy/test_flac_sync.py

@@ -0,0 +1,306 @@
+"""Tests for SYNC metadata writing strategy on FLAC files.
+
+This module tests the SYNC strategy which writes to native format (Vorbis) and synchronizes other metadata formats
+that are already present (ID3v1, ID3v2).
+"""
+
+import pytest
+
+from audiometa import get_unified_metadata, update_metadata
+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.metadata_writing_strategy import MetadataWritingStrategy
+from audiometa.utils.unified_metadata_key import UnifiedMetadataKey
+
+
+@pytest.mark.integration
+class TestFlacSyncStrategy:
+    def test_flac_no_metadata_sync(self):
+        """Test SYNC strategy on FLAC file with no existing metadata.
+
+        SYNC should write to Vorbis (native) but NOT create ID3v1 or ID3v2.
+        """
+        with temp_file_with_metadata({}, "flac") as test_file:
+            # File starts with no metadata
+            flac_metadata = {
+                UnifiedMetadataKey.TITLE: "FLAC Title",
+                UnifiedMetadataKey.ARTISTS: ["FLAC Artist"],
+                UnifiedMetadataKey.ALBUM: "FLAC Album",
+            }
+            update_metadata(test_file, flac_metadata, metadata_strategy=MetadataWritingStrategy.SYNC)
+
+            # Verify Vorbis metadata was written
+            vorbis_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_after.get(UnifiedMetadataKey.TITLE) == "FLAC Title"
+            assert vorbis_after.get(UnifiedMetadataKey.ARTISTS) == ["FLAC Artist"]
+            assert vorbis_after.get(UnifiedMetadataKey.ALBUM) == "FLAC Album"
+
+            # Verify ID3v1 was NOT created
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+
+            # Verify ID3v2 was NOT created
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+
+            # Merged metadata should show Vorbis values
+            merged = get_unified_metadata(test_file)
+            assert merged.get(UnifiedMetadataKey.TITLE) == "FLAC Title"
+
+    def test_flac_vorbis_only_sync(self):
+        """Test SYNC strategy on FLAC file with only Vorbis metadata.
+
+        SYNC should write to Vorbis (native) but NOT create ID3v1 or ID3v2.
+        """
+        with temp_file_with_metadata(
+            {"title": "Initial Title", "artist": "Initial Artist", "album": "Initial Album"}, "flac"
+        ) as test_file:
+            # File has Vorbis metadata
+            vorbis_initial = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_initial.get(UnifiedMetadataKey.TITLE) == "Initial Title"
+
+            # Now write Vorbis metadata with SYNC strategy
+            vorbis_metadata = {
+                UnifiedMetadataKey.TITLE: "Updated Title",
+                UnifiedMetadataKey.ARTISTS: ["Updated Artist"],
+                UnifiedMetadataKey.ALBUM: "Updated Album",
+            }
+            update_metadata(test_file, vorbis_metadata, metadata_strategy=MetadataWritingStrategy.SYNC)
+
+            # Verify Vorbis metadata was updated
+            vorbis_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_after.get(UnifiedMetadataKey.TITLE) == "Updated Title"
+
+            # Verify ID3v1 was NOT created
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+
+            # Verify ID3v2 was NOT created
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+
+            # Merged metadata should show updated Vorbis values
+            merged = get_unified_metadata(test_file)
+            assert merged.get(UnifiedMetadataKey.TITLE) == "Updated Title"
+
+    def test_flac_id3v1_only_sync(self):
+        """Test SYNC strategy on FLAC file with only ID3v1 metadata.
+
+        SYNC should write to Vorbis (native) and sync to ID3v1 (existing).
+        """
+        with temp_file_with_metadata({}, "flac") as test_file:
+            # Add ID3v1 metadata using external tools
+            ID3v1MetadataSetter.set_metadata(
+                test_file, {"title": "ID3v1 Title", "artist": "ID3v1 Artist", "album": "ID3v1 Album"}
+            )
+
+            # Verify ID3v1 metadata was written
+            id3v1_result = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_result.get(UnifiedMetadataKey.TITLE) == "ID3v1 Title"
+
+            # Now write Vorbis metadata with SYNC strategy
+            vorbis_metadata = {
+                UnifiedMetadataKey.TITLE: "Synced Title",
+                UnifiedMetadataKey.ARTISTS: ["Synced Artist"],
+                UnifiedMetadataKey.ALBUM: "Synced Album",
+            }
+            update_metadata(test_file, vorbis_metadata, metadata_strategy=MetadataWritingStrategy.SYNC)
+
+            # Verify Vorbis metadata was written
+            vorbis_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v1 metadata was synced (overwritten)
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v2 was NOT created
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+
+            # Merged metadata should prefer Vorbis (higher precedence)
+            merged = get_unified_metadata(test_file)
+            assert merged.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+    def test_flac_id3v2_only_sync(self):
+        """Test SYNC strategy on FLAC file with only ID3v2 metadata.
+
+        SYNC should write to Vorbis (native) and sync to ID3v2 (existing).
+        """
+        with temp_file_with_metadata({}, "flac") as test_file:
+            # Add ID3v2 metadata using external tools
+            ID3v2MetadataSetter.set_metadata(
+                test_file,
+                {"title": "ID3v2 Title", "artist": "ID3v2 Artist", "album": "ID3v2 Album"},
+                version="2.3",
+            )
+
+            # Verify ID3v2 metadata was written
+            id3v2_result = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_result.get(UnifiedMetadataKey.TITLE) == "ID3v2 Title"
+
+            # Now write Vorbis metadata with SYNC strategy
+            vorbis_metadata = {
+                UnifiedMetadataKey.TITLE: "Synced Title",
+                UnifiedMetadataKey.ARTISTS: ["Synced Artist"],
+                UnifiedMetadataKey.ALBUM: "Synced Album",
+            }
+            update_metadata(test_file, vorbis_metadata, metadata_strategy=MetadataWritingStrategy.SYNC)
+
+            # Verify Vorbis metadata was written
+            vorbis_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v2 metadata was synced (overwritten)
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v1 was NOT created
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+
+            # Merged metadata should prefer Vorbis (higher precedence)
+            merged = get_unified_metadata(test_file)
+            assert merged.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+    def test_flac_vorbis_plus_id3v1_sync(self):
+        """Test SYNC strategy on FLAC file with Vorbis and ID3v1 metadata.
+
+        SYNC should write to Vorbis (native) and sync to ID3v1 (existing).
+        """
+        with temp_file_with_metadata(
+            {"title": "Vorbis Title", "artist": "Vorbis Artist", "album": "Vorbis Album"}, "flac"
+        ) as test_file:
+            # Add ID3v1 metadata using external tools
+            ID3v1MetadataSetter.set_metadata(
+                test_file, {"title": "ID3v1 Title", "artist": "ID3v1 Artist", "album": "ID3v1 Album"}
+            )
+
+            # Verify both formats have metadata
+            vorbis_result = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_result.get(UnifiedMetadataKey.TITLE) == "Vorbis Title"
+            id3v1_result = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_result.get(UnifiedMetadataKey.TITLE) == "ID3v1 Title"
+
+            # Now write Vorbis metadata with SYNC strategy
+            sync_metadata = {
+                UnifiedMetadataKey.TITLE: "Synced Title",
+                UnifiedMetadataKey.ARTISTS: ["Synced Artist"],
+                UnifiedMetadataKey.ALBUM: "Synced Album",
+            }
+            update_metadata(test_file, sync_metadata, metadata_strategy=MetadataWritingStrategy.SYNC)
+
+            # Verify Vorbis metadata was updated
+            vorbis_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v1 metadata was synced
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v2 was NOT created
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) is None
+
+            # Merged metadata should prefer Vorbis
+            merged = get_unified_metadata(test_file)
+            assert merged.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+    def test_flac_vorbis_plus_id3v2_sync(self):
+        """Test SYNC strategy on FLAC file with Vorbis and ID3v2 metadata.
+
+        SYNC should write to Vorbis (native) and sync to ID3v2 (existing).
+        """
+        with temp_file_with_metadata(
+            {"title": "Vorbis Title", "artist": "Vorbis Artist", "album": "Vorbis Album"}, "flac"
+        ) as test_file:
+            # Add ID3v2 metadata using external tools
+            ID3v2MetadataSetter.set_metadata(
+                test_file,
+                {"title": "ID3v2 Title", "artist": "ID3v2 Artist", "album": "ID3v2 Album"},
+                version="2.3",
+            )
+
+            # Verify both formats have metadata
+            vorbis_result = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_result.get(UnifiedMetadataKey.TITLE) == "Vorbis Title"
+            id3v2_result = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_result.get(UnifiedMetadataKey.TITLE) == "ID3v2 Title"
+
+            # Now write Vorbis metadata with SYNC strategy
+            sync_metadata = {
+                UnifiedMetadataKey.TITLE: "Synced Title",
+                UnifiedMetadataKey.ARTISTS: ["Synced Artist"],
+                UnifiedMetadataKey.ALBUM: "Synced Album",
+            }
+            update_metadata(test_file, sync_metadata, metadata_strategy=MetadataWritingStrategy.SYNC)
+
+            # Verify Vorbis metadata was updated
+            vorbis_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v2 metadata was synced
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v1 was NOT created
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) is None
+
+            # Merged metadata should prefer Vorbis
+            merged = get_unified_metadata(test_file)
+            assert merged.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+    def test_flac_all_formats_sync(self):
+        """Test SYNC strategy on FLAC file with Vorbis, ID3v1, and ID3v2 metadata.
+
+        SYNC should write to Vorbis (native) and sync to ID3v1 and ID3v2 (existing).
+        """
+        with temp_file_with_metadata(
+            {"title": "Vorbis Title", "artist": "Vorbis Artist", "album": "Vorbis Album"}, "flac"
+        ) as test_file:
+            # Add ID3v1 metadata using external tools
+            ID3v1MetadataSetter.set_metadata(
+                test_file, {"title": "ID3v1 Title", "artist": "ID3v1 Artist", "album": "ID3v1 Album"}
+            )
+
+            # Add ID3v2 metadata using external tools
+            ID3v2MetadataSetter.set_metadata(
+                test_file,
+                {"title": "ID3v2 Title", "artist": "ID3v2 Artist", "album": "ID3v2 Album"},
+                version="2.3",
+            )
+
+            # Verify all formats have metadata
+            vorbis_result = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_result.get(UnifiedMetadataKey.TITLE) == "Vorbis Title"
+            id3v1_result = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_result.get(UnifiedMetadataKey.TITLE) == "ID3v1 Title"
+            id3v2_result = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_result.get(UnifiedMetadataKey.TITLE) == "ID3v2 Title"
+
+            # Now write Vorbis metadata with SYNC strategy
+            sync_metadata = {
+                UnifiedMetadataKey.TITLE: "Synced Title",
+                UnifiedMetadataKey.ARTISTS: ["Synced Artist"],
+                UnifiedMetadataKey.ALBUM: "Synced Album",
+            }
+            update_metadata(test_file, sync_metadata, metadata_strategy=MetadataWritingStrategy.SYNC)
+
+            # Verify Vorbis metadata was updated
+            vorbis_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.VORBIS)
+            assert vorbis_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v1 metadata was synced
+            id3v1_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V1)
+            assert id3v1_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Verify ID3v2 metadata was synced
+            id3v2_after = get_unified_metadata(test_file, metadata_format=MetadataFormat.ID3V2)
+            assert id3v2_after.get(UnifiedMetadataKey.TITLE) == "Synced Title"
+
+            # Merged metadata should prefer Vorbis
+            merged = get_unified_metadata(test_file)
+            assert merged.get(UnifiedMetadataKey.TITLE) == "Synced Title"