cc/
target.rs

Help
1//! Very basic parsing of `rustc` target triples.
2//!
3//! See the `target-lexicon` crate for a more principled approach to this.
4
5use std::str::FromStr;
6
7use crate::{Error, ErrorKind};
8
9mod apple;
10mod generated;
11mod llvm;
12mod parser;
13
14pub(crate) use parser::TargetInfoParser;
15
16/// Information specific to a `rustc` target.
17///
18/// See <https://doc.rust-lang.org/cargo/appendix/glossary.html#target>.
19#[derive(Debug, PartialEq, Clone)]
20pub(crate) struct TargetInfo<'a> {
21    /// The full architecture, including the subarchitecture.
22    ///
23    /// This differs from `cfg!(target_arch)`, which only specifies the
24    /// overall architecture, which is too coarse for certain cases.
25    pub full_arch: &'a str,
26    /// The overall target architecture.
27    ///
28    /// This is the same as the value of `cfg!(target_arch)`.
29    pub arch: &'a str,
30    /// The target vendor.
31    ///
32    /// This is the same as the value of `cfg!(target_vendor)`.
33    pub vendor: &'a str,
34    /// The operating system, or `none` on bare-metal targets.
35    ///
36    /// This is the same as the value of `cfg!(target_os)`.
37    pub os: &'a str,
38    /// The environment on top of the operating system.
39    ///
40    /// This is the same as the value of `cfg!(target_env)`.
41    pub env: &'a str,
42    /// The ABI on top of the operating system.
43    ///
44    /// This is the same as the value of `cfg!(target_abi)`.
45    pub abi: &'a str,
46    /// The unversioned LLVM/Clang target triple.
47    unversioned_llvm_target: &'a str,
48}
49
50impl FromStr for TargetInfo<'_> {
51    type Err = Error;
52
53    /// This will fail when using a custom target triple unknown to `rustc`.
54    fn from_str(target_triple: &str) -> Result<Self, Error> {
55        if let Ok(index) =
56            generated::LIST.binary_search_by_key(&target_triple, |(target_triple, _)| target_triple)
57        {
58            let (_, info) = &generated::LIST[index];
59            Ok(info.clone())
60        } else {
61            Err(Error::new(
62                ErrorKind::InvalidTarget,
63                format!("unknown target `{target_triple}`"),
64            ))
65        }
66    }
67}
68
69#[cfg(test)]
70mod tests {
71    use std::str::FromStr;
72
73    use super::TargetInfo;
74
75    // Test tier 1 targets
76    #[test]
77    fn tier1() {
78        let targets = [
79            "aarch64-unknown-linux-gnu",
80            "aarch64-apple-darwin",
81            "i686-pc-windows-gnu",
82            "i686-pc-windows-msvc",
83            "i686-unknown-linux-gnu",
84            "x86_64-apple-darwin",
85            "x86_64-pc-windows-gnu",
86            "x86_64-pc-windows-msvc",
87            "x86_64-unknown-linux-gnu",
88        ];
89
90        for target in targets {
91            // Check that it parses
92            let _ = TargetInfo::from_str(target).unwrap();
93        }
94    }
95
96    // Various custom target triples not (or no longer) known by `rustc`
97    #[test]
98    fn cannot_parse_extra() {
99        let targets = [
100            "aarch64-unknown-none-gnu",
101            "aarch64-uwp-windows-gnu",
102            "arm-frc-linux-gnueabi",
103            "arm-unknown-netbsd-eabi",
104            "armv7neon-unknown-linux-gnueabihf",
105            "armv7neon-unknown-linux-musleabihf",
106            "thumbv7-unknown-linux-gnueabihf",
107            "thumbv7-unknown-linux-musleabihf",
108            "x86_64-rumprun-netbsd",
109            "x86_64-unknown-linux",
110        ];
111
112        for target in targets {
113            // Check that it does not parse
114            let _ = TargetInfo::from_str(target).unwrap_err();
115        }
116    }
117}
cc/target.rs

cc/
target.rs
