build-target 0.8.0

A crate that provides programmatic access to information about the current build target.
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

use std::fmt;

use crate::utils::{build_env_opt, define_target_enum};

define_target_enum! {
    /// A more generic description of a target, such as the family of
    /// the operating systems or architectures that the target generally falls into.
    #[derive(Clone, Debug, Eq, Hash, PartialEq, PartialOrd, Ord)]
    #[non_exhaustive]
    pub enum Family {
        /// Unix based operating systems
        Unix => "unix",
        /// Microsoft's Windows operating system
        Windows => "windows",
        /// WebAssembly
        Wasm => "wasm",
    }

    as_str_doc = "String representing this target family which matches `#[cfg(target_family)]`",
    from_str_doc = "Tries to parse the given string as an [`Family`] falling back to [`Family::Other`] for unknown values.",
}

impl Family {
    /// Gets the current target [`Family`]s.
    pub fn target() -> Vec<Self> {
        build_env_opt("CARGO_CFG_TARGET_FAMILY")
            .unwrap_or_default()
            .split(',')
            .filter(|s| !s.is_empty())
            .map(Self::from_str)
            .collect()
    }
}

impl fmt::Display for Family {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(self.as_str())
    }
}