audiometa-python 1.2.0__tar.gz → 1.3.0__tar.gz

{audiometa_python-1.2.0/audiometa_python.egg-info → audiometa_python-1.3.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: audiometa-python
-Version: 1.2.0
+Version: 1.3.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>
 License: Apache-2.0
-Project-URL: Homepage, https://github.com/your-username/audiometa-python
-Project-URL: Repository, https://github.com/your-username/audiometa-python
-Project-URL: Issues, https://github.com/your-username/audiometa-python/issues
+Project-URL: Homepage, https://github.com/BehindTheMusicTree/audiometa
+Project-URL: Repository, https://github.com/BehindTheMusicTree/audiometa
+Project-URL: Issues, https://github.com/BehindTheMusicTree/audiometa/issues
 Keywords: audio,metadata,mp3,flac,wav,id3,vorbis,riff
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -1518,6 +1518,9 @@ audiometa read song.mp3 --include-raw-binary-data
 
 # Save to file
 audiometa read song.mp3 --output metadata.json
+
+# Colorize output (headers, keys, values) for terminal or demos
+audiometa read song.mp3 --format table --color
 ```
 
 #### Error Handling {#cli-error-handling}
@@ -1543,6 +1546,8 @@ audiometa read "**/*.mp3" --recursive
 - **YAML**: Human-readable structured format (requires PyYAML)
 - **Table**: Simple text table format
 
+Use `--color` to colorize headers, keys, and values for terminal or demo videos (plain output by default; disabled when writing to a file). Respects the `NO_COLOR` environment variable.
+
 ### Examples
 
 ```bash

{audiometa_python-1.2.0 → audiometa_python-1.3.0}/README.md

@@ -1476,6 +1476,9 @@ audiometa read song.mp3 --include-raw-binary-data
 
 # Save to file
 audiometa read song.mp3 --output metadata.json
+
+# Colorize output (headers, keys, values) for terminal or demos
+audiometa read song.mp3 --format table --color
 ```
 
 #### Error Handling {#cli-error-handling}
@@ -1501,6 +1504,8 @@ audiometa read "**/*.mp3" --recursive
 - **YAML**: Human-readable structured format (requires PyYAML)
 - **Table**: Simple text table format
 
+Use `--color` to colorize headers, keys, and values for terminal or demo videos (plain output by default; disabled when writing to a file). Respects the `NO_COLOR` environment variable.
+
 ### Examples
 
 ```bash

{audiometa_python-1.2.0 → audiometa_python-1.3.0}/audiometa/cli.py

@@ -3,6 +3,8 @@
 
 import argparse
 import json
+import os
+import re
 import sys
 from pathlib import Path
 from typing import Any
@@ -23,20 +25,95 @@ from audiometa.exceptions import (
 from audiometa.utils.metadata_format import MetadataFormat
 from audiometa.utils.types import UnifiedMetadata
 
+_ANSI_RESET = "\033[0m"
+_ANSI_KEY = "\033[32m"  # green
+_ANSI_STR = "\033[33m"  # yellow
+_ANSI_NUM = "\033[36m"  # cyan
+_ANSI_LITERAL = "\033[2m"  # dim
+_ANSI_SECTION = "\033[1;36m"  # bold cyan
+
+
+def _data_for_serialization(data: Any) -> Any:
+    """Convert data to a form suitable for YAML/JSON (UnifiedMetadataKey keys as strings)."""
+    if isinstance(data, dict):
+        return {
+            (k.value if isinstance(k, UnifiedMetadataKey) else k): _data_for_serialization(v) for k, v in data.items()
+        }
+    if isinstance(data, list):
+        return [_data_for_serialization(item) for item in data]
+    return data
+
+
+def _colorize_json(raw: str) -> str:
+    """Add ANSI colors to JSON: keys green, string values yellow, numbers cyan, literals dim."""
+    raw = re.sub(r'("[^"]*")\s*:', rf"{_ANSI_KEY}\1{_ANSI_RESET}:", raw)
+    raw = re.sub(r':\s*("(?:[^"\\]|\\.)*")', rf": {_ANSI_STR}\1{_ANSI_RESET}", raw)
+    raw = re.sub(r":\s*(-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?)", rf": {_ANSI_NUM}\1{_ANSI_RESET}", raw)
+    return re.sub(r"\b(true|false|null)\b", rf"{_ANSI_LITERAL}\1{_ANSI_RESET}", raw)
+
+
+def _colorize_table(raw: str) -> str:
+    """Colorize table: section headers bold cyan, keys green, values yellow (incl. multiline)."""
+    lines = raw.split("\n")
+    out = []
+    key_val_re = re.compile(r"^(\s*)(.*?)\s*:\s*(.*)$")
+    for line in lines:
+        if line.strip().startswith("===") and line.strip().endswith("==="):
+            out.append(f"{_ANSI_SECTION}{line}{_ANSI_RESET}")
+        elif ":" in line and not line.strip().startswith("=="):
+            match = key_val_re.match(line)
+            if match:
+                pre, key_part, val_part = match.groups()
+                out.append(f"{pre}{_ANSI_KEY}{key_part}{_ANSI_RESET}: {_ANSI_STR}{val_part}{_ANSI_RESET}")
+            else:
+                out.append(line)
+        elif line.strip():
+            # Continuation line (e.g. multiline lyrics in table), color as value
+            indent = line[: len(line) - len(line.lstrip())]
+            rest = line.lstrip()
+            out.append(f"{indent}{_ANSI_STR}{rest}{_ANSI_RESET}")
+        else:
+            out.append(line)
+    return "\n".join(out)
+
+
+def _colorize_yaml(raw: str) -> str:
+    """Colorize YAML: keys green, values yellow (including multiline continuation lines)."""
+    lines = raw.split("\n")
+    out = []
+    key_line_re = re.compile(r"^(\s*)([a-zA-Z_][a-zA-Z0-9_]*)\s*:\s*(.*)$")
+    for line in lines:
+        match = key_line_re.match(line)
+        if match:
+            pre, key, val = match.groups()
+            if val.strip():
+                out.append(f"{pre}{_ANSI_KEY}{key}{_ANSI_RESET}: {_ANSI_STR}{val}{_ANSI_RESET}")
+            else:
+                out.append(f"{pre}{_ANSI_KEY}{key}{_ANSI_RESET}:{val}")
+        elif line.strip():
+            # Continuation line (e.g. multiline lyrics); not a key line, color as value
+            indent = line[: len(line) - len(line.lstrip())]
+            rest = line.lstrip()
+            out.append(f"{indent}{_ANSI_STR}{rest}{_ANSI_RESET}")
+        else:
+            out.append(line)
+    return "\n".join(out)
+
 
 def format_output(data: Any, output_format: str) -> str:
     """Format output data according to specified format."""
+    serializable = _data_for_serialization(data)
     if output_format == "json":
-        return json.dumps(data, indent=2)
+        return json.dumps(serializable, indent=2)
     if output_format == "yaml":
         try:
             import yaml  # type: ignore[import-untyped]
 
-            result = yaml.dump(data, default_flow_style=False)
+            result = yaml.dump(serializable, default_flow_style=False)
             return str(result) if result is not None else ""
         except ImportError:
             sys.stderr.write("Warning: PyYAML not installed, falling back to JSON\n")
-            return json.dumps(data, indent=2)
+            return json.dumps(serializable, indent=2)
     elif output_format == "table":
         return format_as_table(data)
     else:
@@ -107,7 +184,8 @@ def format_as_table(data: dict[str, Any]) -> str:
         lines.append("=== UNIFIED METADATA ===")
         for key, value in data["unified_metadata"].items():
             if value is not None:
-                lines.append(f"{key:20}: {value}")
+                label = key.value if isinstance(key, UnifiedMetadataKey) else str(key)
+                lines.append(f"{label:20}: {value}")
         lines.append("")
 
     if "technical_info" in data:
@@ -124,7 +202,8 @@ def format_as_table(data: dict[str, Any]) -> str:
                 lines.append(f"\n{metadata_format_name.upper()}:")
                 for key, value in format_data.items():
                     if value is not None:
-                        lines.append(f"  {key:18}: {value}")
+                        label = key.value if isinstance(key, UnifiedMetadataKey) else str(key)
+                        lines.append(f"  {label:18}: {value}")
 
     return "\n".join(lines)
 
@@ -150,17 +229,27 @@ def _read_metadata(args: argparse.Namespace) -> None:
                     include_raw_binary_data=getattr(args, "include_raw_binary_data", False),
                 )
 
-            output = format_output(metadata, args.output_format)
+            plain = format_output(metadata, args.output_format)
+            use_color = getattr(args, "color", False) and not args.output
+            if os.environ.get("NO_COLOR"):
+                use_color = False
+            out = plain
+            if use_color and args.output_format == "json":
+                out = _colorize_json(plain)
+            elif use_color and args.output_format == "table":
+                out = _colorize_table(plain)
+            elif use_color and args.output_format == "yaml":
+                out = _colorize_yaml(plain)
 
             if args.output:
                 try:
                     with Path(args.output).open("w") as f:
-                        f.write(output)
+                        f.write(plain)
                 except (PermissionError, OSError) as e:
                     _handle_file_operation_error(e, args.output, args.continue_on_error)
             else:
-                sys.stdout.write(output)
-                if not output.endswith("\n"):
+                sys.stdout.write(out)
+                if not out.endswith("\n"):
                     sys.stdout.write("\n")
 
         except (FileTypeNotSupportedError, FileNotFoundError, PermissionError, OSError, Exception) as e:
@@ -409,6 +498,12 @@ Examples:
     read_parser.add_argument(
         "--continue-on-error", action="store_true", help="Continue processing other files on error"
     )
+    read_parser.add_argument(
+        "--color",
+        action="store_true",
+        dest="color",
+        help="Colorize output (headers, keys, values) for JSON, YAML, and table.",
+    )
     read_parser.set_defaults(func=_read_metadata)
 
     # Unified command
@@ -426,6 +521,12 @@ Examples:
     unified_parser.add_argument(
         "--continue-on-error", action="store_true", help="Continue processing other files on error"
     )
+    unified_parser.add_argument(
+        "--color",
+        action="store_true",
+        dest="color",
+        help="Colorize output (headers, keys, values) for JSON, YAML, and table.",
+    )
     unified_parser.set_defaults(func=_read_metadata, format_type="unified")
 
     # Write command

{audiometa_python-1.2.0 → audiometa_python-1.3.0}/audiometa/test/tests/e2e/cli/read/test_comprehensive.py

@@ -49,26 +49,26 @@ class TestCLIReadComprehensive:
             data = json.loads(result.stdout)
             unified = data.get("unified_metadata", {})
 
-            assert unified.get(UnifiedMetadataKey.TITLE) == "Comprehensive Test Title"
-            assert unified.get(UnifiedMetadataKey.ARTISTS) == ["Artist One", "Artist Two"]
-            assert unified.get(UnifiedMetadataKey.ALBUM) == "Test Album"
-            assert unified.get(UnifiedMetadataKey.ALBUM_ARTISTS) == ["Album Artist"]
-            assert unified.get(UnifiedMetadataKey.RELEASE_DATE) == "2024"
-            assert unified.get(UnifiedMetadataKey.GENRES_NAMES) == ["Rock", "Blues"]
-            assert unified.get(UnifiedMetadataKey.TRACK_NUMBER) == "5/12"
-            assert unified.get(UnifiedMetadataKey.DISC_NUMBER) == 1
-            assert unified.get(UnifiedMetadataKey.DISC_TOTAL) == 2
-            assert unified.get(UnifiedMetadataKey.RATING) == 85
-            assert unified.get(UnifiedMetadataKey.BPM) == 120
-            assert unified.get(UnifiedMetadataKey.LANGUAGE) == "eng"
-            assert unified.get(UnifiedMetadataKey.COMPOSERS) == ["Composer One", "Composer Two"]
-            assert unified.get(UnifiedMetadataKey.PUBLISHER) == "Test Publisher"
-            assert unified.get(UnifiedMetadataKey.COPYRIGHT) == "© 2024"
-            assert unified.get(UnifiedMetadataKey.UNSYNCHRONIZED_LYRICS) == "Test lyrics"
-            assert unified.get(UnifiedMetadataKey.COMMENT) == "Test comment"
-            assert unified.get(UnifiedMetadataKey.ISRC) == "USRC17607839"
-            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_TRACKID) == "9d6f6f7c-9d52-4c76-8f9e-01d18d8f8ec6"
-            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_ARTISTIDS) == [
+            assert unified.get(UnifiedMetadataKey.TITLE.value) == "Comprehensive Test Title"
+            assert unified.get(UnifiedMetadataKey.ARTISTS.value) == ["Artist One", "Artist Two"]
+            assert unified.get(UnifiedMetadataKey.ALBUM.value) == "Test Album"
+            assert unified.get(UnifiedMetadataKey.ALBUM_ARTISTS.value) == ["Album Artist"]
+            assert unified.get(UnifiedMetadataKey.RELEASE_DATE.value) == "2024"
+            assert unified.get(UnifiedMetadataKey.GENRES_NAMES.value) == ["Rock", "Blues"]
+            assert unified.get(UnifiedMetadataKey.TRACK_NUMBER.value) == "5/12"
+            assert unified.get(UnifiedMetadataKey.DISC_NUMBER.value) == 1
+            assert unified.get(UnifiedMetadataKey.DISC_TOTAL.value) == 2
+            assert unified.get(UnifiedMetadataKey.RATING.value) == 85
+            assert unified.get(UnifiedMetadataKey.BPM.value) == 120
+            assert unified.get(UnifiedMetadataKey.LANGUAGE.value) == "eng"
+            assert unified.get(UnifiedMetadataKey.COMPOSERS.value) == ["Composer One", "Composer Two"]
+            assert unified.get(UnifiedMetadataKey.PUBLISHER.value) == "Test Publisher"
+            assert unified.get(UnifiedMetadataKey.COPYRIGHT.value) == "© 2024"
+            assert unified.get(UnifiedMetadataKey.UNSYNCHRONIZED_LYRICS.value) == "Test lyrics"
+            assert unified.get(UnifiedMetadataKey.COMMENT.value) == "Test comment"
+            assert unified.get(UnifiedMetadataKey.ISRC.value) == "USRC17607839"
+            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_TRACKID.value) == "9d6f6f7c-9d52-4c76-8f9e-01d18d8f8ec6"
+            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_ARTISTIDS.value) == [
                 "9d6f6f7c-9d52-4c76-8f9e-01d18d8f8ec6",
                 "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
             ]
@@ -108,24 +108,26 @@ class TestCLIReadComprehensive:
             data = json.loads(result.stdout)
             unified = data.get("unified_metadata", {})
 
-            assert unified.get(UnifiedMetadataKey.TITLE) == "FLAC Comprehensive Test"
-            assert unified.get(UnifiedMetadataKey.ARTISTS) == ["FLAC Artist"]
-            assert unified.get(UnifiedMetadataKey.ALBUM) == "FLAC Album"
-            assert unified.get(UnifiedMetadataKey.TRACK_NUMBER) == "3/10"
-            assert unified.get(UnifiedMetadataKey.DISC_NUMBER) == 1
-            assert unified.get(UnifiedMetadataKey.DISC_TOTAL) == 2
-            assert unified.get(UnifiedMetadataKey.BPM) == 140
-            assert unified.get(UnifiedMetadataKey.LANGUAGE) == "eng"
-            assert unified.get(UnifiedMetadataKey.COMPOSERS) == ["FLAC Composer"]
-            assert unified.get(UnifiedMetadataKey.PUBLISHER) == "FLAC Publisher"
-            assert unified.get(UnifiedMetadataKey.COPYRIGHT) == "© FLAC"
-            assert unified.get(UnifiedMetadataKey.UNSYNCHRONIZED_LYRICS) == "FLAC lyrics"
-            assert unified.get(UnifiedMetadataKey.COMMENT) == "FLAC comment"
-            assert unified.get(UnifiedMetadataKey.DESCRIPTION) == "FLAC description"
-            assert unified.get(UnifiedMetadataKey.REPLAYGAIN) == "+2.5 dB"
-            assert unified.get(UnifiedMetadataKey.ISRC) == "FRXXX1800001"
-            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_TRACKID) == "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
-            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_ARTISTIDS) == ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
+            assert unified.get(UnifiedMetadataKey.TITLE.value) == "FLAC Comprehensive Test"
+            assert unified.get(UnifiedMetadataKey.ARTISTS.value) == ["FLAC Artist"]
+            assert unified.get(UnifiedMetadataKey.ALBUM.value) == "FLAC Album"
+            assert unified.get(UnifiedMetadataKey.TRACK_NUMBER.value) == "3/10"
+            assert unified.get(UnifiedMetadataKey.DISC_NUMBER.value) == 1
+            assert unified.get(UnifiedMetadataKey.DISC_TOTAL.value) == 2
+            assert unified.get(UnifiedMetadataKey.BPM.value) == 140
+            assert unified.get(UnifiedMetadataKey.LANGUAGE.value) == "eng"
+            assert unified.get(UnifiedMetadataKey.COMPOSERS.value) == ["FLAC Composer"]
+            assert unified.get(UnifiedMetadataKey.PUBLISHER.value) == "FLAC Publisher"
+            assert unified.get(UnifiedMetadataKey.COPYRIGHT.value) == "© FLAC"
+            assert unified.get(UnifiedMetadataKey.UNSYNCHRONIZED_LYRICS.value) == "FLAC lyrics"
+            assert unified.get(UnifiedMetadataKey.COMMENT.value) == "FLAC comment"
+            assert unified.get(UnifiedMetadataKey.DESCRIPTION.value) == "FLAC description"
+            assert unified.get(UnifiedMetadataKey.REPLAYGAIN.value) == "+2.5 dB"
+            assert unified.get(UnifiedMetadataKey.ISRC.value) == "FRXXX1800001"
+            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_TRACKID.value) == "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_ARTISTIDS.value) == [
+                "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+            ]
             # ARCHIVAL_LOCATION is not supported by Vorbis format (FLAC)
 
     def test_cli_read_all_fields_comprehensive_wav(self):
@@ -160,22 +162,24 @@ class TestCLIReadComprehensive:
             data = json.loads(result.stdout)
             unified = data.get("unified_metadata", {})
 
-            assert unified.get(UnifiedMetadataKey.TITLE) == "WAV Comprehensive Test"
-            assert unified.get(UnifiedMetadataKey.ARTISTS) == ["WAV Artist"]
-            assert unified.get(UnifiedMetadataKey.ALBUM) == "WAV Album"
-            assert unified.get(UnifiedMetadataKey.RELEASE_DATE) == "2024"
-            assert unified.get(UnifiedMetadataKey.GENRES_NAMES) == ["Rock"]
-            assert unified.get(UnifiedMetadataKey.RATING) == 100
-            assert unified.get(UnifiedMetadataKey.BPM) == 120
-            assert unified.get(UnifiedMetadataKey.LANGUAGE) == "eng"
-            assert unified.get(UnifiedMetadataKey.COMPOSERS) == ["WAV Composer"]
-            assert unified.get(UnifiedMetadataKey.COPYRIGHT) == "© WAV"
-            assert unified.get(UnifiedMetadataKey.COMMENT) == "WAV comment"
-            assert unified.get(UnifiedMetadataKey.DESCRIPTION) == "WAV description"
-            assert unified.get(UnifiedMetadataKey.ORIGINATOR) == "WAV originator"
-            assert unified.get(UnifiedMetadataKey.ISRC) == "GBUM71505078"
-            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_TRACKID) == "12345678-1234-5678-9abc-def123456789"
-            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_ARTISTIDS) == ["12345678-1234-5678-9abc-def123456789"]
+            assert unified.get(UnifiedMetadataKey.TITLE.value) == "WAV Comprehensive Test"
+            assert unified.get(UnifiedMetadataKey.ARTISTS.value) == ["WAV Artist"]
+            assert unified.get(UnifiedMetadataKey.ALBUM.value) == "WAV Album"
+            assert unified.get(UnifiedMetadataKey.RELEASE_DATE.value) == "2024"
+            assert unified.get(UnifiedMetadataKey.GENRES_NAMES.value) == ["Rock"]
+            assert unified.get(UnifiedMetadataKey.RATING.value) == 100
+            assert unified.get(UnifiedMetadataKey.BPM.value) == 120
+            assert unified.get(UnifiedMetadataKey.LANGUAGE.value) == "eng"
+            assert unified.get(UnifiedMetadataKey.COMPOSERS.value) == ["WAV Composer"]
+            assert unified.get(UnifiedMetadataKey.COPYRIGHT.value) == "© WAV"
+            assert unified.get(UnifiedMetadataKey.COMMENT.value) == "WAV comment"
+            assert unified.get(UnifiedMetadataKey.DESCRIPTION.value) == "WAV description"
+            assert unified.get(UnifiedMetadataKey.ORIGINATOR.value) == "WAV originator"
+            assert unified.get(UnifiedMetadataKey.ISRC.value) == "GBUM71505078"
+            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_TRACKID.value) == "12345678-1234-5678-9abc-def123456789"
+            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_ARTISTIDS.value) == [
+                "12345678-1234-5678-9abc-def123456789"
+            ]
 
     def test_cli_read_comprehensive_roundtrip(self):
         """Test that we can write all fields via CLI and read them back correctly."""
@@ -248,23 +252,25 @@ class TestCLIReadComprehensive:
             data = json.loads(read_result.stdout)
             unified = data.get("unified_metadata", {})
 
-            assert unified.get(UnifiedMetadataKey.TITLE) == "Roundtrip Test"
-            assert unified.get(UnifiedMetadataKey.ARTISTS) == ["Roundtrip Artist One", "Roundtrip Artist Two"]
-            assert unified.get(UnifiedMetadataKey.ALBUM) == "Roundtrip Album"
-            assert unified.get(UnifiedMetadataKey.ALBUM_ARTISTS) == ["Roundtrip Album Artist"]
-            assert unified.get(UnifiedMetadataKey.RELEASE_DATE) == "2024"
-            assert unified.get(UnifiedMetadataKey.GENRES_NAMES) == ["Rock", "Blues"]
-            assert unified.get(UnifiedMetadataKey.TRACK_NUMBER) == "5/12"
-            assert unified.get(UnifiedMetadataKey.DISC_NUMBER) == 1
-            assert unified.get(UnifiedMetadataKey.DISC_TOTAL) == 2
-            assert unified.get(UnifiedMetadataKey.RATING) == 85
-            assert unified.get(UnifiedMetadataKey.BPM) == 120
-            assert unified.get(UnifiedMetadataKey.LANGUAGE) == "eng"
-            assert unified.get(UnifiedMetadataKey.COMPOSERS) == ["Roundtrip Composer"]
-            assert unified.get(UnifiedMetadataKey.PUBLISHER) == "Roundtrip Publisher"
-            assert unified.get(UnifiedMetadataKey.COPYRIGHT) == "© Roundtrip"
-            assert unified.get(UnifiedMetadataKey.UNSYNCHRONIZED_LYRICS) == "Roundtrip lyrics"
-            assert unified.get(UnifiedMetadataKey.COMMENT) == "Roundtrip comment"
-            assert unified.get(UnifiedMetadataKey.ISRC) == "USRC17607839"
-            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_TRACKID) == "9d6f6f7c-9d52-4c76-8f9e-01d18d8f8ec6"
-            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_ARTISTIDS) == ["9d6f6f7c-9d52-4c76-8f9e-01d18d8f8ec6"]
+            assert unified.get(UnifiedMetadataKey.TITLE.value) == "Roundtrip Test"
+            assert unified.get(UnifiedMetadataKey.ARTISTS.value) == ["Roundtrip Artist One", "Roundtrip Artist Two"]
+            assert unified.get(UnifiedMetadataKey.ALBUM.value) == "Roundtrip Album"
+            assert unified.get(UnifiedMetadataKey.ALBUM_ARTISTS.value) == ["Roundtrip Album Artist"]
+            assert unified.get(UnifiedMetadataKey.RELEASE_DATE.value) == "2024"
+            assert unified.get(UnifiedMetadataKey.GENRES_NAMES.value) == ["Rock", "Blues"]
+            assert unified.get(UnifiedMetadataKey.TRACK_NUMBER.value) == "5/12"
+            assert unified.get(UnifiedMetadataKey.DISC_NUMBER.value) == 1
+            assert unified.get(UnifiedMetadataKey.DISC_TOTAL.value) == 2
+            assert unified.get(UnifiedMetadataKey.RATING.value) == 85
+            assert unified.get(UnifiedMetadataKey.BPM.value) == 120
+            assert unified.get(UnifiedMetadataKey.LANGUAGE.value) == "eng"
+            assert unified.get(UnifiedMetadataKey.COMPOSERS.value) == ["Roundtrip Composer"]
+            assert unified.get(UnifiedMetadataKey.PUBLISHER.value) == "Roundtrip Publisher"
+            assert unified.get(UnifiedMetadataKey.COPYRIGHT.value) == "© Roundtrip"
+            assert unified.get(UnifiedMetadataKey.UNSYNCHRONIZED_LYRICS.value) == "Roundtrip lyrics"
+            assert unified.get(UnifiedMetadataKey.COMMENT.value) == "Roundtrip comment"
+            assert unified.get(UnifiedMetadataKey.ISRC.value) == "USRC17607839"
+            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_TRACKID.value) == "9d6f6f7c-9d52-4c76-8f9e-01d18d8f8ec6"
+            assert unified.get(UnifiedMetadataKey.MUSICBRAINZ_ARTISTIDS.value) == [
+                "9d6f6f7c-9d52-4c76-8f9e-01d18d8f8ec6"
+            ]

{audiometa_python-1.2.0 → audiometa_python-1.3.0}/audiometa/test/tests/e2e/cli/read/test_options.py

@@ -1,4 +1,5 @@
 import json
+import os
 import subprocess
 import sys
 
@@ -86,3 +87,27 @@ class TestCLIReadOptions:
             )
             assert result.returncode == 0
             assert "UNIFIED METADATA" in result.stdout
+
+    def test_cli_read_with_color_produces_ansi(self):
+        env = {k: v for k, v in os.environ.items() if k != "NO_COLOR"}
+        with temp_file_with_metadata({"title": "Test"}, "mp3") as test_file:
+            result = subprocess.run(
+                [sys.executable, "-m", "audiometa", "read", str(test_file), "--color", "--format", "json"],
+                capture_output=True,
+                text=True,
+                check=False,
+                env=env,
+            )
+            assert result.returncode == 0
+            assert "\033[" in result.stdout
+
+    def test_cli_read_without_color_no_ansi(self):
+        with temp_file_with_metadata({"title": "Test"}, "mp3") as test_file:
+            result = subprocess.run(
+                [sys.executable, "-m", "audiometa", "read", str(test_file), "--format", "json"],
+                capture_output=True,
+                text=True,
+                check=False,
+            )
+            assert result.returncode == 0
+            assert "\033[" not in result.stdout

{audiometa_python-1.2.0 → audiometa_python-1.3.0}/audiometa/test/tests/e2e/cli/read/test_unified.py

@@ -37,6 +37,26 @@ class TestCLIReadUnified:
             assert data.get("title") == "Unified Test"
             assert data.get("artists") == ["Unified Artist"]
 
+    def test_cli_unified_yaml_uses_plain_string_keys(self):
+        with temp_file_with_metadata({"title": "YAML Key Test", "artist": "YAML Artist"}, "mp3") as test_file:
+            result = subprocess.run(
+                [sys.executable, "-m", "audiometa", "unified", str(test_file), "--format", "yaml"],
+                capture_output=True,
+                text=True,
+                check=False,
+            )
+            assert result.returncode == 0
+            assert "!!python" not in result.stdout
+            try:
+                import yaml
+
+                data = yaml.safe_load(result.stdout)
+                assert isinstance(data, dict)
+                assert data.get("title") == "YAML Key Test"
+                assert data.get("artists") == ["YAML Artist"]
+            except ImportError:
+                pass
+
     def test_cli_unified_table_format(self):
         with temp_file_with_metadata({"title": "Table Test", "artist": "Table Artist"}, "mp3") as test_file:
             result = subprocess.run(

{audiometa_python-1.2.0 → audiometa_python-1.3.0}/audiometa/test/tests/e2e/cli/test_formatting.py

@@ -2,6 +2,7 @@ import json
 
 import pytest
 
+from audiometa import UnifiedMetadataKey
 from audiometa.cli import format_as_table, format_output
 
 
@@ -29,3 +30,23 @@ class TestCLIFormatting:
         assert "Test Artist" in result
         assert "180" in result
         assert "320" in result
+
+    def test_format_output_table_displays_key_labels_not_enum_repr(self):
+        data = {
+            "unified_metadata": {
+                UnifiedMetadataKey.TITLE: "Song Title",
+                UnifiedMetadataKey.ALBUM_ARTISTS: ["Album Artist"],
+            },
+            "metadata_format": {
+                "id3v2": {
+                    UnifiedMetadataKey.TITLE: "Song Title",
+                    UnifiedMetadataKey.ALBUM_ARTISTS: ["Album Artist"],
+                },
+            },
+        }
+        result = format_as_table(data)
+        assert "UnifiedMetadataKey." not in result
+        assert "title" in result
+        assert "album_artists" in result
+        assert "Song Title" in result
+        assert "Album Artist" in result or "['Album Artist']" in result

audiometa_python-1.3.0/audiometa/test/tests/unit/cli/test_cli_colorize.py

@@ -0,0 +1,90 @@
+import re
+
+import pytest
+
+from audiometa.cli import _colorize_json, _colorize_table, _colorize_yaml
+
+
+def _strip_ansi(text: str) -> str:
+    return re.sub(r"\033\[[0-9;]*m", "", text)
+
+
+@pytest.mark.unit
+class TestColorizeJson:
+    def test_keys_green(self):
+        raw = '"title": "Hello"'
+        out = _colorize_json(raw)
+        assert "\033[32m" in out
+        assert "title" in out
+        assert _strip_ansi(out) == raw
+
+    def test_string_values_yellow(self):
+        raw = '"title": "Hello"'
+        out = _colorize_json(raw)
+        assert "\033[33m" in out
+        assert "Hello" in out
+
+    def test_numbers_cyan(self):
+        raw = '"duration": 180'
+        out = _colorize_json(raw)
+        assert "\033[36m" in out
+        assert "180" in out
+
+    def test_literals_dim(self):
+        raw = '"enabled": true'
+        out = _colorize_json(raw)
+        assert "\033[2m" in out
+        assert "true" in out
+
+    def test_reset_present(self):
+        raw = '{"key": "val"}'
+        out = _colorize_json(raw)
+        assert "\033[0m" in out
+
+
+@pytest.mark.unit
+class TestColorizeTable:
+    def test_section_headers_bold_cyan(self):
+        raw = "=== UNIFIED METADATA ==="
+        out = _colorize_table(raw)
+        assert "\033[1;36m" in out
+        assert "UNIFIED METADATA" in out
+
+    def test_key_value_line(self):
+        raw = "title               : My Song"
+        out = _colorize_table(raw)
+        assert "\033[32m" in out
+        assert "\033[33m" in out
+        assert "title" in out
+        assert "My Song" in out
+
+    def test_continuation_line_colored_as_value(self):
+        raw = "title               : Line one\nLine two"
+        out = _colorize_table(raw)
+        assert "\033[33m" in out
+        assert "Line one" in out
+        assert "Line two" in out
+
+
+@pytest.mark.unit
+class TestColorizeYaml:
+    def test_key_green_value_yellow(self):
+        raw = "title: My Album"
+        out = _colorize_yaml(raw)
+        assert "\033[32m" in out
+        assert "\033[33m" in out
+        assert "title" in out
+        assert "My Album" in out
+
+    def test_continuation_line_colored(self):
+        raw = "lyrics: First line\nSecond line"
+        out = _colorize_yaml(raw)
+        assert "\033[33m" in out
+        assert "First line" in out
+        assert "Second line" in out
+
+    def test_empty_value_key_only_colored(self):
+        raw = "empty:"
+        out = _colorize_yaml(raw)
+        assert "\033[32m" in out
+        assert "empty" in out

{audiometa_python-1.2.0 → audiometa_python-1.3.0/audiometa_python.egg-info}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: audiometa-python
-Version: 1.2.0
+Version: 1.3.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>
 License: Apache-2.0
-Project-URL: Homepage, https://github.com/your-username/audiometa-python
-Project-URL: Repository, https://github.com/your-username/audiometa-python
-Project-URL: Issues, https://github.com/your-username/audiometa-python/issues
+Project-URL: Homepage, https://github.com/BehindTheMusicTree/audiometa
+Project-URL: Repository, https://github.com/BehindTheMusicTree/audiometa
+Project-URL: Issues, https://github.com/BehindTheMusicTree/audiometa/issues
 Keywords: audio,metadata,mp3,flac,wav,id3,vorbis,riff
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -1518,6 +1518,9 @@ audiometa read song.mp3 --include-raw-binary-data
 
 # Save to file
 audiometa read song.mp3 --output metadata.json
+
+# Colorize output (headers, keys, values) for terminal or demos
+audiometa read song.mp3 --format table --color
 ```
 
 #### Error Handling {#cli-error-handling}
@@ -1543,6 +1546,8 @@ audiometa read "**/*.mp3" --recursive
 - **YAML**: Human-readable structured format (requires PyYAML)
 - **Table**: Simple text table format
 
+Use `--color` to colorize headers, keys, and values for terminal or demo videos (plain output by default; disabled when writing to a file). Respects the `NO_COLOR` environment variable.
+
 ### Examples
 
 ```bash

{audiometa_python-1.2.0 → audiometa_python-1.3.0}/audiometa_python.egg-info/SOURCES.txt

@@ -341,6 +341,7 @@ audiometa/test/tests/unit/audio_file/technical_info/test_file_size.py
 audiometa/test/tests/unit/audio_file/technical_info/test_format_name.py
 audiometa/test/tests/unit/audio_file/technical_info/test_sample_rate.py
 audiometa/test/tests/unit/cli/__init__.py
+audiometa/test/tests/unit/cli/test_cli_colorize.py
 audiometa/test/tests/unit/cli/test_expand_file_patterns.py
 audiometa/test/tests/unit/metadata_managers/__init__.py
 audiometa/test/tests/unit/metadata_managers/conftest.py