simple-plugin-loader 1.3

Dynamically load other python modules to your project

Simple Python Plugin Loader

This module provides a simple way to dynamically load other Python modules as Plugins to your current project.

Install

You can install this python module via pip:

pip install simple-plugin-loader

Otherwise the module can be downloaded from PyPI: https://pypi.org/project/simple-plugin-loader/

Usage

1. Import the module:

   from plugin_loader import Loader
   

2. Load your plugins/modules:

   # initialize the loader
   loader = Loader()
   
   # load your plugins
   plugins = loader.load_plugins(<plugin_path>, <plugin_base_class>, <recursive>)
   

3. (Optional) The already loaded plugins/modules can be accessed via the plugins property of the loader instance:

   plugins = loader.plugins
   

load_plugins(...) Method

Arguments

• <plugin_path>: str
  This string represents the path (relative or absolute) to the directory from where the plugins/modules should be loaded.
• <plugin_base_class>: class (Default: SamplePlugin)
  The Loader does not load all found modules that are in the above directory. It only loads classes that are sub-classes of the here specified class.
  The default value of this argument is the SamplePlugin class. You can use this class as the base class for your plugins:

  from plugin_loader.sample_plugin import SamplePlugin
  
  class YourPlugin(SamplePlugin):
      pass
  

• <recursive>: bool (Default: False)
  Set this flag to True if you wish to load plugins/modules recursively to the above directory.

Return value

The method returns a dictionary that has the following structure:

• Key: The name of the plugin/module. This name is the module name of the module that contains the plugin class.
• Value: The plugin class. Not an instance!