Plugin loader, auto-discovery, and lifecycle manager. More...

#include <string>
#include <vector>
#include <unordered_map>
#include <functional>

Include dependency graph for PluginFactory.hpp:

This graph shows which files directly or indirectly include this file:

Classes
class	openswmm::PluginFactory
	Manages plugin discovery, loading, and lifecycle for one engine instance. More...

struct	openswmm::PluginFactory::ComponentEntry
	List all discovered component info entries. More...

Detailed Description

Plugin loader, auto-discovery, and lifecycle manager.

PluginFactory owns all dynamically loaded plugin libraries. It is responsible for:

Auto-discovery — On construction, scans the engine library directory and subdirectories (plugins/, components/) for compatible shared libraries that export openswmm_plugin_info. Discovered libraries are registered in a component registry keyed by "id:version".
Resolution — Given a string that is either a file path or an "id" / "id:version" identifier, resolves it to an IPluginComponentInfo.
Instantiation — Creates IInputPlugin, IOutputPlugin, or IReportPlugin instances via factory methods on IPluginComponentInfo.
Lifecycle dispatch — Calls initialize(), validate(), prepare(), finalize(), and write_summary() on all loaded plugin instances.
Cleanup — dlclose() on all library handles at destruction.

All lifecycle methods except update() run on the main simulation thread. update() is called from the IO thread (via IOThread).

See also: IPluginComponentInfo.hpp; IInputPlugin.hpp; IOutputPlugin.hpp; IReportPlugin.hpp

Classes