OrcaSlicer/tests/slic3rutils/test_plugin_config.cpp

#include <catch2/catch_all.hpp>

#include <libslic3r/Utils.hpp>
#include <slic3r/plugin/PluginConfig.hpp>

#include "plugin_test_utils.hpp"

#include <boost/filesystem.hpp>
#include <boost/nowide/fstream.hpp>
#include <nlohmann/json.hpp>

#include <string>

using namespace Slic3r;
namespace fs = boost::filesystem;
using json   = nlohmann::json;

namespace {

json read_config_file()
{
    boost::nowide::ifstream ifs(PluginConfig::plugin_config_file().c_str());
    json root;
    ifs >> root;
    return root;
}

void write_config_file(const std::string& contents)
{
    const fs::path path(PluginConfig::plugin_config_file());
    fs::create_directories(path.parent_path());
    boost::nowide::ofstream ofs(path.string().c_str(), std::ios::out | std::ios::trunc);
    ofs << contents;
}

} // namespace

TEST_CASE("PluginConfig creates, reads back and persists a capability config", "[PluginConfig]")
{
    ScopedDataDir data_dir_guard("plugin-config-roundtrip");

    PluginConfig config;

    // A capability nobody has configured yet reads as an empty record rather than throwing.
    CHECK_FALSE(config.has_config("plugin_a", "cap_a"));
    CHECK(config.get_config("plugin_a", "cap_a").empty());

    REQUIRE(config.store_capability_config("plugin_a", "cap_a", json{{"speed", 5}}));

    const BaseConfig stored = config.get_config("plugin_a", "cap_a");
    REQUIRE_FALSE(stored.empty());
    CHECK(stored.plugin_key == "plugin_a");
    CHECK(stored.capability_name == "cap_a");
    CHECK(stored.config == json{{"speed", 5}});
    CHECK(config.has_config("plugin_a", "cap_a"));

    // store_capability_config writes through, so a fresh instance (a restart, in effect) sees it.
    PluginConfig reloaded;
    reloaded.load();
    CHECK(reloaded.get_config("plugin_a", "cap_a").config == json{{"speed", 5}});
}

TEST_CASE("PluginConfig updates only the target capability's cap_config", "[PluginConfig]")
{
    ScopedDataDir data_dir_guard("plugin-config-isolation");

    PluginConfig config;
    // Two capabilities in one plugin, plus a same-named capability in a different plugin: the
    // identity is the (plugin_key, capability) pair, so all three are separate records.
    REQUIRE(config.store_capability_config("plugin_a", "cap_a", json{{"value", 1}}));
    REQUIRE(config.store_capability_config("plugin_a", "cap_b", json{{"value", 2}}));
    REQUIRE(config.store_capability_config("plugin_b", "cap_a", json{{"value", 3}}));

    REQUIRE(config.store_capability_config("plugin_a", "cap_a", json{{"value", 99}}));

    CHECK(config.get_config("plugin_a", "cap_a").config == json{{"value", 99}});
    CHECK(config.get_config("plugin_a", "cap_b").config == json{{"value", 2}});
    CHECK(config.get_config("plugin_b", "cap_a").config == json{{"value", 3}});

    // The same holds on disk, not just in memory.
    PluginConfig reloaded;
    reloaded.load();
    CHECK(reloaded.get_config("plugin_a", "cap_a").config == json{{"value", 99}});
    CHECK(reloaded.get_config("plugin_a", "cap_b").config == json{{"value", 2}});
    CHECK(reloaded.get_config("plugin_b", "cap_a").config == json{{"value", 3}});
}

TEST_CASE("PluginConfig serializes the documented on-disk schema", "[PluginConfig]")
{
    ScopedDataDir data_dir_guard("plugin-config-schema");

    PluginConfig config;
    REQUIRE(config.store_capability_config("plugin_a", "cap_a", json{{"speed", 5}}));

    // Locks the field names: an existing config.json must keep loading after any future change.
    const json root = read_config_file();
    REQUIRE(root.contains("config"));
    REQUIRE(root.at("config").is_array());
    REQUIRE(root.at("config").size() == 1);

    const json& entry = root.at("config").front();
    CHECK(entry.at("plugin_key") == "plugin_a");
    CHECK(entry.at("capability") == "cap_a");
    CHECK(entry.at("cap_config") == json{{"speed", 5}});
    CHECK(entry.contains("plugin_version"));
    // Only cap_config is user data; the rest of the record is host-managed.
    CHECK(entry.size() == 4);
}

TEST_CASE("PluginConfig keeps a capability's config after its plugin goes away", "[PluginConfig]")
{
    ScopedDataDir data_dir_guard("plugin-config-retention");

    {
        PluginConfig config;
        REQUIRE(config.store_capability_config("plugin_a", "cap_a", json{{"token", "keep me"}}));
    }

    // Nothing here installs, uninstalls or unsubscribes a plugin: config.json is deliberately not
    // keyed to installed plugins, so a record outlives the plugin and is still there when the user
    // reinstalls or resubscribes. This asserts no cleanup path silently drops it.
    PluginConfig after_removal;
    after_removal.load();
    CHECK(after_removal.get_config("plugin_a", "cap_a").config == json{{"token", "keep me"}});
}

TEST_CASE("PluginConfig treats a missing config file as an empty store", "[PluginConfig]")
{
    ScopedDataDir data_dir_guard("plugin-config-missing");

    REQUIRE_FALSE(fs::exists(PluginConfig::plugin_config_file()));

    PluginConfig config;
    REQUIRE_NOTHROW(config.load());
    CHECK_FALSE(config.has_config("plugin_a", "cap_a"));
    CHECK_FALSE(config.dirty());
}

TEST_CASE("PluginConfig survives a malformed config file", "[PluginConfig]")
{
    SECTION("not JSON at all")
    {
        ScopedDataDir data_dir_guard("plugin-config-garbage");
        write_config_file("this is not json {{{");

        PluginConfig config;
        REQUIRE_NOTHROW(config.load()); // a bad config must not block startup
        CHECK_FALSE(config.has_config("plugin_a", "cap_a"));
    }

    SECTION("valid JSON without the entries array")
    {
        ScopedDataDir data_dir_guard("plugin-config-noarray");
        write_config_file(R"({"config": {"not": "an array"}})");

        PluginConfig config;
        REQUIRE_NOTHROW(config.load());
        CHECK_FALSE(config.has_config("plugin_a", "cap_a"));
    }

    SECTION("entries without an identity are skipped, the rest still load")
    {
        ScopedDataDir data_dir_guard("plugin-config-partial");
        write_config_file(R"({"config": [
            {"cap_config": {"orphan": true}},
            {"plugin_key": "plugin_a", "capability": "cap_a", "plugin_version": "1.0.0", "cap_config": {"kept": true}}
        ]})");

        PluginConfig config;
        REQUIRE_NOTHROW(config.load());
        CHECK(config.get_config("plugin_a", "cap_a").config == json{{"kept", true}});
        CHECK(config.get_config("plugin_a", "cap_a").plugin_version == "1.0.0");
    }

    SECTION("an entry with no cap_config reads as an empty object")
    {
        ScopedDataDir data_dir_guard("plugin-config-nocap");
        write_config_file(R"({"config": [
            {"plugin_key": "plugin_a", "capability": "cap_a", "plugin_version": "1.0.0"}
        ]})");

        PluginConfig config;
        REQUIRE_NOTHROW(config.load());
        REQUIRE(config.has_config("plugin_a", "cap_a"));
        CHECK(config.get_config("plugin_a", "cap_a").config == json::object());
    }
}

TEST_CASE("PluginConfig refuses to store a record without an identity", "[PluginConfig]")
{
    ScopedDataDir data_dir_guard("plugin-config-identity");

    PluginConfig config;
    config.save_config(BaseConfig{"", "cap_a", "1.0.0", json::object()});
    config.save_config(BaseConfig{"plugin_a", "", "1.0.0", json::object()});

    // Neither could ever be looked up again, so neither is kept.
    CHECK_FALSE(config.has_config("", "cap_a"));
    CHECK_FALSE(config.has_config("plugin_a", ""));
    CHECK_FALSE(config.dirty());
}

TEST_CASE("PluginConfig preserves unknown keys inside cap_config", "[PluginConfig]")
{
    ScopedDataDir data_dir_guard("plugin-config-unknown");

    // The host never interprets cap_config, so a nested/odd shape must round-trip untouched.
    const json nested = json{{"nested", {{"deep", json::array({1, 2, 3})}}}, {"flag", false}, {"name", "x"}};

    PluginConfig config;
    REQUIRE(config.store_capability_config("plugin_a", "cap_a", nested));

    PluginConfig reloaded;
    reloaded.load();
    CHECK(reloaded.get_config("plugin_a", "cap_a").config == nested);
}