Crate artichoke

Artichoke Ruby

This crate is a Rust and Ruby implementation of the Ruby programming language. Artichoke is not production-ready, but intends to be a MRI-compliant implementation of Ruby 2.6.3.

This crate provides:

• An embeddable Ruby interpreter, which can be created with the interpreter function.
• A Rust and Ruby implementation of Ruby Core and Standard Library using high-quality Rust dependencies and modern Ruby.
• Support for injecting Rust code and types into the interpreter with a rubygems-style File API.
• The ability to disable parts of the interpreter VM or library functions at compile time. For example, deny access to the system environ by disabling the core-env-system feature.

Usage

You can create an interpreter and begin executing code on it:

use artichoke::prelude::*;

let mut interp = artichoke::interpreter()?;
let result = interp.eval(b"2 + 5")?;

Artichoke supports calling Ruby functions from Rust and converting between Ruby boxed values and Rust native types:

use artichoke::prelude::*;

let mut interp = artichoke::interpreter()?;
let s = interp.convert_mut("💎");
let codepoint = s.funcall(&mut interp, "ord", &[] /* args */, None /* block */)?;
let codepoint = codepoint.try_into::<u32>(&interp)?;
assert_eq!(128142, codepoint);

Crate Features

• core-env-system - Enabled by default. This activates the std::env backend for the ENV object. When this feature is disabled, access to the environ is emulated with an in-memory store.
• core-math-extra - Enabled by default. This enables additional dependencies to implement some functions in the Math module. When this feature is disabled, these functions raise NotImplementedError.
• core-random - Enabled by default. This includes an implementation of the Random class. This feature includes additional dependencies. When this feature is disabled, Artichoke does not have support for generating psuedorandom numbers.
• stdlib-securerandom - Enabled by default. This feature includes an implementation of a CSPRNG for the SecureRandom module. This feature includes additional dependencies. When this feature is disabled, the SecureRandom module is not present.

Re-exports

pub use artichoke_backend as backend;

Modules

backtrace	Format Ruby Exception backtraces.
parser	Detect if Ruby code parses successfully.
prelude	A "prelude" for users of the artichoke-backend crate.
repl	A REPL (read–eval–print–loop) for an Artichoke interpreter.
ruby	Artichoke CLI entrypoint.

Structs

Artichoke	Interpreter instance.
Exception

Functions

interpreter

Create a new Artichoke Ruby interpreter.