tooluniverse.tool_registry module

Simplified tool registry for automatic tool discovery and registration.

tooluniverse.tool_registry.register_tool(tool_type_name=None, config=None)

Decorator to automatically register tool classes and their configs.

Usage:

@register_tool(‘CustomToolName’, config={…}) class MyTool:

pass

tooluniverse.tool_registry.register_external_tool(tool_name, tool_class)

Allow external registration of tool classes.

tooluniverse.tool_registry.register_config(tool_type_name, config)

Register a config for a tool type.

tooluniverse.tool_registry.get_tool_registry()

Get a copy of the current tool registry.

tooluniverse.tool_registry.get_config_registry()

Get a copy of the current config registry.

tooluniverse.tool_registry.lazy_import_tool(tool_name)

Lazily import a tool by name without importing all tool modules. Only imports the specific module containing the requested tool.

tooluniverse.tool_registry.build_lazy_registry(package_name=None)

Build a mapping of tool names to module names using config files and naming patterns. This is truly lazy - it doesn’t import any modules, just creates the mapping.

tooluniverse.tool_registry.auto_discover_tools(package_name=None, lazy=True)

Automatically discover and import all tool modules. If lazy=True, only builds the mapping without importing any modules. If lazy=False, imports all tool modules immediately.

tooluniverse.tool_registry.get_tool_class_lazy(tool_name)

Get a tool class by name, using lazy loading if possible. Only imports the specific module needed, not all modules.