#include-bytes #include-str #loading #assets #macro #run-time #during

load_file

Macros to help conveniently load the contents of files during development

6 releases (2 stable)

Uses old Rust 2015

1.0.1 Jul 30, 2021
1.0.0 Aug 14, 2018
0.1.3 Aug 10, 2018

#1127 in Development tools

Download history 19/week @ 2023-12-04 43/week @ 2023-12-11 21/week @ 2023-12-18 29/week @ 2024-01-01 21/week @ 2024-01-08 22/week @ 2024-01-15 163/week @ 2024-01-22 123/week @ 2024-01-29 138/week @ 2024-02-05 507/week @ 2024-02-12 354/week @ 2024-02-19 127/week @ 2024-02-26 186/week @ 2024-03-04 197/week @ 2024-03-11 203/week @ 2024-03-18

725 downloads per month
Used in 2 crates

MIT license

9KB
82 lines

Build Status Latest version Documentation

This crate provides macros to help conveniently load the contents of files during development.

load_str! and load_bytes! are modeled after include_str! and include_bytes! from the standard library. The standard library macros are useful in many situations, one of which is quick-and-dirty loading of assets during a prototyping phase. (Examples of such assets are static web assets such as CSS or GLSL shaders for a game.) The load_* macros aim to offer a convenient way of loading the assets dynamically at run-time instead. This gets rid of the need to compile or even restart for every change while iterating on the assets.

Example

Before:

fn main() {
    println!("{}", include_str!("greeting.txt"));
}

After:

#[macro_use]
extern crate load_file;

fn main() {
    println!("{}", load_str!("greeting.txt"));
}

No runtime deps