Registry

fetchez.registry

A unified, dynamic registry system for discovering and loading Fetchez Modules, Hooks, Schemas, and other plugins.

copyright:

3. 2010-2026 Regents of the University of Colorado

license:

MIT, see LICENSE for more details.

class fetchez.registry.PluginRegistry

Bases: object

Base class for dynamically discovering and registering plugins.

base_class: Type | None = None

builtin_pkg: str = ''

entry_point_group: str = ''

user_folder: str = ''

classmethod get_registry()

Initialization of the class-level registry dictionary.

Return type:

Dict[str, Any]

classmethod load_builtins()

Recursively scan and load all built-in plugins.

classmethod load_user_plugins()

Scan local directories for user-provided plugins.

classmethod load_installed_plugins()

Load external pip-installed extensions via entry_points.

classmethod load_all()

Load all plugins: builtins, user plugins, and pip extensions.

classmethod get_info(mod_key)

Parameters:

mod_key (str)

Return type:

Dict[str, Any]

classmethod get_class(mod_key)

Parameters:

mod_key (str)

classmethod load_module(mod_key)

Parameters:

mod_key (str)

classmethod list_all()

Return type:

Dict[str, Any]

classmethod search_modules(term)

Search modules by name, description, agency, or tags.

Parameters:

term (str)

class fetchez.registry.YamlRegistry

Bases: object

A registry for discovering and loading yaml configuration files (recipes and hook presets).

base_class: Type | None = None

builtin_pkg: str = ''

entry_point_group: str = ''

user_folder: str = ''

classmethod get_registry()

Return type:

Dict[str, Any]

classmethod load_all()

classmethod get_yaml(name)

Parameters:

name (str)

Return type:

Dict[str, Any] | None

classmethod get_preset(name)

Parameters:

name (str)

Return type:

Dict[str, Any] | None

classmethod get_recipe(name)

Parameters:

name (str)

Return type:

Dict[str, Any] | None

class fetchez.registry.ModuleRegistry

Bases: PluginRegistry

base_class

alias of FetchModule

builtin_pkg: str = 'fetchez.modules'

entry_point_group: str = 'fetchez.modules'

user_folder: str = 'modules'

class fetchez.registry.HookRegistry

Bases: PluginRegistry

base_class

alias of FetchHook

builtin_pkg: str = 'fetchez.hooks'

entry_point_group: str = 'fetchez.hooks'

user_folder: str = 'hooks'

class fetchez.registry.SchemaRegistry

Bases: PluginRegistry

base_class

alias of BaseSchema

builtin_pkg: str = 'fetchez.schemas'

entry_point_group: str = 'fetchez.schemas'

user_folder: str = 'schemas'

classmethod apply_schema(config)

Looks for a schema in the config and applies its rules.

class fetchez.registry.RecipeRegistry

Bases: YamlRegistry

A registry for discovering and loading YAML recipes.

builtin_pkg: str = 'fetchez.recipes'

entry_point_group: str = 'fetchez.recipes'

user_folder: str = 'recipes'

class fetchez.registry.PresetRegistry

Bases: YamlRegistry

builtin_pkg: str = 'fetchez.presets'

entry_point_group: str = 'fetchez.presets'

user_folder: str = 'presets'

classmethod hook_list_from_preset(preset_def)

Convert yaml definition to list of Hook Objects.