"""Shared helpers across the three tools.""" from __future__ import annotations import sys from pathlib import Path def err(msg: str) -> None: print(msg, file=sys.stderr) def must_exist(p: Path) -> Path: if not p.exists(): err(f"error: not found: {p}") sys.exit(2) return p def with_suffix_before_ext(p: Path, marker: str) -> Path: """foo.pdf + '_clean' -> foo_clean.pdf""" return p.with_name(f"{p.stem}{marker}{p.suffix}")