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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audiometa-python
-Version: 0.8.0
+Version: 0.9.0
 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.9.0}/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.9.0}/audiometa/__init__.py

@@ -226,10 +226,11 @@ def get_unified_metadata_field(
         The metadata value or None if not found
 
     Raises:
+        MetadataFieldNotSupportedByLibError: When the key is not a valid UnifiedMetadataKey
+            (neither an enum instance nor a string matching an enum value)
         MetadataFieldNotSupportedByMetadataFormatError: When metadata_format is specified and the field
-            is not supported by that format
-        MetadataFieldNotSupportedByLibError: When the field is not supported by any format in the library
-            (only when metadata_format is None and all formats raise MetadataFieldNotSupportedByMetadataFormatError)
+            is not supported by that format, or when metadata_format is None and the field is not supported
+            by any of the file's available metadata formats
 
     Examples:
         # Get title from any format (priority order)
@@ -296,10 +297,11 @@ def get_unified_metadata_field(
                 continue
 
         # If ALL managers raised MetadataFieldNotSupportedByMetadataFormatError,
-        # the field is not supported by the library at all
+        # the field is not supported by any of the file's formats
         if len(format_errors) == len(managers_prioritized) and len(format_errors) > 0:
-            msg = f"{unified_metadata_key} metadata field is not supported by any format in the library"
-            raise MetadataFieldNotSupportedByLibError(msg)
+            # Re-raise the first format-specific error to indicate the field is not supported
+            # by any format available for this file
+            raise format_errors[0][1]
 
         return None
 
@@ -830,6 +832,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.9.0}/audiometa/cli.py

@@ -186,6 +186,8 @@ def _write_metadata(args: argparse.Namespace) -> None:
         metadata[UnifiedMetadataKey.UNSYNCHRONIZED_LYRICS] = args.lyrics
     if args.comment and args.comment.strip():
         metadata[UnifiedMetadataKey.COMMENT] = args.comment
+    if args.description and args.description.strip():
+        metadata[UnifiedMetadataKey.DESCRIPTION] = args.description
     if args.replaygain and args.replaygain.strip():
         metadata[UnifiedMetadataKey.REPLAYGAIN] = args.replaygain
     if args.archival_location and args.archival_location.strip():
@@ -429,6 +431,7 @@ Examples:
     write_parser.add_argument("--copyright", help="Copyright information")
     write_parser.add_argument("--lyrics", help="Unsynchronized lyrics text")
     write_parser.add_argument("--comment", help="Comment")
+    write_parser.add_argument("--description", help="Description")
     write_parser.add_argument("--replaygain", help="ReplayGain information")
     write_parser.add_argument("--archival-location", help="Archival location")
     write_parser.add_argument("--isrc", help="International Standard Recording Code (12 characters)")