#build-script #build #static #build-time #compile-time #const #embedded

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

#123 in Build Utils

Download history 50678/week @ 2024-07-28 49718/week @ 2024-08-04 45756/week @ 2024-08-11 45782/week @ 2024-08-18 47113/week @ 2024-08-25 45742/week @ 2024-09-01 44834/week @ 2024-09-08 44039/week @ 2024-09-15 50217/week @ 2024-09-22 41889/week @ 2024-09-29 51428/week @ 2024-10-06 53741/week @ 2024-10-13 55524/week @ 2024-10-20 48805/week @ 2024-10-27 54166/week @ 2024-11-03 56447/week @ 2024-11-10

217,249 downloads per month
Used in 266 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