#self-contained #directory-tree #compiler-plugin #ship #binaries #macro #compiled

nightly embed

embed is a Rust compiler plugin that lets you embed directory trees into compiled binaries. This is useful in order to ship a single self-contained binary.

2 releases

Uses old Rust 2015

0.1.1 Jul 28, 2016
0.1.0 Jul 26, 2016

#14 in #ship

MIT license

6KB
109 lines

embed

embed is a Rust compiler plugin that lets you embed directory trees into compiled binaries. This is useful in order to ship a single self-contained binary.

First:

[dependencies]
embed = "0.1.1";

Then:

#![feature(plugin)]
#![plugin(embed)]

use std::collections::HashMap;

fn main() {
   let files: HashMap<Vec<u8>, Vec<u8>> = embed!("assets");
   for (name, content) in files {
       println!("{}: \"{}\"", String::from_utf8(name).unwrap(), String::from_utf8(content).unwrap().trim());
  }
}

The output from this varies depending on what is contained in your projects assets directory, but could look something like:

oneword: "hello"
twowords: "hello world!"
dir/file: "foo bar baz"
dir/empty_file: ""

Dependencies

~180KB