mailman.git, branch pluggable-components

Fix coverage, deprecate, but run non-plugin (post|pre)_hooks.

2017-08-07T15:39:08Z

Ignore plugin started subprocesses in master main loop.

2017-08-07T15:39:08Z

Add new logger which plugins can use.

2017-08-07T15:39:08Z

Don't fail when plugins pre_hook or post_hook fails.

2017-08-07T15:39:08Z

- Catches all exceptions raised when running a plugins (pre|post) _hooks. If its pre_hook raises an exception, the plugin is disabled and removed, so its post_hook will not be run and its components will not be loaded. If its post_hook raises an exception we just continue and hope for the best.

Make config.plugin_configs yield a dict with plugin names.

2017-08-07T15:39:08Z

- Allows to better loop over pluging configs and their names.

Add optional external configuration to plugins.

2017-08-07T15:39:08Z

- Adds an optional 'conriguration' option similar to the one in [mta] which plugins can use to load their specific configs from.

Add REST-ability to plugins.

2017-08-07T15:39:07Z

- Adds the rest_object method to the IPlugin interface. This method is called by the REST api to route requests to the plugin's REST api. All attributes are proxied, so the object becomes a true REST object in the ObjectRouter hierarchy. For example see the RESTExample and ExamplePlugin classes in mailman.testing.plugin. The plugin might return None from this method, in which case all calls to it's REST api route will return 404 NotFound. - Adds new routes to the REST api. For version >= 3.1: - /3.1/plugins Returns a dictionary with plugin names as keys, and their configs as values. - /3.1/plugins/ Proxies everything to plugin's rest_object, if plugin with such name exists and provides a non-null rest_object, else NotFound.

Pretty print dicts in dump_json.

2017-08-07T15:39:07Z

- Makes dump_json documentation helper recursively print dicts with indentation. So for example {'name': {'a':1, 'b':2}, 'other': test} becomes: name: a: 1 b: 2 other: test

Add per-plugin hooks, add docs about plugins.

2017-08-07T15:39:07Z

- Removes pre_hook, post_hook and ext_dir. With the latter being unused. Warns on startup if the hooks are present in config. - Adds IPlugin interface with pre_hook and post_hook methods. - Adds 'class' config parameter to plugins, which can be set to a class implementing the IPlugin interface, it will be initialized once on Mailman's startup, then before the DB setup the pre_hook will be run, after DB and other components the post_hook will be run. Plugin instances are stored in the config.plugins dict, with keys being their configuration section names.

Add pluggable components.

2017-08-07T15:39:07Z

- Adds the notion of a 'plugin'. - A plugin has a package path and a flag specifying whether it's enabled or not. - Adds a find_pluggable_components function similar to the find_components one. This one dynamically searches not only the mailman package but all of plugins. - e.g. find_pluggable_components('rules', IRule) finds all IRule components in mailman.rules but also in example_plugin.rules for plugin names example_plugin. - Uses the find_pluggable_components function in place of find_components when searching for Rules, Handlers, Chains, EmailCommands, and Styles.