audiometa-python 1.2.1__tar.gz → 1.3.2__tar.gz

{audiometa_python-1.2.1/audiometa_python.egg-info → audiometa_python-1.3.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: audiometa-python
-Version: 1.2.1
+Version: 1.3.2
 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
@@ -55,6 +55,8 @@ Dynamic: license-file
 
 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.
 
+**Try it**: A demo web app is available at [audiometa.themusictree.org](https://audiometa.themusictree.org).
+
 **Author**: [Andreas Garcia](https://github.com/BehindTheMusicTree)
 
 ## ⭐ Show Your Support
@@ -1518,6 +1520,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 +1548,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.1 → audiometa_python-1.3.2}/README.md

@@ -13,6 +13,8 @@
 
 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.
 
+**Try it**: A demo web app is available at [audiometa.themusictree.org](https://audiometa.themusictree.org).
+
 **Author**: [Andreas Garcia](https://github.com/BehindTheMusicTree)
 
 ## ⭐ Show Your Support
@@ -1476,6 +1478,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 +1506,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.1 → audiometa_python-1.3.2}/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,6 +25,13 @@ 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)."""
@@ -35,6 +44,62 @@ def _data_for_serialization(data: Any) -> Any:
     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)
@@ -164,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:
@@ -423,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
@@ -440,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.1 → audiometa_python-1.3.2}/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.3.2/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.1 → audiometa_python-1.3.2/audiometa_python.egg-info}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: audiometa-python
-Version: 1.2.1
+Version: 1.3.2
 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
@@ -55,6 +55,8 @@ Dynamic: license-file
 
 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.
 
+**Try it**: A demo web app is available at [audiometa.themusictree.org](https://audiometa.themusictree.org).
+
 **Author**: [Andreas Garcia](https://github.com/BehindTheMusicTree)
 
 ## ⭐ Show Your Support
@@ -1518,6 +1520,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 +1548,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.1 → audiometa_python-1.3.2}/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

{audiometa_python-1.2.1 → audiometa_python-1.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "audiometa-python"
-version = "1.2.1"
+version = "1.3.2"
 description = "A comprehensive Python library for reading and writing audio metadata across multiple formats"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -53,9 +53,9 @@ yaml = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/your-username/audiometa-python"
-Repository = "https://github.com/your-username/audiometa-python"
-Issues = "https://github.com/your-username/audiometa-python/issues"
+Homepage = "https://github.com/BehindTheMusicTree/audiometa"
+Repository = "https://github.com/BehindTheMusicTree/audiometa"
+Issues = "https://github.com/BehindTheMusicTree/audiometa/issues"
 
 [tool.setuptools.packages.find]
 where = ["."]
@@ -104,6 +104,11 @@ ignore = ["N999", "PLR0911", "PLR0912", "PLR0913", "PLR0914", "PLR0915", "TRY301
 "audiometa/test/**" = ["PLR2004"]
 # PLR2004 is acceptable in pre-commit hooks - simple scripts where magic numbers are clear
 ".pre-commit-hooks/**" = ["PLR2004"]
+# T201 (print) is acceptable in demo scripts - they are CLI/demo tools, not library code
+"scripts/run_demo_tape.py" = ["T201"]
+"scripts/demo_repl.py" = ["T201"]
+# Release script: CLI tool; relax exception/literal and magic-number rules for clarity
+"scripts/prepare_release.py" = ["TRY003", "EM101", "EM102", "PLR2004", "DTZ011", "RUF005", "T201"]
 
 [tool.mypy]
 python_version = "3.12"