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

#![allow(missing_docs)]
//! CLI Contract Tests: `ruchy lint`
//!
//! **Purpose**: Validate user-facing contract (exit codes, lint warnings/errors)
//! **Layer 4**: CLI expectation testing (black-box validation)
//!
//! **Contract Specification**:
//! - Exit code 0: No lint errors (warnings OK)
//! - Exit code 1: Lint errors found OR syntax error OR file not found
//! - stdout: Lint warnings and errors
//! - stderr: Fatal errors (file not found, syntax errors)
//!
//! **Reference**: docs/specifications/15-tool-improvement-spec.md (v4.0)

use assert_cmd::Command;
use predicates::prelude::*;
use std::fs;
use tempfile::TempDir;

/// Helper: Create ruchy command
fn ruchy_cmd() -> Command {
    assert_cmd::cargo::cargo_bin_cmd!("ruchy")
}

/// Helper: Create temp file with content
fn create_temp_file(dir: &TempDir, name: &str, content: &str) -> std::path::PathBuf {
    let path = dir.path().join(name);
    fs::write(&path, content).expect("Failed to write temp file");
    path
}

// ============================================================================
// CLI CONTRACT TESTS: EXIT CODES
// ============================================================================

#[test]
fn cli_lint_clean_code_exits_zero() {
    let temp = TempDir::new().unwrap();
    let file = create_temp_file(&temp, "clean.ruchy", "let x = 42\nprintln(x)\n");

    ruchy_cmd().arg("lint").arg(&file).assert().success(); // Exit code 0
}

#[test]
fn cli_lint_syntax_error_exits_nonzero() {
    let temp = TempDir::new().unwrap();
    let file = create_temp_file(&temp, "invalid.ruchy", "let x = \n");

    ruchy_cmd().arg("lint").arg(&file).assert().failure(); // Exit code != 0
}

#[test]
fn cli_lint_missing_file_exits_nonzero() {
    ruchy_cmd()
        .arg("lint")
        .arg("nonexistent.ruchy")
        .assert()
        .failure(); // Exit code != 0
}

// ============================================================================
// CLI CONTRACT TESTS: LINT WARNINGS
// ============================================================================

#[test]
fn cli_lint_unused_variable_warning() {
    let temp = TempDir::new().unwrap();
    let file = create_temp_file(&temp, "unused.ruchy", "let unused_var = 42\n");

    let output = ruchy_cmd().arg("lint").arg(&file).assert().success(); // Warnings don't cause failure

    // Should contain warning about unused variable
    let stdout = String::from_utf8_lossy(&output.get_output().stdout);
    assert!(
        stdout.contains("unused") || stdout.contains("not used") || stdout.is_empty(),
        "Expected unused variable warning or clean output, got: {stdout}"
    );
}

#[test]
fn cli_lint_shadowing_detection() {
    let temp = TempDir::new().unwrap();
    let file = create_temp_file(&temp, "shadow.ruchy", "let x = 1\nlet x = 2\nprintln(x)\n");

    ruchy_cmd().arg("lint").arg(&file).assert().success(); // Shadowing is warning, not error
}

// ============================================================================
// CLI CONTRACT TESTS: ERROR HANDLING
// ============================================================================

#[test]
fn cli_lint_syntax_error_writes_stderr() {
    let temp = TempDir::new().unwrap();
    let file = create_temp_file(&temp, "bad.ruchy", "fun f( { }\n");

    ruchy_cmd()
        .arg("lint")
        .arg(&file)
        .assert()
        .failure()
        .stderr(predicate::str::is_empty().not());
}

#[test]
fn cli_lint_missing_file_writes_stderr() {
    ruchy_cmd()
        .arg("lint")
        .arg("missing.ruchy")
        .assert()
        .failure()
        .stderr(
            predicate::str::contains("not found")
                .or(predicate::str::contains("No such file"))
                .or(predicate::str::contains("does not exist")),
        );
}

// ============================================================================
// CLI CONTRACT TESTS: OUTPUT FORMAT
// ============================================================================

#[test]
fn cli_lint_clean_code_no_warnings() {
    let temp = TempDir::new().unwrap();
    let file = create_temp_file(&temp, "perfect.ruchy", "let x = 42\nprintln(x)\n");

    ruchy_cmd().arg("lint").arg(&file).assert().success();
    // Note: stdout may contain "No lint errors" or be empty - both OK
}

// ============================================================================
// CLI CONTRACT TESTS: EDGE CASES
// ============================================================================

#[test]
fn cli_lint_empty_file_fails() {
    let temp = TempDir::new().unwrap();
    let file = create_temp_file(&temp, "empty.ruchy", "");

    ruchy_cmd().arg("lint").arg(&file).assert().failure(); // Empty file is error
}

#[test]
fn cli_lint_comment_only_fails() {
    let temp = TempDir::new().unwrap();
    let file = create_temp_file(&temp, "comments.ruchy", "// Just a comment\n");

    ruchy_cmd().arg("lint").arg(&file).assert().failure(); // Comment-only is error
}