Files
2026-11-04 21:01:26 +01:00

44 lines
1.3 KiB
Python

"""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"])