umpyre.collectors.base

Base collector class with Mapping interface.

Classes

CollectorRegistry()	Registry for managing available collectors.
MetricCollector()	Abstract base for metric collectors using Mapping interface.

class umpyre.collectors.base.CollectorRegistry

Bases: object

Registry for managing available collectors.

get(name)

Get collector class by name.

Return type:

type[MetricCollector]

list_collectors()

List all registered collector names.

Return type:

list[str]

register(name, collector_class)

Register a collector class.

Parameters:

• name (str) – Collector identifier

• collector_class (type[MetricCollector]) – MetricCollector subclass

class umpyre.collectors.base.MetricCollector

Bases: Mapping, ABC

Abstract base for metric collectors using Mapping interface.

Collectors implement the Mapping protocol to provide dict-like access to collected metrics, enabling flexible composition and iteration.

Example

>>> class SimpleCollector(MetricCollector):
...     def collect(self) -> dict:
...         return {'lines': 100, 'functions': 10}
>>> collector = SimpleCollector()
>>> collector['lines']
100
>>> list(collector)
['lines', 'functions']

abstractmethod collect()

Collect metrics and return as dictionary.

Return type:

dict

Returns:

Dictionary of metric names to values

refresh()

Force re-collection of metrics.

to_dict()

Export all metrics as dictionary.

Return type:

dict