alef-e2e 0.16.60

Fixture-driven e2e test generator for alef
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130

//! Regression: Zig e2e `build.zig` must link libc on every module that imports
//! the binding (which references C stdlib symbols via the FFI header) and on the
//! shared binding module itself. Zig 0.16 surfaces missing libc as:
//!
//! ```text
//! error: dependency on libc must be explicitly specified in the build command
//! pub extern "c" fn getenv(name: [*:0]const u8) ?[*:0]u8;
//! ```
//!
//! Each `b.createModule(.{...})` block in the generated `build.zig` must include
//! `.link_libc = true,`.

use alef_core::config::NewAlefConfig;
use alef_e2e::codegen::E2eCodegen;
use alef_e2e::codegen::zig::ZigE2eCodegen;
use alef_e2e::fixture::{Assertion, Fixture, FixtureGroup, MockResponse};

const CONFIG_TOML: &str = r#"
[workspace]
languages = ["zig"]

[[crates]]
name = "kreuzcrawl"
sources = ["src/lib.rs"]

[crates.e2e]
fixtures = "fixtures"
output = "e2e"

[crates.e2e.call]
function = "scrape"
module = "kreuzcrawl"
result_var = "result"
async = false
returns_result = true
args = [
  { name = "url", field = "url", type = "string" },
]
"#;

fn group() -> FixtureGroup {
    FixtureGroup {
        category: "smoke".to_string(),
        fixtures: vec![Fixture {
            id: "scrape_basic".to_string(),
            category: Some("smoke".to_string()),
            description: "basic scrape".to_string(),
            tags: Vec::new(),
            skip: None,
            env: None,
            call: None,
            input: serde_json::json!({ "url": "https://example.com" }),
            mock_response: Some(MockResponse {
                status: 200,
                body: Some(serde_json::Value::String("<html></html>".to_string())),
                stream_chunks: None,
                headers: std::collections::HashMap::new(),
            }),
            visitor: None,
            assertions: vec![Assertion {
                assertion_type: "not_error".to_string(),
                field: None,
                value: None,
                values: None,
                method: None,
                check: None,
                args: None,
                return_type: None,
            }],
            source: "smoke.json".to_string(),
            http: None,
        }],
    }
}

fn render_build_zig() -> String {
    let cfg: NewAlefConfig = toml::from_str(CONFIG_TOML).expect("config parses");
    let resolved = cfg.clone().resolve().expect("resolves").remove(0);
    let e2e = cfg.crates[0].e2e.clone().expect("e2e config");
    let files = ZigE2eCodegen
        .generate(&[group()], &e2e, &resolved, &[], &[])
        .expect("generation succeeds");
    files
        .iter()
        .find(|f| f.path.file_name().is_some_and(|n| n == "build.zig"))
        .expect("build.zig generated")
        .content
        .clone()
}

#[test]
fn build_zig_links_libc_on_every_test_module() {
    let content = render_build_zig();

    // Each createModule block (per test file) must enable libc linking.
    // We use the count of `b.createModule(.{` blocks as the lower bound and
    // require at least that many `.link_libc = true` lines under those blocks.
    let create_module_count = content.matches("b.createModule(.{").count();
    let link_libc_count = content.matches(".link_libc = true,").count();

    assert!(
        create_module_count >= 1,
        "expected at least one createModule block in:\n{content}"
    );
    // Shared module uses `b.addModule(...)` (not createModule) but also needs
    // libc, so we require one more `.link_libc = true` than createModule blocks.
    assert!(
        link_libc_count > create_module_count,
        "expected `.link_libc = true,` on each createModule block plus the shared addModule, \
         found {link_libc_count} link_libc lines vs {create_module_count} createModule blocks:\n{content}"
    );
}

#[test]
fn build_zig_shared_binding_module_links_libc() {
    let content = render_build_zig();
    // The shared binding module uses `b.addModule(...)` (named after the binding
    // module). Confirm its block contains `.link_libc = true,`.
    let add_module_idx = content
        .find("b.addModule(")
        .expect("shared binding addModule call missing");
    let block_end = content[add_module_idx..]
        .find("    });")
        .expect("addModule block close missing");
    let block = &content[add_module_idx..add_module_idx + block_end];
    assert!(
        block.contains(".link_libc = true,"),
        "shared binding addModule block must enable libc:\n{block}"
    );
}