Testing Guide | Geode Database

<h2 id="testing-guide" class="position-relative d-flex align-items-center group"> Testing Guide <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="testing-guide" aria-haspopup="dialog" aria-label="Share link: Testing Guide"> Share link </button> </h2><div id="headingShareModal" class="heading-share-modal" role="dialog" aria-modal="true" aria-labelledby="headingShareTitle" hidden> <div class="hsm-dialog" role="document"> <div class="hsm-header"> <h2 id="headingShareTitle" class="h6 mb-0 fw-bold">Share this section</h2> <button type="button" class="hsm-close" aria-label="Close"> </button> </div> <div class="hsm-body"> <label for="headingShareInput" class="form-label small text-muted mb-1 text-uppercase fw-bold" style="font-size: 0.7rem; letter-spacing: 0.5px;">Permalink</label> <div class="input-group mb-4 hsm-url-group"> <input id="headingShareInput" type="text" class="form-control font-monospace" readonly aria-readonly="true" style="font-size: 0.85rem;" /> <button class="btn btn-primary hsm-copy" type="button" aria-label="Copy" title="Copy"> </button> </div> <div class="small fw-bold mb-2 text-muted text-uppercase" style="font-size: 0.7rem; letter-spacing: 0.5px;">Share via</div> <div class="hsm-share-grid"> <a id="share-twitter" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Twitter </a> <a id="share-linkedin" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> LinkedIn </a> <a id="share-facebook" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Facebook </a> </div> </div> </div> </div> <style> .heading-share-modal { position: fixed; inset: 0; display: flex; justify-content: center; align-items: center; background: rgba(0, 0, 0, 0.6); z-index: 1050; padding: 1rem; backdrop-filter: blur(4px); -webkit-backdrop-filter: blur(4px); } .heading-share-modal[hidden] { display: none !important; } .hsm-dialog { max-width: 420px; width: 100%; background: var(--bs-body-bg, #fff); color: var(--bs-body-color, #212529); border: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); border-radius: 1rem; box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25); overflow: hidden; animation: hsm-fade-in 0.2s ease-out; } @keyframes hsm-fade-in { from { opacity: 0; transform: scale(0.95); } to { opacity: 1; transform: scale(1); } } [data-bs-theme="dark"] .hsm-dialog { background: #1e293b; border-color: rgba(255,255,255,0.1); color: #f8f9fa; } .hsm-header { display: flex; justify-content: space-between; align-items: center; padding: 1rem 1.5rem; border-bottom: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); background: rgba(0,0,0,0.02); } [data-bs-theme="dark"] .hsm-header { background: rgba(255,255,255,0.02); border-color: rgba(255,255,255,0.1); } .hsm-close { background: transparent; border: none; color: inherit; opacity: 0.5; padding: 0.25rem 0.5rem; border-radius: 0.25rem; font-size: 1.2rem; line-height: 1; transition: opacity 0.2s; } .hsm-close:hover { opacity: 1; } .hsm-body { padding: 1.5rem; } .hsm-url-group { display: flex !important; align-items: stretch; } .hsm-url-group .form-control { flex: 1; min-width: 0; margin: 0; background: var(--bs-secondary-bg, #f8f9fa); border-color: var(--bs-border-color, #dee2e6); border-top-right-radius: 0; border-bottom-right-radius: 0; height: 42px; } .hsm-url-group .btn { flex: 0 0 auto; margin: 0; margin-left: -1px; border-top-left-radius: 0; border-bottom-left-radius: 0; height: 42px; display: flex; align-items: center; justify-content: center; padding: 0 1.25rem; z-index: 2; } [data-bs-theme="dark"] .hsm-url-group .form-control { background: #0f172a; border-color: #334155; color: #e2e8f0; } .hsm-share-grid { display: flex; flex-direction: column; gap: 0.5rem; } .hsm-share-grid .btn { display: flex; align-items: center; justify-content: center; font-size: 0.9rem; padding: 0.6rem; border-color: var(--bs-border-color); width: 100%; } [data-bs-theme="dark"] .hsm-share-grid .btn { color: #e2e8f0; border-color: #475569; } [data-bs-theme="dark"] .hsm-share-grid .btn:hover { background: #334155; border-color: #cbd5e1; } </style> <script> (function(){ const modal = document.getElementById('headingShareModal'); if(!modal) return; const input = modal.querySelector('#headingShareInput'); const copyBtn = modal.querySelector('.hsm-copy'); const twitter = modal.querySelector('#share-twitter'); const linkedin = modal.querySelector('#share-linkedin'); const facebook = modal.querySelector('#share-facebook'); const closeBtn = modal.querySelector('.hsm-close'); let lastFocus=null; let trapBound=false; function buildUrl(id){ return window.location.origin + window.location.pathname + '#' + id; } function isOpen(){ return !modal.hasAttribute('hidden'); } function hydrate(id){ const url=buildUrl(id); input.value=url; const enc=encodeURIComponent(url); const text=encodeURIComponent(document.title); if(twitter) twitter.href=`https://twitter.com/intent/tweet?url=${enc}&text=${text}`; if(linkedin) linkedin.href=`https://www.linkedin.com/sharing/share-offsite/?url=${enc}`; if(facebook) facebook.href=`https://www.facebook.com/sharer/sharer.php?u=${enc}`; } function openModal(id){ lastFocus=document.activeElement; hydrate(id); if(!isOpen()){ modal.removeAttribute('hidden'); } requestAnimationFrame(()=>{ input.focus(); }); trapFocus(); } function closeModal(){ if(!isOpen()) return; modal.setAttribute('hidden',''); if(lastFocus && typeof lastFocus.focus==='function') lastFocus.focus(); } function copyCurrent(){ try{ navigator.clipboard.writeText(input.value).then(()=>feedback(true),()=>fallback()); } catch(e){ fallback(); } } function fallback(){ input.select(); try{ document.execCommand('copy'); feedback(true);}catch(e){ feedback(false);} } function feedback(ok){ if(!copyBtn) return; const icon=copyBtn.querySelector('i'); if(!icon) return; const prev=copyBtn.getAttribute('data-prev')||icon.className; if(!copyBtn.getAttribute('data-prev')) copyBtn.setAttribute('data-prev',prev); icon.className= ok ? 'fa-duotone fa-clipboard-check':'fa-duotone fa-circle-exclamation'; setTimeout(()=>{ icon.className=prev; },1800); } function handleShareClick(e){ e.preventDefault(); const btn=e.currentTarget; const id=btn.getAttribute('data-share-target'); if(id) openModal(id); } function bindShareButtons(){ document.querySelectorAll('.h-share').forEach(btn=>{ if(!btn.dataset.hShareBound){ btn.addEventListener('click', handleShareClick); btn.dataset.hShareBound='1'; } }); } bindShareButtons(); if(document.readyState==='loading'){ document.addEventListener('DOMContentLoaded', bindShareButtons); } else { requestAnimationFrame(bindShareButtons); } document.addEventListener('click', function(e){ const shareBtn=e.target.closest && e.target.closest('.h-share'); if(shareBtn && !shareBtn.dataset.hShareBound){ handleShareClick.call(shareBtn, e); } }, true); document.addEventListener('click', e=>{ if(e.target===modal) closeModal(); if(e.target.closest && e.target.closest('.hsm-close')){ e.preventDefault(); closeModal(); } if(copyBtn && (e.target===copyBtn || (e.target.closest && e.target.closest('.hsm-copy')))) { e.preventDefault(); copyCurrent(); } }); document.addEventListener('keydown', e=>{ if(e.key==='Escape' && isOpen()) closeModal(); }); function trapFocus(){ if(trapBound) return; trapBound=true; modal.addEventListener('keydown', f=>{ if(f.key==='Tab' && isOpen()){ const focusable=[...modal.querySelectorAll('a[href],button,input,textarea,select,[tabindex]:not([tabindex="-1"])')].filter(el=>!el.hasAttribute('disabled')); if(!focusable.length) return; const first=focusable[0]; const last=focusable[focusable.length-1]; if(f.shiftKey && document.activeElement===first){ f.preventDefault(); last.focus(); } else if(!f.shiftKey && document.activeElement===last){ f.preventDefault(); first.focus(); } } }); } if(closeBtn) closeBtn.addEventListener('click', e=>{ e.preventDefault(); closeModal(); }); })(); </script>Geode maintains broad automated coverage across unit tests, geodetestlab integration specs, transport tests, and release validation. This page reflects the latest full-suite audit and release-line test status from March 2026. <h3 id="overview" class="position-relative d-flex align-items-center group"> Overview <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="overview" aria-haspopup="dialog" aria-label="Share link: Overview"> Share link </button> </h3> <h4 id="test-coverage-summary" class="position-relative d-flex align-items-center group"> Test Coverage Summary <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-coverage-summary" aria-haspopup="dialog" aria-label="Share link: Test Coverage Summary"> Share link </button> </h4>Current Status (as of March 29, 2026): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text">Extended Integration Tests (full suite): Total: 3,952 tests Passing: 3,847 tests (97.4%) Failing: 70 tests (1.8%) Skipped: 35 tests (0.9%) Unit Tests (Zig): Total: 619 test blocks Passing: 619 tests (100%) GQL Conformance Profile: Scope: ISO/IEC 39075:2024 compliance (see conformance profile) Status: tracked in CI with published diagnostics Note: conformance remains green while transport and storage regression suites continue to grow CANARY Governance: Status: tracked continuously; see current release notes and governance tooling </code></pre></div>Current open failure concentration: <table> <thead> <tr> <th>Area</th> <th>Current Note</th> </tr> </thead> <tbody> <tr> <td>CLI auth delegation</td> <td>Majority of remaining failures (<code>GAP-0270</code>)</td> </tr> <tr> <td>FLE role parsing</td> <td>One high-severity open issue (<code>GAP-0271</code>)</td> </tr> <tr> <td>stdin bulk <code>MERGE</code></td> <td>One stability issue (<code>GAP-0272</code>)</td> </tr> <tr> <td>Storage persistence regressions</td> <td>March 29 fixes substantially reduced failures; audit now distinguishes released vs post-tag fixes</td> </tr> </tbody> </table> <h4 id="testing-frameworks" class="position-relative d-flex align-items-center group"> Testing Frameworks <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="testing-frameworks" aria-haspopup="dialog" aria-label="Share link: Testing Frameworks"> Share link </button> </h4>Geode uses multiple complementary testing frameworks: <ol> <li>Zig Unit Tests (<code>zig test</code>) - Fast, inline tests for individual functions</li> <li>geodetestlab - Python-based integration testing with YAML specifications</li> <li>Regression Tests - Shell scripts for specific bug scenarios</li> <li>Fuzz Testing - Randomized input testing for parser and storage</li> <li>Benchmark Tests - Performance regression detection</li> <li>GQL Conformance Tests - Profile-based GQL conformance</li> </ol> <h3 id="quick-start" class="position-relative d-flex align-items-center group"> Quick Start <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="quick-start" aria-haspopup="dialog" aria-label="Share link: Quick Start"> Share link </button> </h3> <h4 id="running-all-tests" class="position-relative d-flex align-items-center group"> Running All Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="running-all-tests" aria-haspopup="dialog" aria-label="Share link: Running All Tests"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># From repository root cd /home/benji/src/gl/devnw/codepros/geode/geode # Quick verification (unit tests only) make test # Integration tests make integration-test # Full geodetestlab suite python3 scripts/test/extended_test_runner.py # Comprehensive test suite (all tests) make geodetestlab-comprehensive # Specific test spec python3 scripts/test/extended_test_runner.py --specs geodetestlab/specs/geode_gql_compliance.yml # Verbose output python3 scripts/test/extended_test_runner.py --verbose # Generate test report python3 scripts/test/extended_test_runner.py --report test-results.json </code></pre></div> <h4 id="running-specific-test-categories" class="position-relative d-flex align-items-center group"> Running Specific Test Categories <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="running-specific-test-categories" aria-haspopup="dialog" aria-label="Share link: Running Specific Test Categories"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Authentication tests only python3 scripts/test/extended_test_runner.py --specs geodetestlab/specs/auth*.yml # GQL compliance tests python3 scripts/test/extended_test_runner.py --specs geodetestlab/specs/geode_gql_compliance.yml # Regression tests ./tests/comprehensive_regression_test.sh ./tests/limit_skip_regression_test.sh ./tests/property_ordering_regression_test.sh ./tests/count_aggregation_regression_test.sh # Fuzz tests make fuzz # Benchmark tests make bench </code></pre></div> <h4 id="test-environment-setup" class="position-relative d-flex align-items-center group"> Test Environment Setup <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-environment-setup" aria-haspopup="dialog" aria-label="Share link: Test Environment Setup"> Share link </button> </h4>Prerequisites: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Python 3.9+ with dependencies python3 --version # Should be 3.9 or higher pip install pyyaml # For geodetestlab # Zig 0.1.0+ for unit tests zig version # Should be 0.1.0 or higher # Build Geode binary make build # Verify build ./zig-out/bin/geode --version </code></pre></div>Environment Variables: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Enable debug output export GEODE_DEBUG=1 # Capture server stderr in tests export GEODE_CAPTURE_SERVER_STDERR=1 # Set test timeout (seconds) export GEODE_TEST_TIMEOUT=30 # Enable JSON logging export GEODE_LOG_JSON=1 </code></pre></div> <h3 id="zig-unit-tests" class="position-relative d-flex align-items-center group"> Zig Unit Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="zig-unit-tests" aria-haspopup="dialog" aria-label="Share link: Zig Unit Tests"> Share link </button> </h3> <h4 id="overview-1" class="position-relative d-flex align-items-center group"> Overview <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="overview-1" aria-haspopup="dialog" aria-label="Share link: Overview"> Share link </button> </h4>Unit tests are embedded directly in Zig source files using <code>test</code> blocks. They provide fast, fine-grained testing of individual functions and modules. <h4 id="writing-unit-tests" class="position-relative d-flex align-items-center group"> Writing Unit Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="writing-unit-tests" aria-haspopup="dialog" aria-label="Share link: Writing Unit Tests"> Share link </button> </h4>Basic Test Structure: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">const std = @import("std"); const testing = std.testing; pub fn add(a: i32, b: i32) i32 { return a + b; } test "add: basic addition" { try testing.expectEqual(@as(i32, 5), add(2, 3)); try testing.expectEqual(@as(i32, 0), add(-1, 1)); try testing.expectEqual(@as(i32, -5), add(-2, -3)); } </code></pre></div>Testing with Allocators: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">test "ArrayList: append and get" { const allocator = testing.allocator; var list = std.ArrayList(i32).init(allocator); defer list.deinit(); try list.append(42); try list.append(100); try testing.expectEqual(@as(i32, 42), list.items[0]); try testing.expectEqual(@as(i32, 100), list.items[1]); try testing.expectEqual(@as(usize, 2), list.items.len); } </code></pre></div>Testing Error Conditions: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">pub fn divide(a: i32, b: i32) !i32 { if (b == 0) return error.DivisionByZero; return @divTrunc(a, b); } test "divide: division by zero" { try testing.expectError(error.DivisionByZero, divide(10, 0)); } test "divide: successful division" { try testing.expectEqual(@as(i32, 5), try divide(10, 2)); try testing.expectEqual(@as(i32, -3), try divide(-9, 3)); } </code></pre></div>Testing Complex Structures: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">const Node = struct { id: u64, name: []const u8, properties: std.StringHashMap([]const u8), pub fn create(allocator: std.mem.Allocator, id: u64, name: []const u8) !Node { var props = std.StringHashMap([]const u8).init(allocator); return Node{ .id = id, .name = name, .properties = props, }; } pub fn deinit(self: *Node) void { self.properties.deinit(); } }; test "Node: creation and properties" { const allocator = testing.allocator; var node = try Node.create(allocator, 1, "test_node"); defer node.deinit(); try testing.expectEqual(@as(u64, 1), node.id); try testing.expectEqualStrings("test_node", node.name); try node.properties.put("key1", "value1"); try testing.expectEqualStrings("value1", node.properties.get("key1").?); } </code></pre></div> <h4 id="running-unit-tests" class="position-relative d-flex align-items-center group"> Running Unit Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="running-unit-tests" aria-haspopup="dialog" aria-label="Share link: Running Unit Tests"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run all tests in a file zig test src/storage/heap.zig # Run specific test by name filter zig test src/storage/heap.zig --test-filter "allocate" # Run with verbose output zig test src/storage/heap.zig --summary all # Run with debug symbols zig test src/storage/heap.zig -O Debug # Run all project tests make test # Run with coverage (using kcov or similar) zig test src/storage/heap.zig --test-coverage </code></pre></div> <h4 id="test-organization" class="position-relative d-flex align-items-center group"> Test Organization <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-organization" aria-haspopup="dialog" aria-label="Share link: Test Organization"> Share link </button> </h4>Best Practices: <ul> <li>Colocate tests - Keep tests near the code they test</li> <li>Descriptive names - Use format “component: specific behavior”</li> <li>Test edge cases - Include boundary conditions and error paths</li> <li>Clean up resources - Always use <code>defer</code> for cleanup</li> <li>Avoid dependencies - Tests should be independent and isolated</li> </ul> Example Test Organization: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// src/storage/heap.zig pub const Heap = struct { // ... implementation ... }; // Unit tests for Heap test "Heap: initialization" { ... } test "Heap: allocate page" { ... } test "Heap: deallocate page" { ... } test "Heap: grow heap" { ... } test "Heap: out of memory" { ... } test "Heap: fragmentation handling" { ... } </code></pre></div> <h4 id="common-patterns" class="position-relative d-flex align-items-center group"> Common Patterns <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="common-patterns" aria-haspopup="dialog" aria-label="Share link: Common Patterns"> Share link </button> </h4>Testing Allocations: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">test "MyStruct: no memory leaks" { const allocator = testing.allocator; var obj = try MyStruct.init(allocator); defer obj.deinit(); // Cleanup automatically checked // Use obj... // testing.allocator will fail if memory leaked } </code></pre></div>Testing Concurrency: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">test "ThreadPool: concurrent task execution" { const allocator = testing.allocator; var pool = try ThreadPool.init(allocator, 4); defer pool.deinit(); var counter = std.atomic.Atomic(u32).init(0); var i: usize = 0; while (i < 100) : (i += 1) { try pool.spawn(struct { fn increment(c: *std.atomic.Atomic(u32)) void { _ = c.fetchAdd(1, .SeqCst); } }.increment, .{&counter}); } pool.waitAll(); try testing.expectEqual(@as(u32, 100), counter.load(.SeqCst)); } </code></pre></div>Parameterized Tests: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">test "hash_function: various inputs" { const test_cases = [_]struct { input: []const u8, expected: u64, }{ .{ .input = "hello", .expected = 0x12345678 }, .{ .input = "world", .expected = 0x87654321 }, .{ .input = "", .expected = 0 }, }; for (test_cases) |tc| { const result = hash_function(tc.input); try testing.expectEqual(tc.expected, result); } } </code></pre></div> <h3 id="geodetestlab-framework" class="position-relative d-flex align-items-center group"> geodetestlab Framework <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="geodetestlab-framework" aria-haspopup="dialog" aria-label="Share link: geodetestlab Framework"> Share link </button> </h3> <h4 id="overview-2" class="position-relative d-flex align-items-center group"> Overview <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="overview-2" aria-haspopup="dialog" aria-label="Share link: Overview"> Share link </button> </h4>geodetestlab is Geode’s primary integration testing framework. It uses YAML specification files to define test cases that execute against a running Geode server. Key Features: <ul> <li>YAML-based test specifications</li> <li>Variable substitution (server address, secrets, etc.)</li> <li>JSON output validation</li> <li>Regex pattern matching</li> <li>Exit code verification</li> <li>Comprehensive error reporting</li> </ul> <h4 id="test-specification-format" class="position-relative d-flex align-items-center group"> Test Specification Format <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-specification-format" aria-haspopup="dialog" aria-label="Share link: Test Specification Format"> Share link </button> </h4>Basic Structure: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">name: "test-suite-name" description: "Description of test suite" tests: - name: "test-case-name" description: "What this test validates" args: ["command", "subcommand", "--flag", "value"] expect: exit_code: 0 stdout_contains: ["expected output"] stderr_contains: [] stdout_regex: ["pattern.*to.*match"] stdout_json_assert: - path: "result.status" equals: "success" </code></pre></div>Complete Example: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">name: "basic-query-tests" description: "Basic query execution tests" tests: - name: "simple-return" description: "Execute simple RETURN query" args: ["query", "RETURN 1 AS x", "--server", "${server}"] expect: exit_code: 0 stdout_contains: ["x"] stdout_json_assert: - path: "result.columns[0].name" equals: "x" - path: "result.rows[0].x" equals: 1 - name: "query-with-where" description: "Query with WHERE clause" args: ["query", "MATCH (n:Person) WHERE n.age > 30 RETURN n.name", "--server", "${server}"] expect: exit_code: 0 stdout_regex: [".*Person.*"] - name: "invalid-syntax" description: "Invalid query should fail" args: ["query", "INVALID SYNTAX", "--server", "${server}"] expect: exit_code: 1 stderr_contains: ["syntax error", "parse error"] </code></pre></div> <h4 id="variable-substitution" class="position-relative d-flex align-items-center group"> Variable Substitution <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="variable-substitution" aria-haspopup="dialog" aria-label="Share link: Variable Substitution"> Share link </button> </h4>geodetestlab supports dynamic variable substitution: Built-in Variables: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">tests: - name: "server-connection" args: ["query", "RETURN 1", "--server", "${server}"] # ${server} → 127.0.0.1:3141 - name: "server-host-only" args: ["--host", "${server:host}"] # ${server:host} → 127.0.0.1 - name: "server-port-only" args: ["--port", "${server:port}"] # ${server:port} → 3141 - name: "authenticated-query" args: ["query", "RETURN 1", "--server", "${server}", "--token", "${secret:api_token}"] # ${secret:api_token} → generated test token - name: "user-password" args: ["user", "create", "--password", "${secret:user_password}"] # ${secret:user_password} → generated test password </code></pre></div>Custom Variables (via environment): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Set custom variables export GEODE_TEST_VAR_GRAPH_NAME="test_graph" # Use in test spec args: ["use", "graph", "${custom:GRAPH_NAME}"] </code></pre></div> <h4 id="json-assertions" class="position-relative d-flex align-items-center group"> JSON Assertions <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="json-assertions" aria-haspopup="dialog" aria-label="Share link: JSON Assertions"> Share link </button> </h4>Path-based Assertions: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">stdout_json_assert: # Exact equality - path: "result.status" equals: "success" # Type checking - path: "result.count" type: "integer" # Existence checking - path: "result.data" exists: true # Array length - path: "result.rows" length: 5 # Nested paths - path: "result.rows[0].user.name" equals: "Alice" # Contains substring - path: "result.message" contains: "completed successfully" # Regex match - path: "result.id" matches: "^[0-9a-f]{8}-[0-9a-f]{4}-" </code></pre></div>Complex Assertions: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">stdout_json_assert: # Validate schema - path: "result.columns" schema: type: array items: type: object required: [name, type] properties: name: {type: string} type: {type: string} # Multiple conditions (AND) - path: "result.count" all: - greater_than: 0 - less_than: 100 # Any condition (OR) - path: "result.status" any: - equals: "success" - equals: "completed" </code></pre></div> <h4 id="running-geodetestlab-tests" class="position-relative d-flex align-items-center group"> Running geodetestlab Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="running-geodetestlab-tests" aria-haspopup="dialog" aria-label="Share link: Running geodetestlab Tests"> Share link </button> </h4>Basic Usage: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run all tests python3 scripts/test/extended_test_runner.py # Run specific spec file python3 scripts/test/extended_test_runner.py --specs geodetestlab/specs/auth_tests.yml # Run multiple spec files python3 scripts/test/extended_test_runner.py --specs \ geodetestlab/specs/auth_tests.yml \ geodetestlab/specs/query_tests.yml # Verbose output python3 scripts/test/extended_test_runner.py --verbose # Generate JSON report python3 scripts/test/extended_test_runner.py --report test-results.json # Generate HTML report python3 scripts/test/extended_test_runner.py --html-report test-results.html # Run with specific server address python3 scripts/test/extended_test_runner.py --server 127.0.0.1:8443 # Stop on first failure python3 scripts/test/extended_test_runner.py --fail-fast </code></pre></div>Advanced Options: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run with timeout (seconds) python3 scripts/test/extended_test_runner.py --timeout 60 # Run specific test by name pattern python3 scripts/test/extended_test_runner.py --filter "auth.*login" # Exclude specific tests python3 scripts/test/extended_test_runner.py --exclude "slow_tests" # Parallel execution (4 workers) python3 scripts/test/extended_test_runner.py --parallel 4 # Retry failed tests python3 scripts/test/extended_test_runner.py --retry 3 </code></pre></div> <h4 id="test-organization-1" class="position-relative d-flex align-items-center group"> Test Organization <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-organization-1" aria-haspopup="dialog" aria-label="Share link: Test Organization"> Share link </button> </h4>Spec File Naming Convention: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text">geodetestlab/specs/ ├── auth_basic.yml # Basic authentication ├── auth_mfa.yml # Multi-factor authentication ├── query_basic.yml # Basic queries ├── query_aggregation.yml # Aggregation queries ├── crud_nodes.yml # Node CRUD operations ├── crud_relationships.yml # Relationship CRUD ├── txn_isolation.yml # Transaction isolation ├── backup_restore.yml # Backup/restore operations ├── distributed_*.yml # Distributed features ├── rapid_sequential_writes.yml # Bulk write regression (#479) └── geode_gql_compliance.yml # ISO GQL compliance </code></pre></div>Test Categories: <ol> <li>Authentication (<code>auth_*.yml</code>) - Login, MFA, tokens</li> <li>Authorization (<code>authz_*.yml</code>) - Permissions, RBAC, ABAC</li> <li>Query Execution (<code>query_*.yml</code>) - MATCH, RETURN, WHERE, etc.</li> <li>CRUD Operations (<code>crud_*.yml</code>) - CREATE, DELETE, UPDATE</li> <li>Transactions (<code>txn_*.yml</code>) - BEGIN, COMMIT, ROLLBACK</li> <li>Storage (<code>storage_*.yml</code>) - Persistence, indexes</li> <li>Backup (<code>backup_*.yml</code>) - Backup and restore</li> <li>Security (<code>security_*.yml</code>) - TDE, RLS, audit</li> <li>Distributed (<code>distributed_*.yml</code>) - Federation, sharding</li> <li>Compliance (<code>*_compliance.yml</code>) - Standards conformance</li> <li>Rapid Sequential Writes (<code>rapid_sequential_writes.yml</code>) - Bulk MERGE/CREATE, relationship chains, mixed operations, data integrity, and stress tests for the gRPC aarch64 partial write segfault fix (#479)</li> </ol> <h4 id="writing-new-tests" class="position-relative d-flex align-items-center group"> Writing New Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="writing-new-tests" aria-haspopup="dialog" aria-label="Share link: Writing New Tests"> Share link </button> </h4>Step 1: Create Spec File <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Create new spec file touch geodetestlab/specs/my_feature_tests.yml </code></pre></div>Step 2: Define Test Suite <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">name: "my-feature-tests" description: "Tests for my new feature" tests: - name: "feature-basic-usage" description: "Basic usage of the feature" args: ["my-command", "--option", "value"] expect: exit_code: 0 stdout_contains: ["success"] </code></pre></div>Step 3: Run Tests <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Test your new spec python3 scripts/test/extended_test_runner.py --specs geodetestlab/specs/my_feature_tests.yml --verbose </code></pre></div>Step 4: Validate Output <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check test results echo $? # Should be 0 for success # Review detailed output cat test-results.json </code></pre></div> <h4 id="debugging-failed-tests" class="position-relative d-flex align-items-center group"> Debugging Failed Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="debugging-failed-tests" aria-haspopup="dialog" aria-label="Share link: Debugging Failed Tests"> Share link </button> </h4>Enable Verbose Mode: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">python3 scripts/test/extended_test_runner.py --verbose --specs geodetestlab/specs/failing_test.yml </code></pre></div>Capture Server Output: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">export GEODE_CAPTURE_SERVER_STDERR=1 python3 scripts/test/extended_test_runner.py --specs geodetestlab/specs/failing_test.yml </code></pre></div>Run Single Test: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># Temporarily comment out other tests in spec file tests: # - name: "test1" ... # - name: "test2" ... - name: "failing-test" # ... only this test will run </code></pre></div>Manual Execution: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run the exact command from test spec manually ./zig-out/bin/geode query "MATCH (n) RETURN n" --server 127.0.0.1:3141 --verbose </code></pre></div> <h4 id="integration-with-cicd" class="position-relative d-flex align-items-center group"> Integration with CI/CD <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="integration-with-cicd" aria-haspopup="dialog" aria-label="Share link: Integration with CI/CD"> Share link </button> </h4>GitLab CI Configuration (<code>.gitlab-ci.yml</code>): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">test-geodetestlab: stage: test image: registry.gitlab.com/devnw/ci-catalog/zig:0.1.0 before_script: - apt-get update && apt-get install -y python3 python3-pip - pip3 install pyyaml - make build script: - python3 scripts/test/extended_test_runner.py --report test-results.json artifacts: reports: junit: test-results.xml paths: - test-results.json - test-results.html when: always expire_in: 30 days coverage: '/Total coverage: (\d+\.\d+)%/' </code></pre></div> <h3 id="regression-tests" class="position-relative d-flex align-items-center group"> Regression Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="regression-tests" aria-haspopup="dialog" aria-label="Share link: Regression Tests"> Share link </button> </h3> <h4 id="overview-3" class="position-relative d-flex align-items-center group"> Overview <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="overview-3" aria-haspopup="dialog" aria-label="Share link: Overview"> Share link </button> </h4>Regression tests are shell scripts that validate specific bug fixes and ensure they don’t reoccur. Each regression test focuses on a particular scenario. <h4 id="available-regression-suites" class="position-relative d-flex align-items-center group"> Available Regression Suites <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="available-regression-suites" aria-haspopup="dialog" aria-label="Share link: Available Regression Suites"> Share link </button> </h4>comprehensive_regression_test.sh (34 scenarios): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">./tests/comprehensive_regression_test.sh # Categories tested: # - Basic queries and filters # - Path patterns and relationships # - Aggregations and grouping # - Order by and pagination # - Property access and null handling # - Set operations (UNION, INTERSECT) # - Transaction management # - Error handling </code></pre></div>limit_skip_regression_test.sh (23 scenarios): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">./tests/limit_skip_regression_test.sh # Categories tested: # - LIMIT clause variations # - OFFSET/SKIP clause variations # - Combined LIMIT and OFFSET # - ORDER BY with pagination # - Edge cases (zero, negative, large values) </code></pre></div>property_ordering_regression_test.sh (10 scenarios): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">./tests/property_ordering_regression_test.sh # Categories tested: # - Property insertion order preservation # - JSON output property ordering # - Map literal property ordering # - UPDATE property ordering # - Multi-property consistency </code></pre></div>count_aggregation_regression_test.sh (8 scenarios): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">./tests/count_aggregation_regression_test.sh # Categories tested: # - COUNT(*) aggregation # - COUNT(DISTINCT) aggregation # - COUNT with GROUP BY # - COUNT with WHERE filtering # - COUNT with null values </code></pre></div> <h4 id="writing-regression-tests" class="position-relative d-flex align-items-center group"> Writing Regression Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="writing-regression-tests" aria-haspopup="dialog" aria-label="Share link: Writing Regression Tests"> Share link </button> </h4>Template: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">#!/bin/bash set -e # Test configuration TEST_NAME="my_regression_test" SERVER="127.0.0.1:3141" GEODE_BIN="./zig-out/bin/geode" # Setup echo "Setting up test environment..." $GEODE_BIN serve --listen $SERVER & SERVER_PID=$! sleep 2 # Cleanup on exit trap "kill $SERVER_PID 2>/dev/null || true" EXIT # Test case 1 echo "Test 1: Description of what we're testing" result=$($GEODE_BIN query "MATCH (n) RETURN n" --server $SERVER) if [[ "$result" != *"expected output"* ]]; then echo "FAIL: Test 1 failed" exit 1 fi echo "PASS: Test 1" # Test case 2 echo "Test 2: Another test case" result=$($GEODE_BIN query "CREATE (n:Test)" --server $SERVER) if [ $? -ne 0 ]; then echo "FAIL: Test 2 failed" exit 1 fi echo "PASS: Test 2" # Summary echo "=============================" echo "All regression tests passed!" echo "=============================" exit 0 </code></pre></div>Best Practices: <ol> <li>Self-contained - Each test starts and stops its own server</li> <li>Cleanup - Use <code>trap</code> to ensure cleanup on exit</li> <li>Clear output - Echo test names and results</li> <li>Exit codes - Return 0 for success, non-zero for failure</li> <li>Documentation - Comment what bug/issue the test validates</li> </ol> <h4 id="running-regression-tests" class="position-relative d-flex align-items-center group"> Running Regression Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="running-regression-tests" aria-haspopup="dialog" aria-label="Share link: Running Regression Tests"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run all regression suites ./tests/comprehensive_regression_test.sh ./tests/limit_skip_regression_test.sh ./tests/property_ordering_regression_test.sh ./tests/count_aggregation_regression_test.sh # Run specific test with verbose output bash -x ./tests/comprehensive_regression_test.sh # Check exit code ./tests/comprehensive_regression_test.sh echo $? # Should be 0 # Run in CI make regression-tests </code></pre></div> <h3 id="fuzz-testing" class="position-relative d-flex align-items-center group"> Fuzz Testing <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="fuzz-testing" aria-haspopup="dialog" aria-label="Share link: Fuzz Testing"> Share link </button> </h3> <h4 id="overview-4" class="position-relative d-flex align-items-center group"> Overview <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="overview-4" aria-haspopup="dialog" aria-label="Share link: Overview"> Share link </button> </h4>Fuzz testing uses randomized inputs to discover edge cases and potential crashes. Geode includes fuzz tests for critical components. <h4 id="fuzz-targets" class="position-relative d-flex align-items-center group"> Fuzz Targets <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="fuzz-targets" aria-haspopup="dialog" aria-label="Share link: Fuzz Targets"> Share link </button> </h4>Parser Fuzzing (<code>fuzz/parser_fuzz.zig</code>): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// Generates random GQL queries to test parser robustness pub fn fuzz_parser(input: []const u8) !void { const allocator = std.heap.page_allocator; var parser = Parser.init(allocator, input); _ = parser.parse() catch |err| { // Expected - invalid input should fail gracefully return; }; } </code></pre></div>Storage Fuzzing (<code>fuzz/storage_fuzz.zig</code>): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// Generates random storage operations pub fn fuzz_storage(input: []const u8) !void { // Random node/relationship creation // Random property updates // Random deletions // Verify consistency after each operation } </code></pre></div>Execution Fuzzing (<code>fuzz/execution_fuzz.zig</code>): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// Generates random query execution scenarios pub fn fuzz_execution(input: []const u8) !void { // Random MATCH patterns // Random WHERE conditions // Random aggregations // Verify results are valid } </code></pre></div> <h4 id="running-fuzz-tests" class="position-relative d-flex align-items-center group"> Running Fuzz Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="running-fuzz-tests" aria-haspopup="dialog" aria-label="Share link: Running Fuzz Tests"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run all fuzz tests make fuzz # Run specific fuzz target zig build fuzz-parser # Run with custom seed (reproducibility) zig build fuzz-parser -Dseed=12345 # Run with time limit (10 minutes) timeout 600 zig build fuzz-parser # Run with AFL (American Fuzzy Lop) afl-fuzz -i fuzz/inputs -o fuzz/outputs -- ./zig-out/bin/geode-fuzz-parser @@ </code></pre></div> <h4 id="fuzz-test-configuration" class="position-relative d-flex align-items-center group"> Fuzz Test Configuration <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="fuzz-test-configuration" aria-haspopup="dialog" aria-label="Share link: Fuzz Test Configuration"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// fuzz/config.zig pub const FuzzConfig = struct { /// Maximum input size in bytes max_input_size: usize = 4096, /// Iteration count iterations: u64 = 10_000, /// Seed for PRNG (0 = random) seed: u64 = 0, /// Timeout per iteration (ms) timeout_ms: u64 = 100, /// Crash on first error fail_fast: bool = false, }; </code></pre></div> <h4 id="analyzing-fuzz-crashes" class="position-relative d-flex align-items-center group"> Analyzing Fuzz Crashes <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="analyzing-fuzz-crashes" aria-haspopup="dialog" aria-label="Share link: Analyzing Fuzz Crashes"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Reproduce crash with specific input zig build fuzz-parser -Dinput=crash_input.txt # Debug crash zig build fuzz-parser -O Debug -Dinput=crash_input.txt gdb ./zig-out/bin/geode-fuzz-parser # Minimize crash input afl-tmin -i crash_input.txt -o minimized.txt -- ./zig-out/bin/geode-fuzz-parser @@ </code></pre></div> <h3 id="benchmark-tests" class="position-relative d-flex align-items-center group"> Benchmark Tests <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="benchmark-tests" aria-haspopup="dialog" aria-label="Share link: Benchmark Tests"> Share link </button> </h3> <h4 id="overview-5" class="position-relative d-flex align-items-center group"> Overview <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="overview-5" aria-haspopup="dialog" aria-label="Share link: Overview"> Share link </button> </h4>Benchmark tests measure performance and detect regressions. Geode includes 150+ benchmark variants. <h4 id="benchmark-categories" class="position-relative d-flex align-items-center group"> Benchmark Categories <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="benchmark-categories" aria-haspopup="dialog" aria-label="Share link: Benchmark Categories"> Share link </button> </h4>Query Benchmarks: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// benchmark/query_bench.zig pub fn benchmarkSimpleQuery() !void { const timer = try Timer.start(); var i: usize = 0; while (i < 1000) : (i += 1) { _ = try executeQuery("MATCH (n) RETURN n LIMIT 1"); } const elapsed = timer.read(); std.debug.print("Simple query: {} ns/op\n", .{elapsed / 1000}); } </code></pre></div>Storage Benchmarks: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">pub fn benchmarkNodeInsertion() !void { const timer = try Timer.start(); var i: usize = 0; while (i < 10000) : (i += 1) { _ = try storage.createNode(.{ .id = i, .labels = &[_][]const u8{"Person"}, .properties = &[_]Property{}, }); } const elapsed = timer.read(); std.debug.print("Node insertion: {} ns/op\n", .{elapsed / 10000}); } </code></pre></div>Index Benchmarks: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">pub fn benchmarkIndexLookup() !void { // Setup: Create index with 100k entries var index = try BTreeIndex.init(allocator); var i: usize = 0; while (i < 100_000) : (i += 1) { try index.insert(i, i); } const timer = try Timer.start(); // Benchmark: Lookup 10k random keys var prng = std.rand.DefaultPrng.init(12345); i = 0; while (i < 10_000) : (i += 1) { const key = prng.random().intRangeAtMost(usize, 0, 99_999); _ = try index.lookup(key); } const elapsed = timer.read(); std.debug.print("Index lookup: {} ns/op\n", .{elapsed / 10_000}); } </code></pre></div> <h4 id="running-benchmarks" class="position-relative d-flex align-items-center group"> Running Benchmarks <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="running-benchmarks" aria-haspopup="dialog" aria-label="Share link: Running Benchmarks"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run all benchmarks make bench # Run specific benchmark zig build bench-query # Run with different optimization levels zig build bench-query -O ReleaseFast zig build bench-query -O ReleaseSafe # Output to JSON zig build bench-query --output benchmark-results.json # Compare with baseline ./scripts/benchmark_compare.sh baseline.json current.json </code></pre></div> <h4 id="benchmark-output-format" class="position-relative d-flex align-items-center group"> Benchmark Output Format <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="benchmark-output-format" aria-haspopup="dialog" aria-label="Share link: Benchmark Output Format"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json">{ "benchmarks": [ { "name": "simple_query", "iterations": 1000, "total_ns": 1250000, "ns_per_op": 1250, "ops_per_sec": 800000 }, { "name": "node_insertion", "iterations": 10000, "total_ns": 50000000, "ns_per_op": 5000, "ops_per_sec": 200000 } ], "environment": { "os": "linux", "arch": "x86_64", "cpu": "Intel Core i7-9700K", "zig_version": "0.1.0" } } </code></pre></div> <h4 id="performance-regression-detection" class="position-relative d-flex align-items-center group"> Performance Regression Detection <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="performance-regression-detection" aria-haspopup="dialog" aria-label="Share link: Performance Regression Detection"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Generate baseline make bench > baseline-results.json # After changes, compare make bench > current-results.json ./scripts/detect_regressions.sh baseline-results.json current-results.json # Example output: # ✓ simple_query: 1250 ns/op (no change) # ✗ node_insertion: 8000 ns/op (+60% regression) # ✓ index_lookup: 450 ns/op (-10% improvement) </code></pre></div> <h3 id="test-coverage-analysis" class="position-relative d-flex align-items-center group"> Test Coverage Analysis <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-coverage-analysis" aria-haspopup="dialog" aria-label="Share link: Test Coverage Analysis"> Share link </button> </h3> <h4 id="measuring-coverage" class="position-relative d-flex align-items-center group"> Measuring Coverage <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="measuring-coverage" aria-haspopup="dialog" aria-label="Share link: Measuring Coverage"> Share link </button> </h4>Zig Unit Test Coverage: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Generate coverage data zig test src/storage/heap.zig --test-coverage # View coverage report (requires kcov or similar) kcov coverage-output ./zig-test firefox coverage-output/index.html </code></pre></div>Integration Test Coverage: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run tests with coverage tracking python3 scripts/test/extended_test_runner.py --coverage # Generate coverage report python3 scripts/test/generate_coverage_report.py # Output: # Total tests: 3540 # Passed: 3395 (95.9%) # Failed: 110 (3.1%) # Skipped: 35 (1.0%) # # Coverage by feature: # - Authentication: 100% (285/285) # - Query execution: 97.3% (888/912) # - Storage: 97.2% (239/246) </code></pre></div> <h4 id="coverage-reports" class="position-relative d-flex align-items-center group"> Coverage Reports <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="coverage-reports" aria-haspopup="dialog" aria-label="Share link: Coverage Reports"> Share link </button> </h4>HTML Report: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Generate HTML coverage report make coverage-html # Open in browser firefox coverage/index.html </code></pre></div>Coverage Badges: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown">![Test Coverage](https://img.shields.io/badge/coverage-95.9%25-brightgreen) ![Unit Tests](https://img.shields.io/badge/unit%20tests-100%25-brightgreen) ![GQL Compliance](https://img.shields.io/badge/GQL%20compliance-100%25-blue) </code></pre></div> <h4 id="coverage-thresholds" class="position-relative d-flex align-items-center group"> Coverage Thresholds <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="coverage-thresholds" aria-haspopup="dialog" aria-label="Share link: Coverage Thresholds"> Share link </button> </h4>CI/CD Enforcement: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># .gitlab-ci.yml test-coverage: script: - make test-coverage - python3 scripts/check_coverage_threshold.py --min-coverage 95.0 coverage: '/Total coverage: (\d+\.\d+)%/' </code></pre></div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># scripts/check_coverage_threshold.py import sys import json def check_coverage(min_threshold): with open('coverage-results.json') as f: data = json.load(f) coverage = data['pass_rate'] print(f"Coverage: {coverage}%") if coverage < min_threshold: print(f"FAIL: Coverage {coverage}% below threshold {min_threshold}%") sys.exit(1) print(f"PASS: Coverage meets threshold") sys.exit(0) if __name__ == '__main__': check_coverage(95.0) </code></pre></div> <h3 id="cicd-integration" class="position-relative d-flex align-items-center group"> CI/CD Integration <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="cicd-integration" aria-haspopup="dialog" aria-label="Share link: CI/CD Integration"> Share link </button> </h3> <h4 id="gitlab-ci-pipeline" class="position-relative d-flex align-items-center group"> GitLab CI Pipeline <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="gitlab-ci-pipeline" aria-haspopup="dialog" aria-label="Share link: GitLab CI Pipeline"> Share link </button> </h4>Complete Pipeline (<code>.gitlab-ci.yml</code>): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">stages: - build - test - governance - deploy variables: ZIG_VERSION: "0.1.0" GEODE_LOG_LEVEL: "info" # Build stage build: stage: build image: registry.gitlab.com/devnw/ci-catalog/zig:${ZIG_VERSION} script: - make build - ./zig-out/bin/geode --version artifacts: paths: - zig-out/bin/geode expire_in: 1 day # Unit tests test-unit: stage: test image: registry.gitlab.com/devnw/ci-catalog/zig:${ZIG_VERSION} script: - make test coverage: '/(\d+)\/(\d+) tests passed/' # Integration tests test-integration: stage: test needs: [build] image: registry.gitlab.com/devnw/ci-catalog/zig:${ZIG_VERSION} before_script: - apt-get update && apt-get install -y python3 python3-pip - pip3 install pyyaml script: - python3 scripts/test/extended_test_runner.py --report test-results.json artifacts: reports: junit: test-results.xml paths: - test-results.json - test-results.html when: always expire_in: 7 days coverage: '/Pass rate: (\d+\.\d+)%/' # Regression tests test-regression: stage: test needs: [build] script: - ./tests/comprehensive_regression_test.sh - ./tests/limit_skip_regression_test.sh - ./tests/property_ordering_regression_test.sh - ./tests/count_aggregation_regression_test.sh # GQL compliance tests test-gql-compliance: stage: test needs: [build] script: - python3 scripts/test/extended_test_runner.py --specs geodetestlab/specs/geode_gql_compliance.yml allow_failure: false # Must pass # Fuzz tests (scheduled) test-fuzz: stage: test only: - schedules script: - timeout 600 make fuzz allow_failure: true # Benchmark tests test-benchmark: stage: test needs: [build] script: - make bench > benchmark-results.json artifacts: paths: - benchmark-results.json expire_in: 30 days # Governance status check governance-status: stage: governance script: - python3 tools/status_generate.py --repo . --out /tmp/status_check.csv - diff docs/status.csv /tmp/status_check.csv allow_failure: false # Deploy (production) deploy-production: stage: deploy only: - main when: manual environment: name: production url: https://geode.example.com script: - echo "Deploying to production..." - ./scripts/deploy.sh production </code></pre></div> <h4 id="github-actions-alternative" class="position-relative d-flex align-items-center group"> GitHub Actions (Alternative) <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="github-actions-alternative" aria-haspopup="dialog" aria-label="Share link: GitHub Actions (Alternative)"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># .github/workflows/test.yml name: Test Suite on: push: branches: [main, develop] pull_request: branches: [main] jobs: unit-tests: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - uses: goto-bus-stop/setup-zig@v2 with: version: 0.1.0 - name: Run unit tests run: make test integration-tests: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - uses: goto-bus-stop/setup-zig@v2 with: version: 0.1.0 - uses: actions/setup-python@v4 with: python-version: '3.9' - name: Install dependencies run: pip install pyyaml - name: Build Geode run: make build - name: Run integration tests run: python3 scripts/test/extended_test_runner.py --report test-results.json - name: Upload test results uses: actions/upload-artifact@v3 with: name: test-results path: test-results.* gql-compliance: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - uses: goto-bus-stop/setup-zig@v2 - name: Build Geode run: make build - name: Run GQL compliance tests run: python3 scripts/test/extended_test_runner.py --specs geodetestlab/specs/geode_gql_compliance.yml </code></pre></div> <h4 id="test-artifacts" class="position-relative d-flex align-items-center group"> Test Artifacts <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-artifacts" aria-haspopup="dialog" aria-label="Share link: Test Artifacts"> Share link </button> </h4>Collecting Test Results: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">artifacts: reports: junit: test-results.xml paths: - test-results.json - test-results.html - coverage-results/ - benchmark-results.json when: always expire_in: 7 days </code></pre></div>Test Report Format (JUnit XML): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-xml" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?> <testsuites name="Geode Tests" tests="3540" failures="110" errors="0" time="245.67"> <testsuite name="auth_basic" tests="145" failures="0" errors="0" time="12.45"> <testcase name="login_success" time="0.12"/> <testcase name="login_invalid_password" time="0.09"/>  </testsuite> <testsuite name="query_execution" tests="456" failures="4" errors="0" time="67.89"> <testcase name="simple_match" time="0.15"/> <testcase name="complex_where_clause" time="0.23"> <failure message="Expected 5 results, got 4"> Expected: 5 Actual: 4 </failure> </testcase>  </testsuite> </testsuites> </code></pre></div> <h3 id="test-data-management" class="position-relative d-flex align-items-center group"> Test Data Management <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-data-management" aria-haspopup="dialog" aria-label="Share link: Test Data Management"> Share link </button> </h3> <h4 id="test-datasets" class="position-relative d-flex align-items-center group"> Test Datasets <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-datasets" aria-haspopup="dialog" aria-label="Share link: Test Datasets"> Share link </button> </h4>Loading Test Data: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Load example datasets make load-dataset # Available datasets: # - Social Network: 10,000+ users, posts, groups, events # - IoT Network: 25,000+ devices, sensors, telemetry # - Financial Network: 50,000 accounts, 250,000 transactions # - Geographic Data: 100 cities, 25,000 POIs # Load specific dataset ./scripts/load_dataset.sh social_network ./scripts/load_dataset.sh iot_network # Run dataset integration tests make dataset-integration-test </code></pre></div>Test Data Fixtures: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># geodetestlab/fixtures/test_users.yml users: - id: 1 name: "Alice" email: "[email protected]" age: 30 - id: 2 name: "Bob" email: "[email protected]" age: 35 relationships: - type: "KNOWS" from: 1 to: 2 since: "2020-01-15" </code></pre></div>Loading Fixtures in Tests: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">tests: - name: "query-with-fixtures" setup: - load_fixture: "test_users.yml" args: ["query", "MATCH (u:User) WHERE u.age > 30 RETURN u.name"] expect: stdout_contains: ["Bob"] teardown: - cleanup_fixture: "test_users.yml" </code></pre></div> <h4 id="test-isolation" class="position-relative d-flex align-items-center group"> Test Isolation <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-isolation" aria-haspopup="dialog" aria-label="Share link: Test Isolation"> Share link </button> </h4>Database Cleanup: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Reset database between test runs geode admin reset-database --confirm # Truncate specific graph geode admin truncate-graph --graph test_graph # Delete test data geode query "MATCH (n:TestNode) DETACH DELETE n" </code></pre></div>Transaction Rollback: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">tests: - name: "isolated-test" setup: - begin args: ["query", "CREATE (n:TestNode {id: 1})"] expect: exit_code: 0 teardown: - rollback </code></pre></div> <h3 id="troubleshooting" class="position-relative d-flex align-items-center group"> Troubleshooting <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="troubleshooting" aria-haspopup="dialog" aria-label="Share link: Troubleshooting"> Share link </button> </h3> <h4 id="common-test-issues" class="position-relative d-flex align-items-center group"> Common Test Issues <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="common-test-issues" aria-haspopup="dialog" aria-label="Share link: Common Test Issues"> Share link </button> </h4>Test Server Won’t Start: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check if port is in use lsof -i :3141 # Kill existing server pkill -f "geode serve" # Start server manually to debug ./zig-out/bin/geode serve --listen 127.0.0.1:3141 --log-level debug </code></pre></div>Tests Timing Out: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Increase timeout export GEODE_TEST_TIMEOUT=60 # Run with longer timeout python3 scripts/test/extended_test_runner.py --timeout 120 </code></pre></div>Inconsistent Test Results: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check for race conditions # Run tests multiple times for i in {1..10}; do python3 scripts/test/extended_test_runner.py --specs geodetestlab/specs/flaky_test.yml done # Use fixed seed for reproducibility export GEODE_TEST_SEED=12345 </code></pre></div>Memory Leaks in Tests: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run with leak detection valgrind --leak-check=full ./zig-out/bin/geode-test # Or use Zig's testing allocator (automatically detects leaks) zig test src/storage/heap.zig </code></pre></div>Failed JSON Assertions: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Enable verbose mode to see actual JSON python3 scripts/test/extended_test_runner.py --verbose # Manually inspect output ./zig-out/bin/geode query "..." --json | jq . </code></pre></div> <h4 id="debugging-strategies" class="position-relative d-flex align-items-center group"> Debugging Strategies <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="debugging-strategies" aria-haspopup="dialog" aria-label="Share link: Debugging Strategies"> Share link </button> </h4>Isolate Failing Test: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># Comment out other tests in spec file tests: # - name: "test1" ... # - name: "test2" ... - name: "failing-test" args: ["query", "..."] </code></pre></div>Add Debug Output: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">tests: - name: "debug-test" args: ["query", "MATCH (n) RETURN n", "--verbose", "--log-level", "debug"] </code></pre></div>Manual Reproduction: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Start server ./zig-out/bin/geode serve --listen 127.0.0.1:3141 --log-level debug # In another terminal, run exact command ./zig-out/bin/geode query "MATCH (n) RETURN n" --server 127.0.0.1:3141 --verbose </code></pre></div>Use Interactive REPL: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Start REPL for interactive testing ./zig-out/bin/geode shell # Execute queries interactively geode> MATCH (n:Person) RETURN n; geode> .explain MATCH (n:Person) WHERE n.age > 30 RETURN n; </code></pre></div> <h4 id="test-infrastructure-issues" class="position-relative d-flex align-items-center group"> Test Infrastructure Issues <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-infrastructure-issues" aria-haspopup="dialog" aria-label="Share link: Test Infrastructure Issues"> Share link </button> </h4>geodetestlab Import Errors: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Install missing dependencies pip3 install pyyaml # Verify Python version python3 --version # Should be 3.9+ </code></pre></div>Test Runner Crashes: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Enable debug mode export GEODE_DEBUG=1 python3 scripts/test/extended_test_runner.py --verbose # Check logs tail -f /tmp/geode-test-runner.log </code></pre></div>Server Not Responding: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check server status ps aux | grep geode # Check server logs tail -f /tmp/geode-server.log # Restart server pkill -f "geode serve" ./zig-out/bin/geode serve --listen 127.0.0.1:3141 & </code></pre></div> <h3 id="best-practices" class="position-relative d-flex align-items-center group"> Best Practices <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="best-practices" aria-haspopup="dialog" aria-label="Share link: Best Practices"> Share link </button> </h3> <h4 id="test-writing-guidelines" class="position-relative d-flex align-items-center group"> Test Writing Guidelines <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-writing-guidelines" aria-haspopup="dialog" aria-label="Share link: Test Writing Guidelines"> Share link </button> </h4><ol> <li>Descriptive Names - Use clear, specific test names that describe what is being tested</li> <li>Single Responsibility - Each test should verify one specific behavior</li> <li>Independent Tests - Tests should not depend on execution order or shared state</li> <li>Fast Tests - Keep unit tests fast (< 100ms), integration tests reasonable (< 5s)</li> <li>Clear Assertions - Use specific assertions that clearly show what went wrong</li> <li>Cleanup - Always clean up resources (use <code>defer</code> in Zig, <code>teardown</code> in geodetestlab)</li> <li>Documentation - Add comments explaining complex test logic or non-obvious behavior</li> </ol> <h4 id="test-organization-2" class="position-relative d-flex align-items-center group"> Test Organization <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-organization-2" aria-haspopup="dialog" aria-label="Share link: Test Organization"> Share link </button> </h4><ol> <li>Group Related Tests - Organize tests by feature or component</li> <li>Use Fixtures - Share test data through fixtures, not duplicated setup code</li> <li>Parameterized Tests - Use data-driven testing for multiple similar scenarios</li> <li>Hierarchical Specs - Structure geodetestlab specs by feature category</li> <li>Naming Conventions - Follow consistent naming: <code>component_feature_scenario</code></li> </ol> <h4 id="continuous-improvement" class="position-relative d-flex align-items-center group"> Continuous Improvement <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="continuous-improvement" aria-haspopup="dialog" aria-label="Share link: Continuous Improvement"> Share link </button> </h4><ol> <li>Monitor Flaky Tests - Track and fix tests with inconsistent results</li> <li>Review Coverage - Regularly review coverage reports and add tests for gaps</li> <li>Update Tests - Keep tests current with code changes</li> <li>Refactor Tests - Apply same code quality standards to test code</li> <li>Document Known Issues - Maintain list of known test limitations in KNOWN_TEST_ISSUES.md</li> </ol> <h3 id="next-steps" class="position-relative d-flex align-items-center group"> Next Steps <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="next-steps" aria-haspopup="dialog" aria-label="Share link: Next Steps"> Share link </button> </h3>After mastering Geode testing: <ol> <li>Write New Tests - Add tests for new features or uncovered code paths</li> <li>Optimize Performance - Use benchmark tests to validate optimizations</li> <li>Contribute Tests - Submit test improvements via pull requests</li> <li>Review Test Results - Monitor CI/CD test results and fix failures</li> <li>Improve Coverage - Work toward higher test coverage in untested areas</li> </ol> Related Documentation: <ul> <li><a href="/docs/contribute/" >Development Workflow</a> - Contributing guidelines</li> <li><a href="/docs/development/testing-guide/#ci-cd-integration" >CI/CD Pipeline</a> - Continuous integration setup</li> <li><a href="/docs/tutorials/index-optimization" >Performance Testing</a> - Query optimization testing</li> <li><a href="/docs/deployment/deployment-patterns" >Deployment Testing</a> - Production validation</li> <li><a href="/docs/client-libraries/client-comparison" >Client Testing</a> - Client library testing</li> </ul> <hr> Last Updated: February 2026 Test Coverage: 95.9% (3395/3540 extended suite tests passing) GQL Conformance Profile: ISO/IEC 39075:2024 compliance (see conformance profile) Status: Production Ready