Initial commit: DPM core library, CLI, bundled info module, and tests

tests/fixtures/conf/core.conf

@@ -0,0 +1,6 @@
+[logging]
+log_level = ERROR
+write_to_log = false
+
+[modules]
+path = /nonexistent/from/config

tests/fixtures/conf/testmod.conf

@@ -0,0 +1,5 @@
+[main]
+key = value
+
+[section2]
+other = 42

tests/fixtures/src/bad_magic.cpp

@@ -0,0 +1,95 @@
+/**
+ * @file bad_magic.cpp
+ * @brief Broken fixture: API table with a wrong magic constant
+ *
+ * Contract-complete, but its declared table opens with garbage instead
+ * of the spec magic. Core must refuse it at validation step 5.
+ *
+ * Part of the Dark Horse Linux Package Manager (DPM)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+#include <cstdint>
+
+namespace {
+
+struct table_header {
+    uint32_t magic;
+    uint32_t size;
+};
+
+struct manifest_entry {
+    const char* api_name;
+    int         table_version;
+    const char* symbol;
+};
+
+struct manifest {
+    uint32_t              count;
+    const manifest_entry* entries;
+};
+
+} // namespace
+
+struct badmagic_api_v1_s {
+    table_header hdr;
+    int (*ping)(void);
+};
+
+static int ping(void)
+{
+    return 0;
+}
+
+extern "C" {
+    extern const struct badmagic_api_v1_s badmagic_api_v1;
+    const struct badmagic_api_v1_s badmagic_api_v1 = {
+        { 0xDEADBEEFu, sizeof(struct badmagic_api_v1_s) },
+        ping,
+    };
+}
+
+extern "C" const char* dpm_module_version(void)
+{
+    return "1.0.0";
+}
+
+extern "C" const char* dpm_module_description(void)
+{
+    return "Fixture with a bad table magic.";
+}
+
+extern "C" const char* dpm_module_core_min(void)
+{
+    return "0.1.0";
+}
+
+extern "C" const void* dpm_module_manifest(void)
+{
+    static const manifest_entry entries[] = {
+        { "badmagic", 1, "badmagic_api_v1" },
+    };
+    static const manifest m = { 1, entries };
+    return &m;
+}
+
+extern "C" int dpm_module_execute(void* ctx, const char* command,
+                                  int argc, char** argv)
+{
+    (void)ctx;
+    (void)command;
+    (void)argc;
+    (void)argv;
+    return 0;
+}

tests/fixtures/src/bad_version.cpp

@@ -0,0 +1,69 @@
+/**
+ * @file bad_version.cpp
+ * @brief Broken fixture: malformed module version string
+ *
+ * Contract-complete, but dpm_module_version() returns something that
+ * is not X.Y.Z. Core must refuse it at validation step 3.
+ *
+ * Part of the Dark Horse Linux Package Manager (DPM)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+#include <cstdint>
+
+namespace {
+
+struct manifest_entry {
+    const char* api_name;
+    int         table_version;
+    const char* symbol;
+};
+
+struct manifest {
+    uint32_t              count;
+    const manifest_entry* entries;
+};
+
+} // namespace
+
+extern "C" const char* dpm_module_version(void)
+{
+    return "banana";
+}
+
+extern "C" const char* dpm_module_description(void)
+{
+    return "Fixture with a malformed version.";
+}
+
+extern "C" const char* dpm_module_core_min(void)
+{
+    return "0.1.0";
+}
+
+extern "C" const void* dpm_module_manifest(void)
+{
+    static const manifest m = { 0, nullptr };
+    return &m;
+}
+
+extern "C" int dpm_module_execute(void* ctx, const char* command,
+                                  int argc, char** argv)
+{
+    (void)ctx;
+    (void)command;
+    (void)argc;
+    (void)argv;
+    return 0;
+}

tests/fixtures/src/core_too_new.cpp

@@ -0,0 +1,70 @@
+/**
+ * @file core_too_new.cpp
+ * @brief Broken fixture: demands a core newer than any that exists
+ *
+ * Contract-complete, but dpm_module_core_min() reports 99.0.0. Core
+ * must refuse it at validation step 2 with a message naming the
+ * remedy (update core).
+ *
+ * Part of the Dark Horse Linux Package Manager (DPM)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+#include <cstdint>
+
+namespace {
+
+struct manifest_entry {
+    const char* api_name;
+    int         table_version;
+    const char* symbol;
+};
+
+struct manifest {
+    uint32_t              count;
+    const manifest_entry* entries;
+};
+
+} // namespace
+
+extern "C" const char* dpm_module_version(void)
+{
+    return "1.0.0";
+}
+
+extern "C" const char* dpm_module_description(void)
+{
+    return "Fixture demanding a future core.";
+}
+
+extern "C" const char* dpm_module_core_min(void)
+{
+    return "99.0.0";
+}
+
+extern "C" const void* dpm_module_manifest(void)
+{
+    static const manifest m = { 0, nullptr };
+    return &m;
+}
+
+extern "C" int dpm_module_execute(void* ctx, const char* command,
+                                  int argc, char** argv)
+{
+    (void)ctx;
+    (void)command;
+    (void)argc;
+    (void)argv;
+    return 0;
+}

tests/fixtures/src/good.cpp

@@ -0,0 +1,96 @@
+/**
+ * @file good.cpp
+ * @brief Known-good stub module fixture
+ *
+ * A complete, valid DPM module written against the documented module
+ * contract with its own declarations — no core headers — exactly as a
+ * standalone module author would. Used to validate core's happy path.
+ *
+ * Part of the Dark Horse Linux Package Manager (DPM)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+#include <cstdint>
+
+namespace {
+
+struct table_header {
+    uint32_t magic;
+    uint32_t size;
+};
+
+struct manifest_entry {
+    const char* api_name;
+    int         table_version;
+    const char* symbol;
+};
+
+struct manifest {
+    uint32_t              count;
+    const manifest_entry* entries;
+};
+
+} // namespace
+
+struct good_api_v1_s {
+    table_header hdr;
+    int (*ping)(void);
+};
+
+static int ping(void)
+{
+    return 42;
+}
+
+extern "C" {
+    extern const struct good_api_v1_s good_api_v1;
+    const struct good_api_v1_s good_api_v1 = {
+        { 0x314D5044u /* "DPM1" */, sizeof(struct good_api_v1_s) },
+        ping,
+    };
+}
+
+extern "C" const char* dpm_module_version(void)
+{
+    return "1.2.3";
+}
+
+extern "C" const char* dpm_module_description(void)
+{
+    return "Known-good stub module.";
+}
+
+extern "C" const char* dpm_module_core_min(void)
+{
+    return "0.1.0";
+}
+
+extern "C" const void* dpm_module_manifest(void)
+{
+    static const manifest_entry entries[] = {
+        { "good", 1, "good_api_v1" },
+    };
+    static const manifest m = { 1, entries };
+    return &m;
+}
+
+extern "C" int dpm_module_execute(void* ctx, const char* command,
+                                  int argc, char** argv)
+{
+    (void)ctx;
+    (void)command;
+    (void)argc;
+    (void)argv;
+    return 0;
+}

tests/fixtures/src/lying_manifest.cpp

@@ -0,0 +1,72 @@
+/**
+ * @file lying_manifest.cpp
+ * @brief Broken fixture: manifest declares an API it doesn't export
+ *
+ * Contract-complete, but its manifest names a table symbol that does
+ * not exist in the .so. Core must refuse it at validation step 4.
+ *
+ * Part of the Dark Horse Linux Package Manager (DPM)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+#include <cstdint>
+
+namespace {
+
+struct manifest_entry {
+    const char* api_name;
+    int         table_version;
+    const char* symbol;
+};
+
+struct manifest {
+    uint32_t              count;
+    const manifest_entry* entries;
+};
+
+} // namespace
+
+extern "C" const char* dpm_module_version(void)
+{
+    return "1.0.0";
+}
+
+extern "C" const char* dpm_module_description(void)
+{
+    return "Fixture whose manifest lies.";
+}
+
+extern "C" const char* dpm_module_core_min(void)
+{
+    return "0.1.0";
+}
+
+extern "C" const void* dpm_module_manifest(void)
+{
+    static const manifest_entry entries[] = {
+        { "ghost", 1, "ghost_api_v1" },
+    };
+    static const manifest m = { 1, entries };
+    return &m;
+}
+
+extern "C" int dpm_module_execute(void* ctx, const char* command,
+                                  int argc, char** argv)
+{
+    (void)ctx;
+    (void)command;
+    (void)argc;
+    (void)argv;
+    return 0;
+}

tests/fixtures/src/missing_symbols.cpp

@@ -0,0 +1,33 @@
+/**
+ * @file missing_symbols.cpp
+ * @brief Broken fixture: exports only part of the module contract
+ *
+ * Missing dpm_module_execute, dpm_module_core_min, and
+ * dpm_module_manifest. Core must refuse it at validation step 1 and
+ * name the missing symbols.
+ *
+ * Part of the Dark Horse Linux Package Manager (DPM)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+extern "C" const char* dpm_module_version(void)
+{
+    return "1.0.0";
+}
+
+extern "C" const char* dpm_module_description(void)
+{
+    return "Fixture missing most of the contract.";
+}