Skip to content

Xilu007 Mp3 Hash

src.xil_pipeline.XILU007_mp3_hash

Recursively hash all MP3 files under a directory and log filename : SHA-256.

Walks a directory tree, finds every *.mp3 file, and prints one line per file:

<path> : <sha256hex>

Useful for verifying stem integrity before/after migrations, detecting duplicates in the shared SFX library, and producing a manifest that can be diffed over time.

Usage:

xil mp3-hash                          # scan current directory
xil mp3-hash SFX/                     # scan SFX library
xil mp3-hash stems/S03E01/            # scan one episode's stems
xil mp3-hash stems/ --output hashes.txt
xil mp3-hash SFX/ --json
xil mp3-hash . --absolute

logger module-attribute 

logger = get_logger(__name__)

hash_file 

hash_file(path: str) -> str

Return the hex-encoded SHA-256 digest of a file.

Reads in 64 KiB chunks to keep memory use flat for large audio files.

Parameters:

  • path (str) –

    Absolute or relative path to the file.

Returns:

  • str –

    64-character lowercase hex string.

Source code in src/xil_pipeline/XILU007_mp3_hash.py 
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
def hash_file(path: str) -> str:
    """Return the hex-encoded SHA-256 digest of a file.

    Reads in 64 KiB chunks to keep memory use flat for large audio files.

    Args:
        path: Absolute or relative path to the file.

    Returns:
        64-character lowercase hex string.
    """
    h = hashlib.sha256()
    with open(path, "rb") as f:
        for chunk in iter(lambda: f.read(65536), b""):
            h.update(chunk)
    return h.hexdigest()

scan_mp3s 

scan_mp3s(root: str) -> list[tuple[str, str]]

Recursively find .mp3 files under root* and return (abs_path, sha256) pairs.

Files within each directory are yielded in sorted order so the output is deterministic across runs.

Parameters:

  • root (str) –

    Directory to scan.

Returns:

Source code in src/xil_pipeline/XILU007_mp3_hash.py 
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
def scan_mp3s(root: str) -> list[tuple[str, str]]:
    """Recursively find *.mp3 files under *root* and return (abs_path, sha256) pairs.

    Files within each directory are yielded in sorted order so the output is
    deterministic across runs.

    Args:
        root: Directory to scan.

    Returns:
        List of ``(absolute_path, sha256_hex)`` tuples.
    """
    results = []
    for dirpath, _dirs, filenames in os.walk(root):
        for fname in sorted(filenames):
            if fname.lower().endswith(".mp3"):
                full = os.path.abspath(os.path.join(dirpath, fname))
                results.append((full, hash_file(full)))
    return results

get_parser 

get_parser() -> argparse.ArgumentParser
Source code in src/xil_pipeline/XILU007_mp3_hash.py 
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
def get_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(
        prog="xil-mp3-hash",
        description="Recursively hash MP3 files and log <path> : <sha256>",
    )
    parser.add_argument(
        "path",
        nargs="?",
        default=".",
        help="File to hash or directory to scan recursively (default: current directory)",
    )
    parser.add_argument(
        "--output", "-o",
        default=None,
        metavar="FILE",
        help="Write results to FILE in addition to logging",
    )
    parser.add_argument(
        "--absolute",
        action="store_true",
        help="Print absolute paths (default: paths relative to scan root)",
    )
    parser.add_argument(
        "--json",
        action="store_true",
        help='Output a JSON array of {"path": ..., "sha256": ...} to stdout (no banner)',
    )
    return parser

main 

main() -> None

CLI entry point for recursive MP3 SHA-256 hashing.

Source code in src/xil_pipeline/XILU007_mp3_hash.py 
157
158
159
160
161
162
163
164
165
166
167
168
def main() -> None:
    """CLI entry point for recursive MP3 SHA-256 hashing."""
    args = get_parser().parse_args()

    # In --json mode skip configure_logging and run_banner so stdout
    # contains only valid JSON (safe to pipe directly to jq / python -m json.tool).
    if args.json:
        _run(args)
    else:
        configure_logging()
        with run_banner():
            _run(args)