registry
diapason.core.registry
¶
Decorator-based registry for runtime discovery of pluggable components.
Adapted from IPW's src/ipw/core/registry.py. Each typed subclass gets its
own isolated storage so registrations in one registry never leak into another.
AgentRegistry
¶
BenchmarkRegistry
¶
ChannelRegistry
¶
CompressionRegistry
¶
ConnectorRegistry
¶
EngineRegistry
¶
FactStoreRegistry
¶
LearningRegistry
¶
MemoryRegistry
¶
MinerRegistry
¶
Bases: RegistryBase[Any]
Registry for Pearl mining provider implementations.
Each provider implements the MiningProvider ABC defined in
diapason.mining._stubs. Registry keys are short lowercase strings
such as "vllm-pearl" (CUDA + Hopper) and (future) "mlx-pearl",
"llamacpp-pearl-metal", "ollama-pearl".
ModelRegistry
¶
RegistryBase
¶
Bases: Generic[T]
Generic registry base class with class-specific entry isolation.
clear()
classmethod
¶
Remove all entries (useful in tests).
contains(key)
classmethod
¶
Check whether key is registered.
Résout une entrée paresseuse : répondre « oui » puis échouer à la créer serait pire que de payer l'import ici. L'appelant qui pose la question sur cette clé précise est justement celui qui va s'en servir.
create(key, *args, **kwargs)
classmethod
¶
Look up key and instantiate it with the given arguments.
get(key)
classmethod
¶
Retrieve the entry for key, raising KeyError if missing.
items()
classmethod
¶
Return all (key, entry) pairs as a tuple.
keys()
classmethod
¶
Return all registered keys as a tuple.
register(key)
classmethod
¶
Decorator that registers entry under key.
register_lazy(key, module)
classmethod
¶
Déclarer key sans charger son module.
Importer un moteur « pour déclencher son enregistrement » fait payer
ses dépendances à TOUT LE MONDE, y compris à qui ne s'en servira
jamais. MESURÉ : charger colbert_backend ou faiss_backend
tirait torch et numpy — puis échouait sur une dépendance
absente, et l'échec était avalé. Le coût restait, pas le moteur. Or un
numpy cassé fait alors tomber diapason serve au démarrage, pour
un moteur que personne n'a demandé.
Le module n'est donc chargé qu'à la première question portant sur cette clé.
register_value(key, value)
classmethod
¶
Imperatively register a value under key.