This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
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

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
easy_plugins-1.0.tar.gz (4.1 kB) Copy SHA256 Checksum SHA256 Source Nov 4, 2012 (8.5 kB) Copy SHA256 Checksum SHA256 Source Nov 4, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting