021 build requires basic

○ Planned This feature is planned but not yet implemented.

Feature: build:requires for declaring build dependencies

Code

// Test 619: Basic build.requires
// Validates that std.compiler:requires captures build dependencies using implicit Source blocks
//
// This test demonstrates:
// 1. Implicit Source blocks: { zig_code } instead of source: "zig_code"
// 2. AST collection: Compiler walks AST to find std.compiler:requires
// 3. Zero boilerplate: just declare requirements, build.zig generated automatically

~import "$std/compiler"

// Declare build dependencies using implicit Source blocks
// The { } block is compiled to a Source parameter containing raw Zig code
// The compiler's CompilerRequiresCollector walks the AST and collects these
~std.compiler:requires {
    exe.linkSystemLibrary("sqlite3");
}

~std.compiler:requires {
    exe.linkSystemLibrary("zlib");
}

~std.compiler:requires {
    exe.addIncludePath(b.path("vendor/include"));
}

~event main {}
| done {}

~proc main {
    return .{ .done = .{} };
}

~main()
| done |> _
input.kz

Test Configuration

Post-validation Script:

#!/bin/bash
# Verify Source parameter is captured in AST AND build.zig is generated

# Get AST as JSON (note: koruc must be in PATH)
AST_JSON=$(koruc --ast-json input.kz 2>&1 | grep -v "^DEBUG:")

# Check that the Source parameter value contains the expected content
if echo "$AST_JSON" | grep -q 'linkSystemLibrary.*sqlite3'; then
    echo "✓ Source parameter captured sqlite3 requirement in AST"
else
    echo "✗ Source parameter did NOT capture sqlite3 requirement"
    echo "AST JSON (first 100 lines):"
    echo "$AST_JSON" | head -100
    exit 1
fi

# Check that build.zig was generated
if [ ! -f build.zig ]; then
    echo "✗ build.zig was NOT generated"
    exit 1
fi

# Check that build.zig contains sqlite3 requirement
if grep -q 'linkSystemLibrary.*sqlite3' build.zig; then
    echo "✓ build.zig contains sqlite3 requirement"
else
    echo "✗ build.zig missing sqlite3 requirement"
    echo "Generated build.zig:"
    cat build.zig
    exit 1
fi

# Check that build.zig has struct namespacing pattern
if grep -q '_build = struct' build.zig; then
    echo "✓ build.zig uses struct namespacing"
else
    echo "✗ build.zig missing struct namespacing"
    echo "Generated build.zig:"
    cat build.zig
    exit 1
fi

# Check that all three requirements appear in build.zig
if grep -q 'linkSystemLibrary.*sqlite3' build.zig && \
   grep -q 'linkSystemLibrary.*zlib' build.zig && \
   grep -q 'addIncludePath.*vendor/include' build.zig; then
    echo "✓ All three build requirements present in build.zig"
else
    echo "✗ Missing one or more build requirements"
    echo "Generated build.zig:"
    cat build.zig
    exit 1
fi

# Run zig build to ensure generated build.zig actually compiles
echo "Testing zig build on generated build.zig..."
if ! zig build 2>zig_build.err; then
    echo "✗ zig build failed"
    echo "Errors:"
    cat zig_build.err
    exit 1
fi

# Verify binary was created
if [ ! -f zig-out/bin/app ]; then
    echo "✗ Binary was not created"
    exit 1
fi

echo "✓ zig build succeeded"
echo "✓ Binary created at zig-out/bin/app"

# Run the binary to ensure it works
if ! ./zig-out/bin/app; then
    echo "✗ Binary failed to run"
    exit 1
fi

echo "✓ Binary runs successfully"
echo "✅ All validations passed!"
exit 0
← 020 ccp flag only 022 multiline params →