Function _registry_path

openkb/converter.py:36–47

Portable path string used as the registry's identity key. Relative-to-KB posix when the file lives inside the KB (stable across machines/checkouts), absolute posix otherwise. Both paths are fully resolved (symlinks followed) before comparison.

(path: Path, kb_dir: Path)

def _registry_path(path: Path, kb_dir: Path) -> str:
    """Portable path string used as the registry's identity key.

    Relative-to-KB posix when the file lives inside the KB (stable across
    machines/checkouts), absolute posix otherwise. Both paths are fully
    resolved (symlinks followed) before comparison.
    """
    resolved_path = path.resolve()
    resolved_kb = kb_dir.resolve()
    if resolved_path.is_relative_to(resolved_kb):
        return resolved_path.relative_to(resolved_kb).as_posix()
    return resolved_path.as_posix()


_SAFE_STEM_RE = re.compile(r"[^\w\-]+")