Class FontPath

lib/matplotlib/font_manager.py:337–389

A class to describe a path to a font with a face index. Parameters ---------- path : str The path to a font. face_index : int The face index in the font.

# existing one. In this case, sub-classing str is the simpler and less-disruptive
# option.
class FontPath(str):
    """
    A class to describe a path to a font with a face index.

    Parameters
    ----------
    path : str
        The path to a font.
    face_index : int
        The face index in the font.
    """

    __match_args__ = ('path', 'face_index')

    def __new__(cls, path, face_index):
        ret = super().__new__(cls, path)
        ret._face_index = face_index
        return ret

    @property
    def path(self):
        """The path to a font."""
        return str(self)

    @property
    def face_index(self):
        """The face index in a font."""
        return self._face_index

    def _as_tuple(self):
        return (self.path, self.face_index)

    def __eq__(self, other):
        if isinstance(other, FontPath):
            return self._as_tuple() == other._as_tuple()
        return super().__eq__(other)

    def __ne__(self, other):
        return not (self == other)

    def __lt__(self, other):
        if isinstance(other, FontPath):
            return self._as_tuple() < other._as_tuple()
        return super().__lt__(other)

    def __gt__(self, other):
        return not (self == other or self < other)

    def __hash__(self):
        return hash(self._as_tuple())

    def __repr__(self):
        return f'FontPath{self._as_tuple()}'


@dataclasses.dataclass(frozen=True)