assay-lua 0.10.3

General-purpose enhanced Lua runtime. Batteries-included scripting, automation, and web services.
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

mod common;

use common::run_lua;

#[tokio::test]
async fn test_process_list() {
    let script = r#"
        local procs = process.list()
        assert.not_nil(procs)
        -- There should be at least one process (the test runner itself)
        local count = 0
        for _ in ipairs(procs) do count = count + 1 end
        assert.gt(count, 0, "expected at least one process")
    "#;
    run_lua(script).await.unwrap();
}

#[tokio::test]
async fn test_process_list_has_pid_and_name() {
    let script = r#"
        local procs = process.list()
        local found = false
        for _, p in ipairs(procs) do
            assert.not_nil(p.pid)
            assert.not_nil(p.name)
            found = true
            break
        end
        assert.eq(found, true, "expected to find at least one process with pid and name")
    "#;
    run_lua(script).await.unwrap();
}

#[tokio::test]
async fn test_process_is_running_known() {
    // Check that is_running returns false for a definitely-nonexistent process
    let script = r#"
        local result = process.is_running("definitely_not_a_real_process_name_xyz")
        assert.eq(result, false)
    "#;
    run_lua(script).await.unwrap();
}

#[tokio::test]
async fn test_process_kill_nonexistent() {
    // Trying to kill a non-existent PID should error
    let result = run_lua(r#"process.kill(999999999)"#).await;
    assert!(result.is_err());
}

#[tokio::test]
async fn test_process_kill_signal_zero() {
    // Signal 0 checks if process exists without killing it.
    // Use our own spawned process instead of PID 1 (which requires root on CI).
    let script = r#"
        local result = shell.exec("sleep 300 </dev/null >/dev/null 2>&1 & echo $!")
        assert.eq(result.status, 0)
        local pid = tonumber(result.stdout:match("(%d+)"))
        assert.not_nil(pid)

        -- Signal 0 should succeed for our own child process
        process.kill(pid, 0)

        -- Clean up
        process.kill(pid, 9)
    "#;
    run_lua(script).await.unwrap();
}

#[tokio::test]
async fn test_process_kill_spawned() {
    // Spawn a background process via shell, then kill it
    // Note: Must redirect bg process stdout/stderr or shell.exec hangs waiting for pipe close
    let script = r#"
        local result = shell.exec("sleep 300 </dev/null >/dev/null 2>&1 & echo $!")
        assert.eq(result.status, 0)
        local pid = tonumber(result.stdout:match("(%d+)"))
        assert.not_nil(pid)

        -- Verify it's running (signal 0 = check existence)
        process.kill(pid, 0)

        -- Kill it with SIGKILL for immediate termination
        process.kill(pid, 9)

        -- Poll until the process is reaped (avoids flaky fixed sleep)
        local deadline = time() + 5  -- 5-second overall timeout
        local gone = false
        while time() < deadline do
            local ok = pcall(process.kill, pid, 0)
            if not ok then
                gone = true
                break
            end
            sleep(0.1)
        end

        assert.eq(gone, true, "process did not terminate within timeout")
    "#;
    run_lua(script).await.unwrap();
}

#[tokio::test]
async fn test_process_wait_idle_not_running() {
    // A process that doesn't exist should return true immediately
    let script = r#"
        local result = process.wait_idle("definitely_nonexistent_process_xyz123", 2, 0.1)
        assert.eq(result, true)
    "#;
    run_lua(script).await.unwrap();
}

#[tokio::test]
async fn test_process_wait_idle_table_of_names() {
    let script = r#"
        local result = process.wait_idle({"nonexistent_a", "nonexistent_b"}, 2, 0.1)
        assert.eq(result, true)
    "#;
    run_lua(script).await.unwrap();
}