Settings

Setting Name

Environment Variable

Description

Values

Default

infer_type

PYPLUGIN_INFER_TYPE

Attempt to infer the type of defined plugins upon initialization and upon loading.

bool

True

enforce_type

PYPLUGIN_ENFORCE_TYPE

Throw an error if a plugin is loaded that returns an object that does not match its defined type.

bool

False

import_lookup

PYPLUGIN_IMPORT_LOOKUP

When using the lookup_plugin() function, (e.g. in dependency lookups), default to using importlib as a fallback to find and register the plugin.

bool

True

dynamic_requirements

PYPLUGIN_DYNAMIC_REQUIREMENTS

Loading Plugin 1 within Plugin 2 will dynamically set Plugin 1 as a requirement for Plugin 2 as if it was explicitly defined in requires.

bool

True

register_mode

PYPLUGIN_REGISTER_MODE

Handles registering plugins on initialization. eager: register as normal, replace: replace the already registered plugin, transient: registering a plugin with same name will replace the current plugin, replace+transient is a combination of the two.

eager, replace, transient, replace+transient,

eager