Copyright (c) 2018-21 Louise Montalvo louanmontalvo@gmail.com

The Umbra Programming Language

This is a simple macro-based language inspired by Rust and Python. It is in early development and undergoing changes quite quickly so please do not expect stability.

Do to the nature of the language, it has to be interpreted but I'm trying to make it as efficient as possible. Current unofficial benchmarks put it around 2-4x slower than Python to compute fib(12).

Direct Usage

To run the REPL simply use cargo run. To see examples of possible code constructs look at the scripts in test/. You can run scripts by providing the name as an argument as follows: cargo run -- scriptname. You can also run modules with cargo run -- modname. This is the same as running cargo run -- modname/main.um. One such module is test.

Embedded Usage

This crate can be added to your dependencies by adding the following to your project's Cargo.toml:

[dependencies]
umbra_lang = "0.17"

To use the library, call the desired run*() functions (documented below). For example:

let env = Env::prelude();
let (vars, val) = run_path("script.um", &env, true);

Crate Features

• readline - Default, enables use of rustyline for input in run_interactive().
• compile - Enables the ability to serialize ASTs and deserialize them for execution. This is generally untested and currently not any faster than normal.