"""Compatibility helpers.""" from __future__ import annotations from typing import Any from typing import TYPE_CHECKING if TYPE_CHECKING: import importlib.metadata class DistFacade: """Facade providing pkg_resources.Distribution-like interface. This class wraps importlib.metadata.Distribution to provide a compatibility layer for code expecting the legacy pkg_resources API. The primary difference is the ``project_name`` attribute which pkg_resources provided but importlib.metadata.Distribution does not. """ __slots__ = ("_dist",) def __init__(self, dist: importlib.metadata.Distribution) -> None: self._dist = dist @property def project_name(self) -> str: """Get the project name (for pkg_resources compatibility). This is equivalent to dist.metadata["name"] but matches the pkg_resources.Distribution.project_name attribute. """ name: str = self.metadata["name"] return name def __getattr__(self, attr: str) -> Any: """Delegate all other attributes to the wrapped Distribution.""" return getattr(self._dist, attr) def __dir__(self) -> list[str]: """List available attributes including facade additions.""" return sorted(dir(self._dist) + ["_dist", "project_name"])