Function normalize_target_spec

tools/docs_and_notebooks_check.py:220–258

Normalize a CLI target into a repo-relative POSIX-style path/pattern. Examples -------- .\\docs\\a.md -> docs/a.md ./docs/a.md -> docs/a.md docs\\gui\\ -> docs/gui /abs/path/in/repo/a.md -> docs/a.md (if inside repo)

(spec: str, repo_root: Path)

# Helpers
# -----------------------------
def normalize_target_spec(spec: str, repo_root: Path) -> str:
    """
    Normalize a CLI target into a repo-relative POSIX-style path/pattern.

    Examples
    --------
    .\\docs\\a.md          -> docs/a.md
    ./docs/a.md            -> docs/a.md
    docs\\gui\\            -> docs/gui
    /abs/path/in/repo/a.md -> docs/a.md   (if inside repo)
    """
    s = spec.strip()
    if not s:
        return s

    # Normalize slashes first so Windows-style input works everywhere
    s = s.replace("\\", "/")

    # Strip leading ./ repeatedly
    while s.startswith("./"):
        s = s[2:]

    # If absolute and inside repo, make it repo-relative
    p = Path(s)
    if p.is_absolute():
        try:
            s = str(p.resolve().relative_to(repo_root)).replace(os.sep, "/")
        except ValueError:
            # Outside repo: keep normalized absolute text so it can fail validation cleanly
            s = str(p).replace(os.sep, "/")

    # Collapse repeated slashes
    s = re.sub(r"/+", "/", s)

    # Remove trailing slash for canonical matching
    if len(s) > 1:
        s = s.rstrip("/")

    return s


def compile_target_specs(targets: list[str] | None, repo_root: Path) -> list[TargetSpec] | None: