44 releases

0.13.4 Jul 23, 2024
0.13.2 Mar 7, 2024
0.13.1 Oct 10, 2023
0.12.4 Jun 9, 2023
0.0.0 Jul 12, 2018

#34 in Programming languages

Download history 1025/week @ 2024-07-30 513/week @ 2024-08-06 1013/week @ 2024-08-13 505/week @ 2024-08-20 463/week @ 2024-08-27 931/week @ 2024-09-03 222/week @ 2024-09-10 561/week @ 2024-09-17 509/week @ 2024-09-24 636/week @ 2024-10-01 351/week @ 2024-10-08 474/week @ 2024-10-15 295/week @ 2024-10-22 477/week @ 2024-10-29 508/week @ 2024-11-05 332/week @ 2024-11-12

1,857 downloads per month
Used in 15 crates (14 directly)

MIT/Apache

4.5MB
99K SLoC

Contains (WOFF font, 1.5MB) NanumBarunGothic-Regular.woff2, (WOFF font, 135KB) FiraSans-Medium.woff2, (WOFF font, 130KB) FiraSans-Regular.woff2, (WOFF font, 75KB) SourceCodePro-Regular.woff2, (WOFF font, 75KB) SourceCodePro-Semibold.woff2, (WOFF font, 82KB) SourceSerif4-Bold.woff2 and 2 more.

rune logo
Visit the site 🌐Read the book 📖

rune

github crates.io docs.rs build status chat on discord

The Rune Language, an embeddable dynamic programming language for Rust.


Contributing

If you want to help out, please have a look at Open Issues.


Highlights of Rune


Rune scripts

You can run Rune programs with the bundled CLI:

cargo run --bin rune -- run scripts/hello_world.rn

If you want to see detailed diagnostics of your program while it's running, you can use:

cargo run --bin rune -- run scripts/hello_world.rn --dump-unit --trace --dump-vm

See --help for more information.


Running scripts from Rust

You can find more examples in the examples folder.

The following is a complete example, including rich diagnostics using termcolor. It can be made much simpler if this is not needed.

use rune::{Context, Diagnostics, Source, Sources, Vm};
use rune::termcolor::{ColorChoice, StandardStream};
use std::sync::Arc;

let context = Context::with_default_modules()?;
let runtime = Arc::new(context.runtime()?);

let mut sources = Sources::new();
sources.insert(Source::memory("pub fn add(a, b) { a + b }")?);

let mut diagnostics = Diagnostics::new();

let result = rune::prepare(&mut sources)
    .with_context(&context)
    .with_diagnostics(&mut diagnostics)
    .build();

if !diagnostics.is_empty() {
    let mut writer = StandardStream::stderr(ColorChoice::Always);
    diagnostics.emit(&mut writer, &sources)?;
}

let unit = result?;
let mut vm = Vm::new(runtime, Arc::new(unit));

let output = vm.call(["add"], (10i64, 20i64))?;
let output: i64 = rune::from_value(output)?;

println!("{}", output);

Dependencies

~5–19MB
~250K SLoC