stevedore/README.rst
liuwei b13d7fe599 update git.openstack.org to opendev
Change-Id: Ie3617d76b6131386c2fa241b41888436ed44909f
2019-04-25 01:07:11 +00:00

29 lines
1.3 KiB
ReStructuredText

===========================================================
stevedore -- Manage dynamic plugins for Python applications
===========================================================
.. image:: https://img.shields.io/pypi/v/stevedore.svg
:target: https://pypi.org/project/stevedore/
:alt: Latest Version
.. image:: https://governance.openstack.org/tc/badges/stevedore.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
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 ``importlib``.
stevedore avoids creating yet another extension
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.
.. _setuptools entry points: http://setuptools.readthedocs.io/en/latest/pkg_resources.html?#entry-points
* Free software: Apache license
* Documentation: https://docs.openstack.org/stevedore/latest
* Source: https://opendev.org/openstack/stevedore
* Bugs: https://bugs.launchpad.net/python-stevedore