#directory-tree #directory #tree #build #compile-time #static #include

build includedir_codegen

Include a whole directory tree at compile time! - Compile time part

7 releases (4 breaking)

Uses old Rust 2015

0.6.0 May 27, 2020
0.5.0 Dec 14, 2018
0.4.0 Apr 9, 2018
0.3.0 Mar 12, 2018
0.2.1 Feb 20, 2016

#1675 in Filesystem

Download history 1246/week @ 2024-07-21 1440/week @ 2024-07-28 981/week @ 2024-08-04 2081/week @ 2024-08-11 1081/week @ 2024-08-18 1629/week @ 2024-08-25 1404/week @ 2024-09-01 978/week @ 2024-09-08 1135/week @ 2024-09-15 1429/week @ 2024-09-22 542/week @ 2024-09-29 812/week @ 2024-10-06 1161/week @ 2024-10-13 2655/week @ 2024-10-20 1232/week @ 2024-10-27 602/week @ 2024-11-03

5,714 downloads per month
Used in 73 crates (13 directly)

BSD-3-Clause

8KB
113 lines

includedir

Travis Appveyor Crates.io version docs.rs Crates.io license

Include a directory in your Rust binary, e.g. static files for your web server or assets for your game.

Features

  • Automatically compile data into binary
  • Use rust-phf for efficient lookup
  • Wrapping API around the phf map, to abstract away additional features
  • Compression, with optional crate "flate2"
  • Reading from source files for debug builds

Example

Cargo.toml

[package]
name = "example"
version = "0.1.0"

build = "build.rs"
include = ["data"]

[dependencies]
phf = "0.8.0"
includedir = "0.6.0"

[build-dependencies]
includedir_codegen = "0.6.0"

build.rs

extern crate includedir_codegen;

use includedir_codegen::Compression;

fn main() {
    includedir_codegen::start("FILES")
        .dir("data", Compression::Gzip)
        .build("data.rs")
        .unwrap();
}

src/main.rs

extern crate includedir;
extern crate phf;

use std::env;

include!(concat!(env!("OUT_DIR"), "/data.rs"));

fn main() {
    FILES.set_passthrough(env::var_os("PASSTHROUGH").is_some());

    println!("{:?}", FILES.get("data/foo"))
}

Dependencies

~1.9–9MB
~80K SLoC