Packer

NOTE This project is based on the original rust-embed. I made enough modifications to it that I decided to just publish it in a separate repository.

packer is a library that helps you pack static files into binaries using macro magic. Here's how it's done:

Step 1: Include

Include the crate in your Cargo.toml:

# Use the git URL unless I decide to publish on crates.io
packer = "0.1"

and in your lib.rs or main.rs:

#[macro_use]
extern crate packer;

Step 2: Derive

Start deriving Packer from your structs. You need to provide a folder attribute to indicate the folder from which it should be pulling. Paths are relative to the crate root.

#[derive(Packer)]
#[folder = "static"]
struct Assets;

Step 3: Use it!

You can now access any file using the get function:

Assets::get("kermit.jpg"); // this is a Option<Vec<u8>>

You may also choose to list all the files that have been stored.

Assets::list(); // this is a ::std::vec::IntoIter<&'static str>

When you build in dev mode, it will fetch off your filesystem as usual, but when you build with --release, it will pack the assets into your binary!

Future Work

Possibly add options for excluding files?

Contact

Author: Michael Zhang