2013-07-08 09:25:42 -04:00
|
|
|
================
|
2013-09-18 12:07:50 -05:00
|
|
|
stevedore 0.12
|
2013-07-08 09:25:42 -04:00
|
|
|
================
|
2012-08-15 07:21:34 -04:00
|
|
|
|
|
|
|
.. tags:: stevedore release python
|
|
|
|
|
|
|
|
What is stevedore?
|
|
|
|
==================
|
|
|
|
|
|
|
|
Python makes loading code dynamically easy, allowing you to configure
|
|
|
|
and extend your application by discovering and loading extensions
|
|
|
|
("*plugins*") at runtime. Many applications implement their own
|
|
|
|
library for doing this, using ``__import__`` or
|
2012-08-15 07:36:42 -04:00
|
|
|
``importlib``. stevedore_ avoids creating yet another extension
|
2012-08-15 07:21:34 -04:00
|
|
|
mechanism by building on top of `setuptools entry points`_. The code
|
|
|
|
for managing entry points tends to be repetitive, though, so stevedore
|
|
|
|
provides manager classes for implementing common patterns for using
|
|
|
|
dynamically loaded extensions.
|
|
|
|
|
|
|
|
.. _stevedore: http://stevedore.readthedocs.org
|
|
|
|
|
|
|
|
.. _setuptools entry points: http://packages.python.org/distribute/pkg_resources.html#convenience-api
|
|
|
|
|
|
|
|
|
|
|
|
What's New?
|
|
|
|
===========
|
|
|
|
|
2013-09-18 12:05:27 -05:00
|
|
|
- Fixes an exception when reporting on an error where multiple drivers
|
|
|
|
have the same name (bug 25, solution provided by clayg).
|
|
|
|
- Switch packaging to use pbr_.
|
|
|
|
- Add ``map_method()`` API to controllers.
|
|
|
|
|
|
|
|
.. _pbr: https://github.com/openstack-dev/pbr
|
2012-08-15 07:21:34 -04:00
|
|
|
|
|
|
|
Installing
|
|
|
|
==========
|
|
|
|
|
|
|
|
Visit the stevedore_ project page for download links and installation
|
|
|
|
instructions.
|