javy-codegen 4.0.0

Wasm generation library for use with Javy
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

use std::path::PathBuf;

use anyhow::Result;
use javy_codegen::{Generator, JS, LinkingKind, Plugin, WitOptions};

#[tokio::test]
async fn test_empty() -> Result<()> {
    // Load valid JS from file.
    let js = JS::from_file(
        &cargo_manifest_dir()
            .join("tests")
            .join("sample-scripts")
            .join("empty.js"),
    )?;

    // Configure code generator.
    let mut generator = Generator::new(default_plugin()?);
    generator.linking(LinkingKind::Static);

    // Generate valid Wasm module.
    let wasm = generator.generate(&js).await?;

    // Verify generated bytes are valid Wasm.
    walrus::Module::from_buffer(wasm.as_slice())?;

    Ok(())
}

#[tokio::test]
async fn test_snapshot_for_dynamically_linked_module() -> Result<()> {
    let sample_scripts = sample_scripts_dir();
    let js = JS::from_file(&sample_scripts.join("exported-functions.js"))?;
    let wasm = Generator::new(default_plugin()?)
        .linking(LinkingKind::Dynamic)
        .wit_opts(WitOptions::from_tuple((
            Some(sample_scripts.join("exported-functions.wit")),
            Some("exported-logs".into()),
        ))?)
        .producer_version("snapshot".into())
        .generate(&js)
        .await?;
    let wat = wasmprinter::print_bytes(wasm)?;
    insta::assert_snapshot!("default_dynamic", wat);
    Ok(())
}

#[tokio::test]
async fn test_deterministic_builds_produce_identical_output() -> Result<()> {
    let js = JS::from_file(
        &cargo_manifest_dir()
            .join("tests")
            .join("sample-scripts")
            .join("empty.js"),
    )?;

    let generate = || async {
        let mut generator = Generator::new(default_plugin()?);
        generator.linking(LinkingKind::Static).deterministic(true);
        generator.generate(&js).await
    };

    let first = generate().await?;
    let second = generate().await?;
    let third = generate().await?;

    assert_eq!(
        first, second,
        "deterministic builds should produce identical output across runs"
    );
    assert_eq!(
        second, third,
        "deterministic builds should produce identical output across runs"
    );

    Ok(())
}

fn cargo_manifest_dir() -> PathBuf {
    PathBuf::from(env!("CARGO_MANIFEST_DIR"))
}

fn sample_scripts_dir() -> PathBuf {
    cargo_manifest_dir().join("tests").join("sample-scripts")
}

fn default_plugin() -> Result<Plugin> {
    Plugin::new_from_path(
        cargo_manifest_dir()
            .join("..")
            .join("..")
            .join("target")
            .join("wasm32-wasip1")
            .join("release")
            .join("plugin_wizened.wasm"),
    )
}