runmat-parser 0.4.5

Parser for RunMat (MATLAB/Octave) producing HIR from token streams
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

use runmat_parser::{Expr, Stmt};

mod parse;
use parse::parse;

#[test]
fn format_long_command_syntax_produces_string_arg() {
    let program = parse("format long").unwrap();
    match &program.body[0] {
        Stmt::ExprStmt(Expr::FuncCall(name, args, _), _, _) => {
            assert_eq!(name, "format");
            assert_eq!(args.len(), 1);
            assert!(
                matches!(&args[0], Expr::String(s, _) if s.trim_matches('"') == "long"),
                "expected string arg \"long\", got {:?}",
                args[0]
            );
        }
        other => panic!("expected ExprStmt(FuncCall), got {other:?}"),
    }
}

#[test]
fn format_short_command_syntax_produces_string_arg() {
    let program = parse("format short").unwrap();
    match &program.body[0] {
        Stmt::ExprStmt(Expr::FuncCall(name, args, _), _, _) => {
            assert_eq!(name, "format");
            assert_eq!(args.len(), 1);
            assert!(
                matches!(&args[0], Expr::String(s, _) if s.trim_matches('"') == "short"),
                "expected string arg \"short\", got {:?}",
                args[0]
            );
        }
        other => panic!("expected ExprStmt(FuncCall), got {other:?}"),
    }
}

#[test]
fn format_no_args_command_syntax_parses() {
    let program = parse("format").unwrap();
    match &program.body[0] {
        Stmt::ExprStmt(Expr::FuncCall(name, args, _), _, _) => {
            assert_eq!(name, "format");
            assert_eq!(args.len(), 0);
        }
        other => panic!("expected ExprStmt(FuncCall), got {other:?}"),
    }
}

#[test]
fn format_all_numeric_modes_parse() {
    // "rat" is the MATLAB-canonical keyword; "rational" is accepted as an alias.
    for mode in &[
        "shortE", "longE", "shortG", "longG", "rat", "rational", "hex",
    ] {
        let src = format!("format {mode}");
        let program = parse(&src).unwrap();
        match &program.body[0] {
            Stmt::ExprStmt(Expr::FuncCall(name, args, _), _, _) => {
                assert_eq!(name, "format");
                assert_eq!(args.len(), 1, "mode '{mode}' should produce 1 arg");
            }
            other => panic!("format {mode}: expected FuncCall, got {other:?}"),
        }
    }
}

#[test]
fn format_rat_is_the_matlab_canonical_keyword() {
    // Verify "format rat" parses (not "format rational").
    let program = parse("format rat").unwrap();
    match &program.body[0] {
        Stmt::ExprStmt(Expr::FuncCall(name, args, _), _, _) => {
            assert_eq!(name, "format");
            assert!(
                matches!(&args[0], Expr::String(s, _) if s.trim_matches('"') == "rat"),
                "expected string arg \"rat\""
            );
        }
        other => panic!("expected ExprStmt(FuncCall), got {other:?}"),
    }
}

#[test]
fn format_spacing_modes_parse_without_error() {
    // compact/loose are spacing modes; not yet implemented but should not be syntax errors.
    for mode in &["compact", "loose"] {
        let src = format!("format {mode}");
        assert!(
            parse(&src).is_ok(),
            "format {mode} should parse without error"
        );
    }
}

#[test]
fn format_truly_unknown_mode_is_a_parse_error() {
    assert!(
        parse("format bank").is_err(),
        "expected parse error for unknown mode 'bank'"
    );
}

#[test]
fn format_long_newline_pi_is_two_statements_not_two_args() {
    // In MATLAB a newline terminates command-form argument parsing.
    // "format long\npi" must produce two statements, not format("long", pi).
    let program = parse("format long\npi").unwrap();
    assert_eq!(program.body.len(), 2, "expected 2 statements");
    match &program.body[0] {
        Stmt::ExprStmt(Expr::FuncCall(name, args, _), _, _) => {
            assert_eq!(name, "format");
            assert_eq!(args.len(), 1);
        }
        other => panic!("statement 0: expected format FuncCall, got {other:?}"),
    }
    match &program.body[1] {
        Stmt::ExprStmt(Expr::Ident(name, _), _, _) => {
            assert_eq!(name, "pi");
        }
        other => panic!("statement 1: expected pi Ident, got {other:?}"),
    }
}