Local project checks and contribution templates: make check, dependency-free C/python tests, issue forms + blank issues, CONTRIBUTING (#20)

* Add lightweight project checks and templates

* Ignore generated test binaries

* Keep project checks local

c/tests/test_benchmark_cuda_fixture.py

@@ -0,0 +1,24 @@
+import unittest
+
+from benchmark_cuda_fixture import parse_output
+
+
+SAMPLE = """
+REPLAY decode: 4 tokens | 12.34 tok/s
+PROFILO: expert-disk 1.25s | expert-matmul 2.50s | attention 0.75s | lm_head 0.10s | altro -0.05s
+"""
+
+
+class ParseOutputTest(unittest.TestCase):
+    def test_extracts_speed_and_profile(self):
+        speed, profile = parse_output(SAMPLE)
+        self.assertEqual(speed, 12.34)
+        self.assertEqual(profile, [1.25, 2.5, 0.75, 0.1, -0.05])
+
+    def test_rejects_incomplete_output(self):
+        with self.assertRaisesRegex(RuntimeError, "benchmark output missing"):
+            parse_output("REPLAY decode: 4 tokens | 12.34 tok/s", "engine failed")
+
+
+if __name__ == "__main__":
+    unittest.main()

c/tests/test_json.c

@@ -0,0 +1,36 @@
+#include <math.h>
+#include <stdio.h>
+#include <string.h>
+
+#include "../json.h"
+
+#define CHECK(condition) do { \
+    if (!(condition)) { \
+        fprintf(stderr, "%s:%d: check failed: %s\n", __FILE__, __LINE__, #condition); \
+        return 1; \
+    } \
+} while (0)
+
+int main(void) {
+    jval *root = json_parse(
+        "{\"name\":\"Colibri\\nCPU\",\"enabled\":true,\"empty\":null,"
+        "\"values\":[1,-2.5,3e2],\"unicode\":\"\\u03bb \\uD83D\\uDE80\"}",
+        NULL
+    );
+
+    CHECK(root && root->t == J_OBJ);
+    CHECK(strcmp(json_get(root, "name")->str, "Colibri\nCPU") == 0);
+    CHECK(json_get(root, "enabled")->boolean == 1);
+    CHECK(json_get(root, "empty")->t == J_NULL);
+    CHECK(json_get(root, "missing") == NULL);
+
+    jval *values = json_get(root, "values");
+    CHECK(values->t == J_ARR && values->len == 3);
+    CHECK(values->kids[0]->num == 1.0);
+    CHECK(values->kids[1]->num == -2.5);
+    CHECK(values->kids[2]->num == 300.0);
+    CHECK(strcmp(json_get(root, "unicode")->str, "λ 🚀") == 0);
+
+    puts("json tests: ok");
+    return 0;
+}

c/tests/test_st.c

@@ -0,0 +1,26 @@
+#include <math.h>
+#include <stdint.h>
+#include <stdio.h>
+
+#include "../st.h"
+
+#define CHECK(condition) do { \
+    if (!(condition)) { \
+        fprintf(stderr, "%s:%d: check failed: %s\n", __FILE__, __LINE__, #condition); \
+        return 1; \
+    } \
+} while (0)
+
+int main(void) {
+    CHECK(bf16_to_f32(0x3f80) == 1.0f);
+    CHECK(bf16_to_f32(0xc020) == -2.5f);
+    CHECK(f16_to_f32(0x3c00) == 1.0f);
+    CHECK(f16_to_f32(0xc100) == -2.5f);
+    CHECK(f16_to_f32(0x0001) > 0.0f);
+    CHECK(isinf(f16_to_f32(0x7c00)));
+    CHECK(st_hash("tensor.weight") == st_hash("tensor.weight"));
+    CHECK(st_hash("tensor.weight") != st_hash("tensor.bias"));
+
+    puts("safetensors primitive tests: ok");
+    return 0;
+}