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

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

#1647 in Development tools

Download history 882/week @ 2024-09-04 1276/week @ 2024-09-11 554/week @ 2024-09-18 607/week @ 2024-09-25 1708/week @ 2024-10-02 3259/week @ 2024-10-09 1310/week @ 2024-10-16 667/week @ 2024-10-23 524/week @ 2024-10-30 605/week @ 2024-11-06 2012/week @ 2024-11-13 961/week @ 2024-11-20 653/week @ 2024-11-27 2087/week @ 2024-12-04 4910/week @ 2024-12-11 1754/week @ 2024-12-18

9,464 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