Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,605 Commits
.github/workflows		.github/workflows
.vscode		.vscode
assets		assets
benches		benches
book		book
crates		crates
editors/code		editors/code
examples		examples
no-std		no-std
scripts		scripts
site		site
tools		tools
.gitattributes		.gitattributes
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
Cargo.toml		Cargo.toml
LICENSE-APACHE		LICENSE-APACHE
LICENSE-MIT		LICENSE-MIT
README.md		README.md
Rune.toml		Rune.toml

Repository files navigation

Visit the site 🌐—Read the book 📖

rune

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

Contributing

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

Highlights of Rune

Runs a compact representation of the language on top of an efficientstack-based virtual machine.
CleanRust integration 💻.
Multithreaded 📖 execution.
Hot reloading 📖.
Memory safe throughreference counting 📖.
Awesome macros 📖 andTemplate literals 📖.
Try operators 📖 andPattern matching 📖.
Structs and enums 📖 with associated data andfunctions.
Dynamic containers likevectors 📖,objects📖, andtuples 📖 all without-of-the-boxserde support 💻.
First-classasync support 📖 withGenerators 📖.
Dynamicinstance functions 📖.
Stack isolation 📖 between function calls.

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 --trace

See--help for more information.

Running scripts from Rust

You can find more examplesin theexamples folder.

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

use rune::{Context,Diagnostics,Source,Sources,Vm};use rune::termcolor::{ColorChoice,StandardStream};use rune::sync::Arc;let context =Context::with_default_modules()?;letmut sources =Sources::new();sources.insert(Source::memory("pub fn add(a, b) { a + b }")?);letmut diagnostics =Diagnostics::new();let result = rune::prepare(&mut sources).with_context(&context).with_diagnostics(&mut diagnostics).build_vm();if !diagnostics.is_empty(){letmut writer =StandardStream::stderr(ColorChoice::Always);    diagnostics.emit(&mut writer,&sources)?;}letmut vm = result?;let output = vm.call(["add"],(10i64,20i64))?;let output:i64 = rune::from_value(output)?;println!("{}", output);