build-rs 0.3.1

API for writing Cargo `build.rs` files
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

//! build-rs provides a strongly typed interface around the Cargo build script
//! protocol. Cargo provides inputs to the build script by environment variable
//! and accepts commands by printing to stdout.
//!
//! > This crate is maintained by the Cargo team for use by the wider
//! > ecosystem. This crate follows semver compatibility for its APIs.
#![cfg_attr(all(doc, feature = "unstable"), feature(doc_auto_cfg, doc_cfg))]
#![allow(clippy::disallowed_methods)] // HACK: deferred resoling this
#![allow(clippy::print_stdout)] // HACK: deferred resoling this

#[cfg(feature = "unstable")]
macro_rules! unstable {
    ($feature:ident, $issue:literal) => {
        concat!(
            r#"<div class="stab unstable">"#,
            r#"<span class="emoji">🔬</span>"#,
            r#"<span>This is a nightly-only experimental API. (<code>"#,
            stringify!($feature),
            r#"</code>&nbsp;<a href="https://github.com/rust-lang/rust/issues/"#,
            $issue,
            r#"">#"#,
            $issue,
            r#"</a>)</span>"#,
            r#"</div>"#
        )
    };
}

macro_rules! respected_msrv {
    ($ver:literal) => {
        concat!(
            r#"<div class="warning">

MSRV: Respected as of "#,
            $ver,
            r#".

</div>"#
        )
    };
}

macro_rules! requires_msrv {
    ($ver:literal) => {
        concat!(
            r#"<div class="warning">

MSRV: Requires "#,
            $ver,
            r#".

</div>"#
        )
    };
}

mod ident;

pub mod input;
pub mod output;