#build-script #build #static #const #compile-time #no-std

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

#113 in Build Utils

Download history 39912/week @ 2023-12-06 34510/week @ 2023-12-13 24269/week @ 2023-12-20 18914/week @ 2023-12-27 39365/week @ 2024-01-03 37660/week @ 2024-01-10 42355/week @ 2024-01-17 44281/week @ 2024-01-24 42950/week @ 2024-01-31 43551/week @ 2024-02-07 45550/week @ 2024-02-14 50367/week @ 2024-02-21 52353/week @ 2024-02-28 55198/week @ 2024-03-06 47931/week @ 2024-03-13 46352/week @ 2024-03-20

212,287 downloads per month
Used in 259 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