modulemanager 1.0.0
Finds, loads and keeps track of modules at runtime
Loading...
Searching...
No Matches
modulemanager

version: 1.0.0

‍Finds, loads and keeps track of modules at runtime.

Split out of imodule: that repo holds the interface a module answers to, this one holds the machinery that loads them. An interface and a manager are two different jobs.

What is in here

  • ModuleManager — the table of loaded modules. One row per shared library, one column per contract.
  • SharedLibrary — a dlopen/dlsym wrapper, RAII, cross-platform.
  • Stride — the two-axis table ModuleManager is built on. Generic: rows carry an identity, columns carry optional values.

Loading

A loaded library IS a row, a contract IS a column, a module is the cell where they meet. Two identifiers, one per axis :

  • the key you passed to Load() names a row,
  • the static type T names a column.

Both are yours. The manager never reads IModule::name() or type() — a module's address is its position in the table, not something it declares about itself. Those two stay on the module for whoever needs them, typically a plugin host that has no static types to work with.

modules.Load("./raylib_impl.dylib", "ray");
modules.Load("./sfml_impl.dylib", "sfml");
modules.Get<IGraphic2Module>("ray"); // the cell : contract + key
modules.Get<IGraphic3Module>("sfml"); // nullptr, sfml has no 3D
modules.GetAll<IGraphic2Module>(); // every library providing it
modules.GetAll("ray"); // everything "ray" provides
modules.Unload("ray"); // clears the row, closes the dll
A Stride<SharedLibrary, Ts...> : a loaded dll IS a row, a contract (Ts...) IS a column,...
Definition ModuleManager.hpp:52
T * Get(const std::string &key)
The T module of the library named by this key, or nullptr.
Definition ModuleManager.hpp:121
bool Load(const std::string &path, const std::string &key)
Opens the dll, adds its row, fills the columns it provides.
Definition ModuleManager.hpp:72
std::vector< T * > GetAll()
Every library providing T.
Definition ModuleManager.hpp:157
void Unload(const std::string &key)
Clears this row's columns AND its identity, which closes the dll. One call, nothing left to tidy up.
Definition ModuleManager.hpp:89

Partial coverage is not an error : a vendor that only does 2D simply leaves the 3D column empty, and Get returns nullptr.

Find(key) hands back the row itself, so Get<T>(entity) and Get(entity) can work on it without looking the key up again.