fix type definition of names parameter

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Merge pull request #12 from drocco-007/master

NamedExtensionManager can optionally order loaded extensions to match the names parameter.
Correct argument types in name sort tests

The "names" argument is supposed to be a list, not a
single string.

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
document new name_order param in history

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Set up extlinks extension

Configure the extlinks extension to make it easy to link
to issues from the documentation.

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Ignore missing extensions in named dispatch

If the NamedDispatchExtensionManager is told to invoke
and extension that it has not loaded, log the condition
but otherwise ignore it.

Resolves issue #14

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Change sort for NamedExtensionManager

Use a less expensive algorithm for ordering the
extensions.

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Add ExtensionManager.__getitem__

Allow extensions to be accessed directly by name.

Fixes issue #15

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Clean up autodoc for manager classes

Use default settings instead of repeating the options
for each class.

Add docstrings for special methods that do not have them
so they appear in the output.

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Update docs for NameDispatchExtensionManager

Add missing parameter to the table.

Resolves issue #13

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Add PyCon 2013 essay

Add an essay based on my PyCon 2013 presentation.

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Add structure for tutorial

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
add tox env for building docs

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
touch up ceilometer design diagram

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
add docs about names and namespaces

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Add tutorial section on creating plugins

Expand and reorg the naming discussion.

Add a section on the mechanics of creating plugins,
with some tested example code.

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Add example of loading as a driver

Create an example program to load the formatters
from the tutorial as a driver and print some data.

Update run_sphinx to watch .txt files.

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
remove line number references

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
finish tutorial section on loading plugins

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
add reference to test class

Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>