Crate rune

Read the Book 📖

An embeddable dynamic programming language for Rust.

Contributing

If you want to help out, there should be a number of optimization tasks available in Future Optimizations. Or have a look at Open Issues.

Create an issue about the optimization you want to work on and communicate that you are working on it.

Features of Rune

• Clean Rust Integration 💻.
• Memory safe through reference counting 📖.
• Template strings 📖.
• Try operators 📖.
• Pattern matching 📖.
• Structs and enums 📖 with associated data and functions.
• Dynamic vectors 📖, objects 📖, and tuples 📖 with built-in serde support 💻.
• First-class async support 📖.
• Generators 📖.
• Dynamic instance functions 📖.
• Stack isolation between function calls.
• Stack-based C FFI, like Lua's (TBD).

Rune Scripts

You can run Rune programs with the bundled CLI:

cargo run -- scripts/hello_world.rn

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

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

See --help for more information.

Re-exports

pub use diagnostics::termcolor;

Modules

ast	AST for the Rune language.

Structs

Lexer	Lexer for the rune language.
LoadError	An error raised when using one of the load_* functions.
Options	Compiler options.
Parser	Parser for the rune language.
Warning	Compilation warning.
Warnings	Compilation warnings.

Enums

CompileError	Error when encoding AST.
DiagnosticsError	Errors that can be raised when formatting diagnostics.
LoadErrorKind	The kind of the load error.
ParseError	Error when parsing.
WarningKind	Compilation warning kind.

Traits

EmitDiagnostics

Helper trait for emitting diagnostics.

Functions

compile	Compile the given source with default options.
default_context	Construct a a default context runestick context.
emit_warning_diagnostics	Emit warning diagnostics.
load_path	Load the given path.
load_source	Load and compile the given source.
parse_all	Parse the given input as the given type that implements [Parse][crate::traits::Parse].