+ xo-alloc + xo-object + xo-alloc docs + GC utests

utest/GC.test.cpp

@@ -0,0 +1,69 @@
+/* @file GC.test.cpp
+ *
+ * author: Roland Conybeare, Jul 2025
+ */
+
+#include "xo/alloc/GC.hpp"
+#include <catch2/catch.hpp>
+
+namespace xo {
+    using xo::gc::GC;
+    using xo::gc::generation;
+    using xo::gc::Config;
+
+    namespace ut {
+
+        namespace {
+            struct testcase_gc {
+                testcase_gc(std::size_t nz, std::size_t tz) : nursery_z_{nz}, tenured_z_{tz} {}
+
+                std::size_t nursery_z_;
+                std::size_t tenured_z_;
+            };
+
+            std::vector<testcase_gc>
+            s_testcase_v = {
+                testcase_gc(1024, 4096)
+            };
+        }
+
+        TEST_CASE("gc", "[alloc][gc]")
+        {
+            for (std::size_t i_tc = 0, n_tc = s_testcase_v.size(); i_tc < n_tc; ++i_tc) {
+                const testcase_gc & tc = s_testcase_v[i_tc];
+
+                up<GC> gc = GC::make(
+                    {.initial_nursery_z_ = tc.nursery_z_,
+                     .initial_tenured_z_ = tc.tenured_z_});
+
+                REQUIRE(gc.get());
+                REQUIRE(gc->size() == tc.nursery_z_ + tc.tenured_z_);
+                REQUIRE(gc->allocated() == 0);
+                REQUIRE(gc->available() == tc.nursery_z_);
+                REQUIRE(gc->before_checkpoint() == 0);
+                // ListAlloc model is that nothing is before checkpoint
+                // until it's first established
+                REQUIRE(gc->after_checkpoint() == 0);
+
+                REQUIRE(gc->gc_in_progress() == false);
+                REQUIRE(gc->is_gc_enabled() == true);
+                REQUIRE(gc->gc_statistics().gen_v_[gen2int(generation::nursery)].n_gc_ == 0);
+                REQUIRE(gc->gc_statistics().gen_v_[gen2int(generation::tenured)].n_gc_ == 0);
+
+                /* gc with empty state */
+                gc->request_gc(generation::nursery);
+
+                REQUIRE(gc->gc_in_progress() == false);
+                REQUIRE(gc->gc_statistics().gen_v_[gen2int(generation::nursery)].n_gc_ == 1);
+                REQUIRE(gc->gc_statistics().gen_v_[gen2int(generation::tenured)].n_gc_ == 0);
+
+                /* still empty state */
+                gc->request_gc(generation::tenured);
+
+                REQUIRE(gc->gc_in_progress() == false);
+                REQUIRE(gc->gc_statistics().gen_v_[gen2int(generation::nursery)].n_gc_ == 1);
+                REQUIRE(gc->gc_statistics().gen_v_[gen2int(generation::tenured)].n_gc_ == 1);
+            }
+        }
+    } /*namespace ut*/
+} /*namespace xo*/