Unit Testing

<h2 id="unit-testing-in-geode" class="position-relative d-flex align-items-center group"> Unit Testing in Geode <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="unit-testing-in-geode" aria-haspopup="dialog" aria-label="Share link: Unit Testing in Geode"> 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>Unit testing is fundamental to Geode’s development methodology, ensuring code correctness, preventing regressions, and enabling confident refactoring. Geode maintains 97.4% test coverage with 1,644 passing tests out of 1,688 total tests. <h3 id="geodes-testing-philosophy" class="position-relative d-flex align-items-center group"> Geode&rsquo;s Testing Philosophy <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="geodes-testing-philosophy" aria-haspopup="dialog" aria-label="Share link: Geodes Testing Philosophy"> Share link </button> </h3>Geode follows evidence-based development with CANARY markers tracking all implementations. The testing strategy emphasizes: No Mocks for Database Logic: Tests run against real Geode server instances, not mocks. This ensures tests validate actual behavior rather than simulated responses. Comprehensive Coverage: Every feature implementation must include corresponding tests. The GeodeTestLab suite provides comprehensive validation. Fast Feedback: Unit tests complete in 2-3 minutes, providing rapid developer feedback. ISO Conformance: 100% compliance for ISO/IEC 39075:2024 (see conformance profile). <h3 id="unit-test-structure-in-geode" class="position-relative d-flex align-items-center group"> Unit Test Structure in Geode <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="unit-test-structure-in-geode" aria-haspopup="dialog" aria-label="Share link: Unit Test Structure in Geode"> Share link </button> </h3> <h4 id="server-tests-zig" class="position-relative d-flex align-items-center group"> Server Tests (Zig) <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="server-tests-zig" aria-haspopup="dialog" aria-label="Share link: Server Tests (Zig)"> Share link </button> </h4>Geode’s server is implemented in Zig with built-in test framework: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// geode/src/parser/lexer_test.zig const std = @import("std"); const testing = std.testing; const Lexer = @import("lexer.zig").Lexer; test "lexer tokenizes simple GQL query" { const allocator = testing.allocator; const input = "MATCH (n:User) RETURN n"; var lexer = try Lexer.init(allocator, input); defer lexer.deinit(); const tokens = try lexer.tokenize(); defer allocator.free(tokens); try testing.expectEqual(@as(usize, 7), tokens.len); try testing.expectEqual(Token.Type.MATCH, tokens[0].type); try testing.expectEqual(Token.Type.LPAREN, tokens[1].type); try testing.expectEqualStrings("n", tokens[2].value); } test "lexer handles Unicode identifiers" { const allocator = testing.allocator; const input = "MATCH (user:用户) RETURN user.名前"; var lexer = try Lexer.init(allocator, input); defer lexer.deinit(); const tokens = try lexer.tokenize(); defer allocator.free(tokens); // Verify Unicode support try testing.expectEqualStrings("用户", tokens[3].value); try testing.expectEqualStrings("名前", tokens[8].value); } test "lexer error handling - unterminated string" { const allocator = testing.allocator; const input = "MATCH (n) WHERE n.name = 'unterminated"; var lexer = try Lexer.init(allocator, input); defer lexer.deinit(); const result = lexer.tokenize(); try testing.expectError(error.UnterminatedString, result); } </code></pre></div>Run Tests: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">cd geode # Run all tests zig build test # Run specific test file zig build test -Dtest-filter="lexer_test" # Run with coverage zig build test -Dcoverage=true </code></pre></div> <h4 id="query-planner-tests" class="position-relative d-flex align-items-center group"> Query Planner 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="query-planner-tests" aria-haspopup="dialog" aria-label="Share link: Query Planner Tests"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// geode/src/planner/query_planner_test.zig const QueryPlanner = @import("query_planner.zig").QueryPlanner; test "planner chooses index for equality filter" { const allocator = testing.allocator; var db = try TestDatabase.init(allocator); defer db.deinit(); // Create index try db.exec("CREATE INDEX user_email ON User(email)"); // Parse query const query = "MATCH (u:User {email: $email}) RETURN u"; var planner = try QueryPlanner.init(allocator, &db); defer planner.deinit(); const plan = try planner.plan(query); defer plan.deinit(); // Verify planner chose index seek try testing.expect(plan.operations[0].type == .IndexSeek); try testing.expectEqualStrings("user_email", plan.operations[0].index_name); } test "planner avoids cartesian product" { const allocator = testing.allocator; var db = try TestDatabase.init(allocator); defer db.deinit(); // Query that could create cartesian product const query = "MATCH (a:User), (b:Product) WHERE a.pref = b.cat RETURN a, b"; var planner = try QueryPlanner.init(allocator, &db); defer planner.deinit(); const plan = try planner.plan(query); defer plan.deinit(); // Verify planner adds relationship or index to avoid cartesian product try testing.expect(!plan.hasCartesianProduct()); } </code></pre></div> <h4 id="transaction-tests" class="position-relative d-flex align-items-center group"> Transaction 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="transaction-tests" aria-haspopup="dialog" aria-label="Share link: Transaction Tests"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// geode/src/storage/transaction_test.zig test "transaction ACID properties" { const allocator = testing.allocator; var db = try TestDatabase.init(allocator); defer db.deinit(); // Test Atomicity { var tx = try db.beginTransaction(); errdefer tx.rollback(); try tx.exec("CREATE (u:User {name: 'Alice'})"); try tx.exec("CREATE (u:User {name: 'Bob'})"); // Simulate error const result = tx.exec("INVALID QUERY"); try testing.expectError(error.ParseError, result); // Rollback try tx.rollback(); // Verify no data written const count = try db.exec("MATCH (u:User) RETURN count(u)"); try testing.expectEqual(@as(i64, 0), count); } // Test Isolation { var tx1 = try db.beginTransaction(); defer tx1.rollback(); var tx2 = try db.beginTransaction(); defer tx2.rollback(); // TX1 writes try tx1.exec("CREATE (u:User {name: 'Charlie'})"); // TX2 should not see TX1's changes const count = try tx2.exec("MATCH (u:User) RETURN count(u)"); try testing.expectEqual(@as(i64, 0), count); } } </code></pre></div> <h4 id="client-library-tests" class="position-relative d-flex align-items-center group"> Client Library 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="client-library-tests" aria-haspopup="dialog" aria-label="Share link: Client Library Tests"> Share link </button> </h4>Go Client Tests: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">// geode-client-go/client_test.go package geode import ( "context" "database/sql" "testing" ) func TestBasicQuery(t *testing.T) { db, err := sql.Open("geode", "quic://localhost:3141") if err != nil { t.Fatal(err) } defer db.Close() // Execute query rows, err := db.Query("MATCH (n) RETURN count(n) AS cnt") if err != nil { t.Fatal(err) } defer rows.Close() var count int64 if rows.Next() { if err := rows.Scan(&count); err != nil { t.Fatal(err) } } if count < 0 { t.Errorf("Expected non-negative count, got %d", count) } } func TestPreparedStatement(t *testing.T) { db, err := sql.Open("geode", "quic://localhost:3141") if err != nil { t.Fatal(err) } defer db.Close() // Prepare statement stmt, err := db.Prepare("MATCH (u:User {email: $1}) RETURN u.name") if err != nil { t.Fatal(err) } defer stmt.Close() // Execute with parameter var name string err = stmt.QueryRow("[email protected]").Scan(&name) if err != nil && err != sql.ErrNoRows { t.Fatal(err) } } func TestTransaction(t *testing.T) { db, err := sql.Open("geode", "quic://localhost:3141") if err != nil { t.Fatal(err) } defer db.Close() tx, err := db.Begin() if err != nil { t.Fatal(err) } // Execute in transaction _, err = tx.Exec("CREATE (u:User {name: 'Test User'})") if err != nil { tx.Rollback() t.Fatal(err) } // Commit if err := tx.Commit(); err != nil { t.Fatal(err) } // Verify data persisted var count int err = db.QueryRow("MATCH (u:User {name: 'Test User'}) RETURN count(u)").Scan(&count) if err != nil { t.Fatal(err) } if count != 1 { t.Errorf("Expected 1 user, got %d", count) } } </code></pre></div>Python Client Tests: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># geode-client-python/tests/test_client.py import pytest from geode_client import Client @pytest.mark.asyncio async def test_basic_query(): client = Client(host="localhost", port=3141) async with client.connection() as conn: result, _ = await conn.query("MATCH (n) RETURN count(n) AS cnt") assert len(result.bindings) == 1 assert result.bindings[0]['cnt'] >= 0 @pytest.mark.asyncio async def test_parameterized_query(): client = Client(host="localhost", port=3141) async with client.connection() as conn: result, _ = await conn.query( "MATCH (u:User {email: $email}) RETURN u.name", {"email": "[email protected]"} ) # Should not raise exception @pytest.mark.asyncio async def test_transaction(): client = Client(host="localhost", port=3141) async with client.connection() as conn: async with client.connection() as tx: await tx.begin() await tx.execute("CREATE (u:User {name: 'Test'})") await tx.execute("CREATE (u:User {name: 'Test2'})") # Auto-commits on exit # Verify committed result, _ = await conn.query( "MATCH (u:User) WHERE u.name STARTS WITH 'Test' RETURN count(u)" ) assert result.bindings[0]['count(u)'] == 2 @pytest.mark.asyncio async def test_transaction_rollback(): client = Client(host="localhost", port=3141) async with client.connection() as conn: try: async with client.connection() as tx: await tx.begin() await tx.execute("CREATE (u:User {name: 'Rollback Test'})") raise Exception("Simulated error") except: pass # Verify rolled back result, _ = await conn.query( "MATCH (u:User {name: 'Rollback Test'}) RETURN count(u)" ) assert result.bindings[0]['count(u)'] == 0 </code></pre></div> <h3 id="test-coverage" class="position-relative d-flex align-items-center group"> Test 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="test-coverage" aria-haspopup="dialog" aria-label="Share link: Test Coverage"> Share link </button> </h3>Geode tracks test coverage meticulously: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Generate coverage report cd geode zig build test -Dcoverage=true # View coverage zig build coverage-report # Geode Coverage Stats: # - Overall: 97.4% (1644/1688 tests passing) # - Core modules: 95%+ # - Security code: 100% # - GQL parser: 95%+ </code></pre></div>Coverage Requirements: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># scripts/check-coverage.py def check_coverage_requirements(coverage_data): requirements = { 'overall': 90.0, 'core': 95.0, 'security': 100.0, 'parser': 95.0, } for module, threshold in requirements.items(): actual = coverage_data.get_module_coverage(module) if actual < threshold: print(f"FAILED: {module} coverage {actual}% < {threshold}%") return False return True </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="1-test-naming-convention" class="position-relative d-flex align-items-center group"> 1. Test Naming Convention <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="1-test-naming-convention" aria-haspopup="dialog" aria-label="Share link: 1. Test Naming Convention"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// Use descriptive test names test "parser correctly handles nested parentheses" { } test "transaction isolation prevents dirty reads" { } test "index seek optimization for equality filters" { } </code></pre></div> <h4 id="2-arrange-act-assert-pattern" class="position-relative d-flex align-items-center group"> 2. Arrange-Act-Assert Pattern <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="2-arrange-act-assert-pattern" aria-haspopup="dialog" aria-label="Share link: 2. Arrange-Act-Assert Pattern"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">test "user creation with valid data" { // Arrange const allocator = testing.allocator; var db = try TestDatabase.init(allocator); defer db.deinit(); // Act const result = try db.exec( "CREATE (u:User {name: 'Alice', email: '[email protected]'}) RETURN u" ); // Assert try testing.expectEqual(@as(usize, 1), result.len); try testing.expectEqualStrings("Alice", result[0].get("name")); } </code></pre></div> <h4 id="3-test-data-management" class="position-relative d-flex align-items-center group"> 3. 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="3-test-data-management" aria-haspopup="dialog" aria-label="Share link: 3. Test Data Management"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">const TestDatabase = struct { db: *Database, allocator: std.mem.Allocator, pub fn init(allocator: std.mem.Allocator) !TestDatabase { // Create temporary database var db = try Database.initTemp(allocator); return TestDatabase{ .db = db, .allocator = allocator }; } pub fn deinit(self: *TestDatabase) void { self.db.deinit(); } }; </code></pre></div> <h4 id="4-parallel-test-execution" class="position-relative d-flex align-items-center group"> 4. Parallel Test Execution <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="4-parallel-test-execution" aria-haspopup="dialog" aria-label="Share link: 4. Parallel Test Execution"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run tests in parallel (8 shards) zig build test -Dparallel=8 # Results: 8-minute suite runs in 1-2 minutes </code></pre></div> <h3 id="advanced-testing-techniques" class="position-relative d-flex align-items-center group"> Advanced Testing Techniques <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="advanced-testing-techniques" aria-haspopup="dialog" aria-label="Share link: Advanced Testing Techniques"> Share link </button> </h3> <h4 id="property-based-testing" class="position-relative d-flex align-items-center group"> Property-Based 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="property-based-testing" aria-haspopup="dialog" aria-label="Share link: Property-Based Testing"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// Property-based testing for parser const testing = std.testing; const fuzzing = @import("fuzzing"); test "parser handles all valid GQL syntax" { const allocator = testing.allocator; // Generate random valid GQL queries var generator = fuzzing.GqlGenerator.init(allocator); defer generator.deinit(); var i: usize = 0; while (i < 1000) : (i += 1) { const query = try generator.generate_valid_query(); defer allocator.free(query); var parser = try Parser.init(allocator, query); defer parser.deinit(); // Should not crash or error on valid input const ast = parser.parse() catch |err| { std.debug.print("Failed on query: {s}\n", .{query}); return err; }; defer ast.deinit(); } } test "lexer rejects all invalid input" { const allocator = testing.allocator; const invalid_inputs = [_][]const u8{ "MATCH (u:User {unterminated string", "MATCH () ) ((", "RETURN 12.34.56", // Invalid number "MATCH $$$$$", // Invalid parameter }; for (invalid_inputs) |input| { var lexer = try Lexer.init(allocator, input); defer lexer.deinit(); const result = lexer.tokenize(); try testing.expectError(error.ParseError, result); } } </code></pre></div> <h4 id="parameterized-tests" class="position-relative d-flex align-items-center group"> Parameterized 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="parameterized-tests" aria-haspopup="dialog" aria-label="Share link: Parameterized Tests"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># geode-client-python/tests/test_parameterized.py import pytest @pytest.mark.parametrize("value,expected_type", [ (42, "integer"), (3.14, "float"), ("hello", "string"), (True, "boolean"), (None, "null"), ([1, 2, 3], "list"), ({"key": "value"}, "map"), ]) async def test_data_type_handling(client, value, expected_type): """Test all data types are handled correctly""" result, _ = await client.query( "CREATE (n:Test {value: $value}) RETURN n.value, type(n.value)", {"value": value} ) assert result.bindings[0]['type(n.value)'] == expected_type @pytest.mark.parametrize("query,should_error", [ ("MATCH (n) RETURN n", False), ("INVALID SYNTAX", True), ("MATCH (n WHERE n.id = 1", True), # Missing parenthesis ("RETURN 1 + 'string'", True), # Type mismatch ]) async def test_query_validation(client, query, should_error): """Test query validation""" if should_error: with pytest.raises(Exception): await client.execute(query) else: result, _ = await client.query(query) assert result is not None </code></pre></div> <h4 id="performance-tests" class="position-relative d-flex align-items-center group"> Performance 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="performance-tests" aria-haspopup="dialog" aria-label="Share link: Performance Tests"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-zig" data-lang="zig">// Benchmark tests const std = @import("std"); const testing = std.testing; test "query execution performance benchmark" { const allocator = testing.allocator; var db = try TestDatabase.init(allocator); defer db.deinit(); // Create test data var i: usize = 0; while (i < 10000) : (i += 1) { try db.exec("CREATE (u:User {id: $id, name: 'User $id'})", .{.id = i}); } // Benchmark query const iterations = 1000; const start = std.time.nanoTimestamp(); var j: usize = 0; while (j < iterations) : (j += 1) { const result = try db.exec("MATCH (u:User {id: 5000}) RETURN u"); result.deinit(); } const end = std.time.nanoTimestamp(); const duration_ms = @intCast(u64, end - start) / 1_000_000; const qps = iterations * 1000 / duration_ms; std.debug.print("Query performance: {} QPS\n", .{qps}); // Assert minimum performance const baseline_qps: u64 = 0; // Set based on your benchmark baseline try testing.expect(qps >= baseline_qps); } </code></pre></div> <h4 id="mutation-testing" class="position-relative d-flex align-items-center group"> Mutation 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="mutation-testing" aria-haspopup="dialog" aria-label="Share link: Mutation Testing"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># mutation_test.py """ Mutation testing verifies test quality by intentionally breaking code """ def run_mutation_tests(): mutations = [ ("==", "!="), # Flip equality (">", ">="), # Change boundary ("and", "or"), # Flip logic ("true", "false"), ] results = [] for original, mutated in mutations: # Apply mutation apply_mutation(original, mutated) # Run tests test_result = run_tests() if test_result.all_passed: # Mutation survived - tests didn't catch the bug! results.append({ 'mutation': f"{original} -> {mutated}", 'survived': True, 'weakness': 'Tests do not cover this logic' }) else: # Mutation caught - tests are working results.append({ 'mutation': f"{original} -> {mutated}", 'survived': False }) # Revert mutation revert_mutation() return results </code></pre></div> <h4 id="snapshot-testing" class="position-relative d-flex align-items-center group"> Snapshot 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="snapshot-testing" aria-haspopup="dialog" aria-label="Share link: Snapshot Testing"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-rust" data-lang="rust">// geode-client-rust/tests/snapshot_tests.rs use insta::assert_snapshot; use geode_client::Client; #[tokio::test] async fn test_query_plan_snapshot() -> geode_client::Result<()> { let client = Client::from_dsn("localhost:3141")?; let mut conn = client.connect().await?; let plan = conn .explain("MATCH (u:User)-[:KNOWS]->(friend) WHERE u.country = 'USA' RETURN friend.name") .await?; // Compare against saved snapshot assert_snapshot!(format!("{:#?}", plan)); Ok(()) } #[tokio::test] async fn test_error_message_snapshot() { let client = Client::from_dsn("localhost:3141").unwrap(); let mut conn = client.connect().await.unwrap(); let error = conn.query("INVALID SYNTAX").await.unwrap_err(); // Ensure error messages stay consistent assert_snapshot!(error.to_string()); } </code></pre></div> <h3 id="test-infrastructure" class="position-relative d-flex align-items-center group"> Test Infrastructure <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" aria-haspopup="dialog" aria-label="Share link: Test Infrastructure"> Share link </button> </h3> <h4 id="continuous-integration-pipeline" class="position-relative d-flex align-items-center group"> Continuous Integration 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="continuous-integration-pipeline" aria-haspopup="dialog" aria-label="Share link: Continuous Integration Pipeline"> 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, pull_request] jobs: unit-tests: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Setup Zig uses: goto-bus-stop/setup-zig@v2 with: version: 0.1.0 - name: Run Geode unit tests run: | cd geode zig build test --summary all - name: Generate coverage report run: | cd geode zig build test -Dcoverage=true zig build coverage-report - name: Upload coverage uses: codecov/codecov-action@v3 with: files: ./geode/coverage/lcov.info client-tests: runs-on: ubuntu-latest strategy: matrix: client: [go, python, rust, zig] steps: - uses: actions/checkout@v3 - name: Run ${{ matrix.client }} tests run: | cd geode-client-${{ matrix.client }} make test integration-tests: runs-on: ubuntu-latest needs: [unit-tests, client-tests] steps: - uses: actions/checkout@v3 - name: Start Geode server run: | cd geode zig build ./zig-out/bin/geode serve & sleep 5 - name: Run integration tests run: | cd geode-test-harness make test-all </code></pre></div> <h4 id="test-fixture-management" class="position-relative d-flex align-items-center group"> Test Fixture 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-fixture-management" aria-haspopup="dialog" aria-label="Share link: Test Fixture Management"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># conftest.py - Shared test fixtures import pytest import asyncio from geode_client import Client @pytest.fixture(scope="session") def event_loop(): """Create event loop for async tests""" loop = asyncio.get_event_loop_policy().new_event_loop() yield loop loop.close() @pytest.fixture(scope="session") async def geode_server(): """Start Geode server for testing""" import subprocess process = subprocess.Popen( ["./zig-out/bin/geode", "serve", "--test-mode"], stdout=subprocess.PIPE, stderr=subprocess.PIPE ) # Wait for server to be ready await asyncio.sleep(2) yield process # Cleanup process.terminate() process.wait(timeout=10) @pytest.fixture async def client(geode_server): """Provide test client""" client = Client("localhost", 3141) async with client.connection() as c: yield c @pytest.fixture async def clean_db(client): """Clean database before each test""" await c.execute("MATCH (n) DETACH DELETE n") yield await c.execute("MATCH (n) DETACH DELETE n") @pytest.fixture def sample_graph(): """Sample graph data""" return { "nodes": [ {"id": 1, "label": "User", "name": "Alice"}, {"id": 2, "label": "User", "name": "Bob"}, ], "edges": [ {"from": 1, "to": 2, "type": "KNOWS"}, ] } </code></pre></div> <h3 id="test-quality-metrics" class="position-relative d-flex align-items-center group"> Test Quality Metrics <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-quality-metrics" aria-haspopup="dialog" aria-label="Share link: Test Quality Metrics"> Share link </button> </h3> <h4 id="coverage-analysis" class="position-relative d-flex align-items-center group"> 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="coverage-analysis" aria-haspopup="dialog" aria-label="Share link: Coverage Analysis"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"># coverage_analyzer.py class CoverageAnalyzer: def analyze_coverage(self, coverage_file): """Analyze test coverage and identify gaps""" with open(coverage_file) as f: coverage_data = json.load(f) critical_paths = self.identify_critical_paths() uncovered_critical = [] for path in critical_paths: if coverage_data.get(path, {}).get('coverage', 0) < 100: uncovered_critical.append({ 'path': path, 'coverage': coverage_data.get(path, {}).get('coverage', 0), 'priority': 'high' }) return { 'overall_coverage': coverage_data['summary']['coverage'], 'critical_gaps': uncovered_critical, 'recommendations': self.generate_recommendations(uncovered_critical) } def identify_critical_paths(self): """Identify critical code paths that must be tested""" return [ 'src/parser/parser.zig', 'src/storage/transaction.zig', 'src/security/auth.zig', 'src/query/executor.zig', ] </code></pre></div> <h3 id="related-topics" class="position-relative d-flex align-items-center group"> Related Topics <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="related-topics" aria-haspopup="dialog" aria-label="Share link: Related Topics"> Share link </button> </h3><ul> <li><a href="/tags/integration-tests/" >Integration Tests</a> : Integration testing strategies</li> <li><a href="/tags/ci-cd/" >CI/CD</a> : Continuous integration</li> <li><a href="/tags/continuous-integration/" >Continuous Integration</a> : Build automation</li> <li><a href="/tags/deployment/" >Deployment</a> : Deployment strategies</li> <li><a href="/tags/testing/" >Testing</a> : General testing practices</li> </ul> <h3 id="further-reading" class="position-relative d-flex align-items-center group"> Further Reading <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="further-reading" aria-haspopup="dialog" aria-label="Share link: Further Reading"> Share link </button> </h3><ul> <li>Testing Guide: <code>/docs/development/testing-guide/</code></li> <li>Test Coverage: <code>/docs/development/test-coverage/</code></li> <li>GeodeTestLab: <code>/docs/development/geodetestlab/</code></li> <li>CANARY Markers: <code>/docs/development/canary-markers/</code></li> <li>Test Patterns: <code>/docs/development/test-patterns/</code></li> <li>Property-Based Testing: <code>/docs/development/property-based-testing/</code></li> </ul>

Popular

Related Articles

Testing Strategies Guide