4 releases (2 breaking)

Uses old Rust 2015

0.3.0 Oct 18, 2017
0.2.0 Oct 18, 2017
0.1.1 Aug 14, 2016
0.1.0 May 15, 2016

#877 in Development tools

39 downloads per month
Used in 2 crates

MIT license

331 lines


Build Status Crates.io MIT licensed

Embed Ruby plugins directly into your Rust project!

Requires Rust nightly.


The purpose of this library is to allow scripting in your Rust projects as easy as possible.

The library itself consists of two main parts - a Ruby VM and a syntax extension which creates Ruby wrappers over your structs and impls so they can be used directly from Ruby.

It should be possible to simply annotate a type with #[pluggable] and use it directly from Ruby.

The thing that separates the library from the others is that it allows you to share your Rust code with Ruby, as opposed to writing Ruby objects in Rust.


  • Creation of a Ruby VM and evaluating Ruby code
  • Calling methods on Rust objects from Ruby
  • Accessing public struct fields from Ruby
  • Creating new Rust objects via Ruby
  • Complicated types such as enums, tuples
  • Automatic marshalling of Ruby arguments into Rust types
  • Automatic marshalling of Rust return types into Ruby values
  • Support for Python


NOTE: Not everything here is supported yet. This is mostly automatic coercion between Rust and Ruby types.

Check tools/ for a working example.

struct Vector3(pub f64, pub f64, pub f64);

struct Player
    name: String,

    health: f32,

    position: Vector3,
    rotation: Vector3,

impl Player
    pub fn revive(&mut self) { self.health = 1.0 }
    pub fn rename(&mut self, name: &str) { self.name = name.to_owned() }

    pub fn transport(&mut self, position: Vector3) { self.position = position; }

fn main() {
    let mut vm = Ruby::new();

    let player = Player { /* ... */ };
    vm.plug("main_player", player);