#build-script #embedded #const #build #static

no-std build build_const

library for creating importable constants from build.rs or a script

5 releases

Uses old Rust 2015

0.2.2 Apr 20, 2021
0.2.1 Apr 13, 2018
0.2.0 May 31, 2017
0.1.1 May 30, 2017
0.1.0 May 29, 2017

#158 in Build Utils

Download history 48367/week @ 2024-12-17 18810/week @ 2024-12-24 28760/week @ 2024-12-31 53086/week @ 2025-01-07 62299/week @ 2025-01-14 55618/week @ 2025-01-21 62225/week @ 2025-01-28 77414/week @ 2025-02-04 60389/week @ 2025-02-11 64281/week @ 2025-02-18 62948/week @ 2025-02-25 61418/week @ 2025-03-04 68992/week @ 2025-03-11 75633/week @ 2025-03-18 78113/week @ 2025-03-25 62858/week @ 2025-04-01

296,563 downloads per month
Used in 274 crates (2 directly)

MIT license

12KB
139 lines

build_const: crate for creating constants in your build script

Rust library for creating importable constants from build.rs or a script

See the crate documentation and the crate on crates.io


lib.rs:

build_const: crate for creating constants in your build script

The build_const crate exists to help create rust constant files at compile time or in a generating script. It is ultra simple and lightweight, making constant creation a simple matter.

Recommended use: when developing make your constants in build.rs. Once your constants are fairly stable create a script instead and have your constants file be generated in either a single file or an external crate that you can bring in as a dependency.

Example

Include build_const = VERSION in your Cargo.toml file. For no_std support (macros only) use default-features = false.

See ConstWriter for how to use in a build.rs or script. To then import a "constants.rs" file created in build.rs use:

#[macro_use]
extern crate build_const;

build_const!("constants");
println!("VALUE: {}", VALUE);
println!("VALUE: {}", ARRAY);

For writing constants in a script, the macro src_file! is also provided.

// will write files to `/src/constants.rs`
let mut consts = ConstWriter::from_path(&Path::from(src_file!("constants.rs"))).unwrap();
// ... use consts

No runtime deps

Features