PluginDiscovery.hpp

Go to the documentation of this file.

 
#ifndef OPENSWMM_PLUGIN_DISCOVERY_HPP
#define OPENSWMM_PLUGIN_DISCOVERY_HPP
 
#include <string>
#include <vector>
 
#include "IPluginComponentInfo.hpp"
 
/* =========================================================================
 * Export macro
 *
 * The engine target sets WINDOWS_EXPORT_ALL_SYMBOLS OFF and relies on explicit
 * export macros (see src/engine/CMakeLists.txt). On ELF/Mach-O the target's
 * CXX_VISIBILITY_PRESET is `default`, so omitting the macro still exports the
 * symbol — which is why the unannotated declarations below linked fine on
 * Linux/macOS while failing on Windows with:
 *     error LNK2001: unresolved external symbol openswmm::discover_all_filters
 * Block is byte-identical to the one in openswmm_engine.h / openswmm_2d.h;
 * identical macro redefinition is well-defined, so including those alongside
 * this header is safe.
 * ========================================================================= */
 
#ifdef OPENSWMM_ENGINE_STATIC
#  define SWMM_ENGINE_API
#else
#  ifdef _WIN32
#    ifdef openswmm_engine_EXPORTS
#      define SWMM_ENGINE_API __declspec(dllexport)
#    else
#      define SWMM_ENGINE_API __declspec(dllimport)
#    endif
#  else
#    define SWMM_ENGINE_API __attribute__((visibility("default")))
#  endif
#endif
 
namespace openswmm {

struct DiscoveredFilter {
    std::string  plugin_id;       
    std::string  plugin_version;  
    std::string  plugin_caption;  
    FileFilter   filter;          

    bool         is_builtin = false;
};

SWMM_ENGINE_API std::vector<DiscoveredFilter> discover_all_filters();

struct DiscoveredPlugin {
    std::string                plugin_id;       
    std::string                plugin_version;  
    std::string                plugin_caption;  
    std::vector<PluginRole>    roles;           
    std::vector<FileFilter>    filters;         

    bool                       is_builtin = false;
};

SWMM_ENGINE_API std::vector<DiscoveredPlugin> discover_plugins_by_id();
 
} /* namespace openswmm */
 
#endif /* OPENSWMM_PLUGIN_DISCOVERY_HPP */