Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Keep your plugins simple, stupid!

Project Description

Easy Plugins

Module EasyPlugins provides easy way to manage plugins.

I was searching for some easy yet powerful plugin framework, but no
nothing suitable found. They are complicated, require implementation
of some weird interface or they are ugly in other way. This is way
I have decided to reinvent the wheel and create this module (well,
it's just one class and a few tests).

What does it do? It scans your python path and try to load anything that
looks like a python stuff with prefix you specify. That's all.

Let's show you some example. Let's say I have a python application called
image_resizer. Core functionality is in this package. Then I have some
plugins that know something about image formats and each is using some very
clever algorithm. These plugins are called with prefix 'image_resizer_',
so in regexp speech they match '^image_resizer_.*'. For example
image_resizer_png, image_resizer_jpg and image_resizer_gif.

In the described situation, one might use:

extensions = {}
plugins = EasyPlugins('image_resizer_')

# plugins are now lazy initialized, next time you
# call iteration, it will immediately return
# an iterator of plugin modules
for name, plugin in plugins:
extension = plugin.extension
resizer_class = plugin.Resizer
extensions[extension] = resizer_class

So in general usage is following:

plugins = EasyPlugins('desired_prefix_')

for name, plugin in plugins:
# do whatever you need with the module
# we have a duct typing, use it!
expected_class = plugin.Class
expected_function = plugin.function
custom_terminal_options = plugin.options

Actually you can provide multiple plugin names, for example
for backward compatibility:

plugins = EasyPlugins(['archiver_', 'archiver_plugin_'])

If you would like to add plugins from directory that is not on the path
for some reason, you could still use them by setting the additional path.
This situation usually happens during development of the plugins.

PYTHONPATH=/path/to/plugins /path/to/your/

You can find this project on the bitbucket:

Continuous integration is provided by the

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(4.1 kB) Copy SHA256 Hash SHA256
Source None Nov 4, 2012
(8.5 kB) Copy SHA256 Hash SHA256
Source None Nov 4, 2012

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate