pluginlib

What it is and what it does

Pluginlib is a framework for building extensible Python applications through a plugin architecture. It handles the discovery, validation, and loading of plugins from multiple sources—standard library modules, entry points, explicit module lists, or filesystem paths—while enforcing that plugins conform to parent class contracts via abstract methods. Plugins can be versioned, conditionally loaded based on runtime state, blacklisted by type or name, and organized into separate groups so different parts of an application can use independent plugin sets without collision.

The framework is designed to reduce boilerplate: you decorate a parent class with @pluginlib.Parent, define required methods as abstract, then subclass that parent to create plugins. Once loaded through PluginLoader, plugins are accessible via nested dictionary notation or dot notation, making it straightforward to instantiate and call plugin methods. The package supports Python 3.6 through 3.15 and has no known security vulnerabilities.

Use it for

• Build an application where users can drop custom parser or processor plugins into a directory and have them automatically discovered and loaded at startup.
• Create a multi-tenant or multi-project framework where different plugin sets must coexist without naming conflicts using plugin groups.
• Implement conditional plugin loading based on OS, installed dependencies, or runtime environment to enable feature flags or platform-specific behavior.
• Manage multiple versions of the same plugin and automatically use the newest compatible version without manual version selection logic.
• Define a plugin interface with abstract methods and validate that all loaded plugins implement the required contract before they are used.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

pluginlib on PyPI

Before you install

Low install friction with only two lightweight runtime dependencies (packaging and importlib-metadata). The package is actively maintained with a recent release and no known security vulnerabilities.

Requires Python 3.6 or later; plugins must be defined as subclasses of parent classes decorated with @pluginlib.Parent.

License in practice

Licensed under MPLv2.0 (copyleft), which requires that modifications to pluginlib itself be shared under the same license, though applications using it as a plugin framework are not subject to this requirement.

Quickstart

pip install pluginlib

import pluginlib

@pluginlib.Parent('parser')
class Parser:
    @pluginlib.abstractmethod
    def parse(self, string):
        pass

loader = pluginlib.PluginLoader(modules=['my_plugins'])
plugins = loader.plugins

Package facts

Evidence: pluginlib-0.11.0-py2.py3-none-any.whl

Tags

More Python Modules packages

See also pluginbase · plux · stevedore · entrypoints · lml · click-plugins · napari-plugin-engine · coverage-conditional-plugin · plugincode · pytest-enabler