Module plugin_disable

Expand description

Per-user plugin disable list for klasp.

Location: $KLASP_DISABLED_PLUGINS_FILE env override, or $HOME/.config/klasp/disabled-plugins.toml.

Format:

disabled = ["my-linter", "another-plugin"]

The disable list is a klasp-side concept — it does not affect the plugin wire format (PluginGateInput / PluginGateOutput).

Constants§

KLASP_DISABLED_PLUGINS_FILE_ENV: Environment variable that overrides the default disable list path. Essential for test isolation.

add: Add name to the disable list at path (or default path if None).
load: Load the set of disabled plugin names from path (or default path if None). Returns an empty set if the file does not exist.
resolve_disable_list_path: Resolve the disable list path: env override or ~/.config/klasp/disabled-plugins.toml.
validate_plugin_name: Validate that name is a well-formed plugin name. Same shape as the klasp-plugin-<name> binary lookup: ASCII letters, digits, _, -. Rejects path separators, shell metachars, control chars, and empty names.