Coverage for src/metaclass_registry/own_declarations.py: 100%
21 statements
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-17 00:39 +0000
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-17 00:39 +0000
1"""Declarations each class states in its own body, read along the class's MRO."""
3from __future__ import annotations
5from collections.abc import Iterable, Iterator
8class OwnDeclarations:
9 """A class reads what each of its bases declared for itself under one attribute name.
11 Inheritance answers "the nearest declaration"; these answer "every class's own
12 declaration", the question a capability composed through several parents asks.
13 """
15 @classmethod
16 def own_declarations(cls, name: str, bases: Iterable[type] | None = None) -> Iterator[tuple[type, object]]:
17 """Each base, in MRO order unless ``bases`` gives another order or scope, with the
18 value it declares in its own body; bases that declare nothing are skipped."""
19 for base in cls.__mro__ if bases is None else bases:
20 if name in base.__dict__:
21 yield base, base.__dict__[name]
23 @classmethod
24 def declared_items(cls, name: str, bases: Iterable[type] | None = None) -> Iterator[object]:
25 """Every item of every base's own declared collection, in that order."""
26 for _, declared in cls.own_declarations(name, bases):
27 yield from declared
29 @classmethod
30 def declared_of[Kind](cls, kind: type[Kind], bases: Iterable[type] | None = None) -> Iterator[Kind]:
31 """Every value of ``kind`` each base declares in its own body, in that order."""
32 for base in cls.__mro__ if bases is None else bases:
33 for value in base.__dict__.values():
34 if isinstance(value, kind):
35 yield value
37 @classmethod
38 def declared_union(cls, name: str, bases: Iterable[type] | None = None) -> tuple[object, ...]:
39 """The declared items, each once, nearest declaration first."""
40 return tuple(dict.fromkeys(cls.declared_items(name, bases)))