Ratón 🐁

A tiny, highly modular, embeddable, dynamically typed scripting language with a bytecode VM, intended for use in games.

Example

[dependences]
raton = {
  version = "0",
  features = ["i32_type", "while_loop", "single_line_comment"],
  default-features = false
}

// Add up all integers from 1 to n
fn sum_to_n(n) {
    let i = 0;
    let sum = 0;
    while (i < n) {
        i = i + 1;
        sum = sum + i;
    }
    return sum;
}

Status

Unfinished, do not use in production.

Components

• Parser
• Bytecode generator
• Bytecode VM
• Optimizer
• Modular standard library

Modular type system

• null
• bool (optional bool_type feature)
• i32 (optional i32_type feature)
• f32 (optional f32_type feature)
• string (optional string_type feature)
• Host value (optional)
• Host reference (optional)

Modular language features

• if, else (optional if_expression feature)
• while, break, continue (optional while_loop feature)
• // comments (optional single_line_comment feature)
• /* */ comments (optional multi_line_comment feature)

Serialization

• serde (ast and bytecode)
• bitcode (bytecode only)

Other features

• Portable to any platform, 32 bits or higher, supported by Rust
• Parsing, code generation, and runtime have configurable limits
• no_std
• Proper error handling
• Proper error messages

Performance

Ratón takes ~0.3s on Fibonacci and ~0.04s on 1M Loop (see Rhai benchmarks).

Security

Ratón is designed to handle untrusted or malicious source code, asts, or bytecode without panicking, exhausting memory, memory unsafety, exponential time complexity, or infinite loop. Unsafe code is forbidden, and each component has a fuzzer that tests it against arbitrary inputs.

You are responsible for using the limits, such as on instructions and call stack depth, that it provides.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.