plugin.hpp

#pragma once
 
#include <cstdint>
#include <optional>
#include <span>
#include <string>
 
#include "handle.hpp"
#include "mem_addr.hpp"
#include "method.hpp"
#include "path.hpp"
 
#include <plugify_export.h>
 
namespace plugify {
    class Plugin;
    class PluginDescriptorHandle;
    class MethodHandle;
 
    enum class PluginState {
        NotLoaded,
        Error,
        Loaded,
        Running,
        Terminating,
        Unknown,
    };
 
    using UniqueId = std::ptrdiff_t;
 
    class PLUGIFY_API PluginHandle : public Handle<const Plugin> {
        using Handle::Handle;
    public:
        UniqueId GetId() const noexcept;
 
        std::string_view GetName() const noexcept;
 
        std::string_view GetFriendlyName() const noexcept;
 
        std::filesystem::path_view GetBaseDir() const noexcept;
 
        PluginDescriptorHandle GetDescriptor() const noexcept;
 
        PluginState GetState() const noexcept;
 
        std::string_view GetError() const noexcept;
 
        std::span<const MethodData> GetMethods() const noexcept;
 
        MemAddr GetData() const noexcept;
 
        std::optional<std::filesystem::path_view> FindResource(std::filesystem::path_view path) const;
    };
 
    namespace PluginUtils {
        constexpr std::string_view ToString(PluginState state) {
            switch (state) {
                case PluginState::NotLoaded:   return "NotLoaded";
                case PluginState::Error:       return "Error";
                case PluginState::Loaded:      return "Loaded";
                case PluginState::Running:     return "Running";
                case PluginState::Terminating: return "Terminating";
                default:                       return "Unknown";
            }
        }
 
        constexpr PluginState FromString(std::string_view state) {
            if (state == "NotLoaded") {
                return PluginState::NotLoaded;
            } else if (state == "Error") {
                return PluginState::Error;
            } else if (state == "Loaded") {
                return PluginState::Loaded;
            } else if (state == "Running") {
                return PluginState::Running;
            } else if (state == "Terminating") {
                return PluginState::Terminating;
            }
            return PluginState::Unknown;
        }
    } // namespace PluginUtils
 
} // namespace plugify