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

1"""Declarations each class states in its own body, read along the class's MRO.""" 

2 

3from __future__ import annotations 

4 

5from collections.abc import Iterable, Iterator 

6 

7 

8class OwnDeclarations: 

9 """A class reads what each of its bases declared for itself under one attribute name. 

10 

11 Inheritance answers "the nearest declaration"; these answer "every class's own 

12 declaration", the question a capability composed through several parents asks. 

13 """ 

14 

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] 

22 

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 

28 

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 

36 

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