stratum-dsp 1.0.0

Professional-grade audio analysis engine for DJ applications: BPM detection, key detection, and beat tracking
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

from __future__ import annotations

from pathlib import Path


def find_repo_root(start: Path | None = None) -> Path:
    """
    Find the repository root by walking upward until Cargo.toml is found.

    This keeps scripts robust even if they move within the validation/ tree.
    """
    p = (start or Path(__file__)).resolve()
    for cand in [p] + list(p.parents):
        if (cand / "Cargo.toml").exists():
            return cand
    raise RuntimeError(f"Could not locate repo root from: {p}")


def resolve_data_path(data_path_arg: str, repo_root: Path) -> Path:
    """
    Resolve a --data-path argument.

    If the path is relative, it is resolved relative to repo_root.
    """
    p = Path(data_path_arg)
    if p.is_absolute():
        return p
    return (repo_root / p).resolve()