From 832c155a3a299698bed6428d88da7512f2970d4f Mon Sep 17 00:00:00 2001
From: DualFroz <me@dualfroz.com>
Date: Thu, 10 Sep 2026 23:29:57 +0200
Subject: [PATCH] test: cover ringTest

---
 src/ringTest.c | 117 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 117 insertions(+)
 create mode 100644 src/ringTest.c

diff --git a/src/ringTest.c b/src/ringTest.c
new file mode 100644
index 0000000..e841e05
--- /dev/null
+++ b/src/ringTest.c
@@ -0,0 +1,117 @@
+#include "ktest.h"
+#include "ring.h"
+
+KTEST(ringBasicPushPop)
+{
+    uint8 backing[4];
+    RingBuffer r;
+    ringInit(&r, backing, sizeof(backing));
+
+    KT_TRUE(t, ringIsEmpty(&r));
+    KT_FALSE(t, ringIsFull(&r));
+    KT_EQ(t, ringCapacity(&r), 4);
+    KT_EQ(t, ringFreeSpace(&r), 4);
+
+    KT_TRUE(t, ringPush(&r, 'a'));
+    KT_TRUE(t, ringPush(&r, 'b'));
+    KT_EQ(t, ringCount(&r), 2);
+    KT_EQ(t, ringFreeSpace(&r), 2);
+
+    uint8 out;
+    KT_TRUE(t, ringPop(&r, &out));
+    KT_EQ(t, out, 'a');
+    KT_TRUE(t, ringPop(&r, &out));
+    KT_EQ(t, out, 'b');
+    KT_TRUE(t, ringIsEmpty(&r));
+}
+
+KTEST(ringFillsAndRejects)
+{
+    uint8 backing[3];
+    RingBuffer r;
+    ringInit(&r, backing, sizeof(backing));
+
+    KT_TRUE(t, ringPush(&r, 1));
+    KT_TRUE(t, ringPush(&r, 2));
+    KT_TRUE(t, ringPush(&r, 3));
+    KT_TRUE(t, ringIsFull(&r));
+    KT_FALSE(t, ringPush(&r, 4));   /* rejected, buffer unchanged */
+    KT_EQ(t, ringCount(&r), 3);
+
+    uint8 out;
+    ringPop(&r, &out);
+    KT_EQ(t, out, 1);
+    KT_FALSE(t, ringIsFull(&r));
+    KT_TRUE(t, ringPush(&r, 4));    /* room again after the pop */
+}
+
+KTEST(ringWrapsAroundCorrectly)
+{
+    uint8 backing[4];
+    RingBuffer r;
+    ringInit(&r, backing, sizeof(backing));
+
+    /* fill, drain two, push two more so the write wraps past the array end */
+    ringPush(&r, 1);
+    ringPush(&r, 2);
+    ringPush(&r, 3);
+    ringPush(&r, 4);
+    uint8 out;
+    ringPop(&r, &out);
+    KT_EQ(t, out, 1);
+    ringPop(&r, &out);
+    KT_EQ(t, out, 2);
+    ringPush(&r, 5);
+    ringPush(&r, 6);
+
+    ringPop(&r, &out);
+    KT_EQ(t, out, 3);
+    ringPop(&r, &out);
+    KT_EQ(t, out, 4);
+    ringPop(&r, &out);
+    KT_EQ(t, out, 5);
+    ringPop(&r, &out);
+    KT_EQ(t, out, 6);
+    KT_TRUE(t, ringIsEmpty(&r));
+}
+
+KTEST(ringBulkWriteRead)
+{
+    uint8 backing[8];
+    RingBuffer r;
+    ringInit(&r, backing, sizeof(backing));
+
+    const uint8 msg[] = { 10, 20, 30, 40, 50 };
+    usize written = ringWrite(&r, msg, sizeof(msg));
+    KT_EQ(t, written, 5);
+    KT_EQ(t, ringCount(&r), 5);
+
+    /* only 3 more bytes fit before capacity 8 is reached */
+    const uint8 more[] = { 1, 2, 3, 4 };
+    usize written2 = ringWrite(&r, more, sizeof(more));
+    KT_EQ(t, written2, 3);
+    KT_TRUE(t, ringIsFull(&r));
+
+    uint8 outBuf[16];
+    usize readCount = ringRead(&r, outBuf, sizeof(outBuf));
+    KT_EQ(t, readCount, 8);
+    KT_EQ(t, outBuf[0], 10);
+    KT_EQ(t, outBuf[4], 50);
+    KT_EQ(t, outBuf[5], 1);
+    KT_EQ(t, outBuf[7], 3);
+    KT_TRUE(t, ringIsEmpty(&r));
+}
+
+KTEST(ringClearResets)
+{
+    uint8 backing[4];
+    RingBuffer r;
+    ringInit(&r, backing, sizeof(backing));
+    ringPush(&r, 1);
+    ringPush(&r, 2);
+
+    ringClear(&r);
+    KT_TRUE(t, ringIsEmpty(&r));
+    KT_EQ(t, ringCount(&r), 0);
+    KT_EQ(t, ringFreeSpace(&r), 4);
+}