ruchy 4.2.0

A systems scripting language that transpiles to idiomatic Rust with extreme quality engineering
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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186

#![allow(missing_docs)]
//! Tests for DEBUGGER-014 Phase 2: Enhanced tracing with argument and return values
//! GitHub Issue: <https://github.com/paiml/ruchy/issues/84>
//!
//! Phase 2 enhances Phase 1 basic tracing (function entry/exit) with:
//! - Argument values: TRACE: → fibonacci(3)
//! - Return values: TRACE: ← fibonacci = 2
//!
//! Test naming convention: `test_debugger_014_phase_2`_<feature>_<scenario>

use predicates::prelude::*;

/// Test #1: Trace function call with single argument value
///
/// This tests that --trace outputs argument values when calling functions
#[test]
fn test_debugger_014_phase_2_trace_single_argument() {
    let code = r#"
fun square(x) {
    return x * x;
}

fun main() {
    let result = square(5);
    println("Result: {}", result);
}
"#;

    assert_cmd::cargo::cargo_bin_cmd!("ruchy")
        .arg("--trace")
        .arg("-e")
        .arg(code)
        .timeout(std::time::Duration::from_secs(5))
        .assert()
        .success()
        .stdout(predicate::str::contains("TRACE: → square(5: integer)"))
        .stdout(predicate::str::contains("TRACE: ← square = 25: integer"));
}

/// Test #2: Trace function call with multiple arguments
///
/// This tests that --trace handles multiple arguments correctly
#[test]
fn test_debugger_014_phase_2_trace_multiple_arguments() {
    let code = r#"
fun add(a, b) {
    return a + b;
}

fun main() {
    let result = add(10, 20);
    println("Result: {}", result);
}
"#;

    assert_cmd::cargo::cargo_bin_cmd!("ruchy")
        .arg("--trace")
        .arg("-e")
        .arg(code)
        .timeout(std::time::Duration::from_secs(5))
        .assert()
        .success()
        .stdout(predicate::str::contains(
            "TRACE: → add(10: integer, 20: integer)",
        ))
        .stdout(predicate::str::contains("TRACE: ← add = 30: integer"));
}

/// Test #3: Trace recursive function with argument values
///
/// This tests that --trace shows argument values in recursive calls
#[test]
fn test_debugger_014_phase_2_trace_recursive_arguments() {
    let code = r#"
fun factorial(n) {
    if n <= 1 {
        return 1;
    }
    return n * factorial(n - 1);
}

fun main() {
    let result = factorial(3);
    println("Result: {}", result);
}
"#;

    assert_cmd::cargo::cargo_bin_cmd!("ruchy")
        .arg("--trace")
        .arg("-e")
        .arg(code)
        .timeout(std::time::Duration::from_secs(5))
        .assert()
        .success()
        .stdout(predicate::str::contains("TRACE: → factorial(3: integer)"))
        .stdout(predicate::str::contains("TRACE: → factorial(2: integer)"))
        .stdout(predicate::str::contains("TRACE: → factorial(1: integer)"))
        .stdout(predicate::str::contains("TRACE: ← factorial = 1: integer"))
        .stdout(predicate::str::contains("TRACE: ← factorial = 2: integer"))
        .stdout(predicate::str::contains("TRACE: ← factorial = 6: integer"));
}

/// Test #4: Trace function with string arguments
///
/// This tests that --trace handles string values correctly
#[test]
fn test_debugger_014_phase_2_trace_string_arguments() {
    let code = r#"
fun greet(name) {
    return "Hello, " + name;
}

fun main() {
    let msg = greet("Alice");
    println("{}", msg);
}
"#;

    assert_cmd::cargo::cargo_bin_cmd!("ruchy")
        .arg("--trace")
        .arg("-e")
        .arg(code)
        .timeout(std::time::Duration::from_secs(5))
        .assert()
        .success()
        .stdout(predicate::str::contains(
            "TRACE: → greet(\"Alice\": string)",
        ))
        .stdout(predicate::str::contains(
            "TRACE: ← greet = \"Hello, Alice\": string",
        ));
}

/// Test #5: Trace function with no arguments
///
/// This tests that --trace handles zero-argument functions correctly
#[test]
fn test_debugger_014_phase_2_trace_no_arguments() {
    let code = r#"
fun get_answer() {
    return 42;
}

fun main() {
    let answer = get_answer();
    println("Answer: {}", answer);
}
"#;

    assert_cmd::cargo::cargo_bin_cmd!("ruchy")
        .arg("--trace")
        .arg("-e")
        .arg(code)
        .timeout(std::time::Duration::from_secs(5))
        .assert()
        .success()
        .stdout(predicate::str::contains("TRACE: → get_answer()"))
        .stdout(predicate::str::contains("TRACE: ← get_answer = 42"));
}

/// Test #6: Backward compatibility - Phase 1 tests still pass
///
/// This ensures Phase 2 doesn't break existing Phase 1 trace output
#[test]
fn test_debugger_014_phase_2_backward_compatible() {
    let code = r"
fun test_func() {
    return 42;
}

fun main() {
    test_func();
}
";

    assert_cmd::cargo::cargo_bin_cmd!("ruchy")
        .arg("--trace")
        .arg("-e")
        .arg(code)
        .timeout(std::time::Duration::from_secs(5))
        .assert()
        .success()
        // Phase 1 format still works (contains function name)
        .stdout(predicate::str::contains("TRACE: → test_func"))
        .stdout(predicate::str::contains("TRACE: ← test_func"));
}