Method get_by_path

openkb/state.py:38–53

Return metadata whose path/raw_path/source_path equals ``path``. ``path`` is a registry path string (posix, relative to the KB dir when inside it) as produced by ``converter._registry_path``. Entries written before the path index existed carry none of these fields and

(self, path: str)

        return dict(self._data)

    def get_by_path(self, path: str) -> dict | None:
        """Return metadata whose path/raw_path/source_path equals ``path``.

        ``path`` is a registry path string (posix, relative to the KB dir
        when inside it) as produced by ``converter._registry_path``. Entries
        written before the path index existed carry none of these fields and
        never match.
        """
        for metadata in self._data.values():
            if path in (
                metadata.get("path"),
                metadata.get("raw_path"),
                metadata.get("source_path"),
            ):
                return metadata
        return None

    def find_legacy_by_stem(self, stem: str) -> tuple[str, dict] | None:
        """Find a pre-path-index entry matching ``stem``.