Crate build_print

A simple set of macros that allow regular printing as well as properly formatted info, warnings, errors, and notes during build scripts.

Traditionally, there are only two ways to print to the console during a build script:

• println!("cargo:warning=...") to print a somewhat annoyingly formatted warning message
• panic!(..) to halt the build process and print an error message

Regular println! statements are not shown during the build process, so this crate hijacks the cargo:warning=... variant using ANSI escape sequences to produce a working println! macro as well as info!, warn!, error!, and note! macros that following the indentation and coloring of standard cargo diagnostic messages.

You can also define your own custom print messages using the custom_println! macro, which is also the basis for the other macros.

Example

// build.rs
use build_print::{println, *};

fn main() {
    println!("regular println works");
    info!("hello world");
    warn!("hello world");
    error!("hello world");
    note!("hello world");
    custom_println!("Documenting", green, "hello world");
}

Macros

custom_println

Allows for custom print messages with a specified prefix and color.

error

Can be used to print error messages during a build script without aborting the build.

info

Can be used to print info messages during a build script.

note

Can be used to print note messages during a build script.

println

Analogue of std::println! that allows for printing to the console during a build script.

warn

Can be used to print warning messages during a build script.