Skip to content

truthound plugins load

Load a discovered plugin.

Synopsis

truthound plugins load <NAME> [OPTIONS]

Arguments

Argument Required Description
NAME Yes Plugin name to load

Options

Option Short Default Description
--activate/--no-activate --activate Activate after loading

Description

The plugin load command loads a discovered plugin:

  1. Loads the plugin into memory
  2. Activates the plugin by default
  3. Validates dependencies and compatibility

State Transitions

discovered → loading → loaded → active

With --no-activate: 

discovered → loading → loaded

Examples

Load and Activate (Default)

truthound plugins load my-validator

Output: 

Loaded plugin: my-validator v0.1.0
Plugin is now active.

Load Without Activating

truthound plugins load my-validator --no-activate

Output: 

Loaded plugin: my-validator v0.1.0

Verify After Loading

# Load the plugin
truthound plugins load my-validator

# Verify it's active
truthound plugins list --state active

Use Cases

1. Load Plugin for Testing

# Load plugin
truthound plugins load my-validator

# Test with validation
truthound check data.csv --validators my-validator

2. Load Without Activation

# Load but don't activate yet
truthound plugins load my-validator --no-activate

# Inspect the loaded plugin
truthound plugins info my-validator

# Activate when ready
truthound plugins enable my-validator

3. Load Multiple Plugins

# Load several plugins
truthound plugins load validator-a
truthound plugins load validator-b
truthound plugins load custom-reporter

Error Handling

Plugin Not Found

truthound plugins load unknown-plugin

Output: 

Error: Plugin 'unknown-plugin' not found.

Dependency Error

truthound plugins load my-validator

Output: 

Error: Plugin 'my-validator' requires 'pandas>=2.0' which is not installed.

Compatibility Error

truthound plugins load my-validator

Output: 

Error: Plugin 'my-validator' requires Truthound >=2.0.0 (current: 1.0.0).

Exit Codes

Code Condition
0 Success
1 Plugin not found
2 Load error (dependencies, compatibility)

See Also