espup 0.7.0

Tool for installing and maintaining Espressif Rust ecosystem.
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! ESP32 chip variants support.

use crate::error::Error;
use log::debug;
use miette::Result;
use std::{collections::HashSet, str::FromStr};
use strum::{Display, EnumIter, EnumString, IntoEnumIterator};

#[derive(Clone, Copy, EnumIter, EnumString, PartialEq, Hash, Eq, Debug, Display)]
#[strum(serialize_all = "lowercase")]
pub enum Target {
    /// Xtensa LX6 based dual core
    ESP32 = 0,
    /// RISC-V based single core
    ESP32C2,
    /// RISC-V based single core
    ESP32C3,
    /// RISC-V based single core
    ESP32C6,
    /// RISC-V based single core
    ESP32H2,
    /// Xtensa LX7 based single core
    ESP32S2,
    /// Xtensa LX7 based dual core
    ESP32S3,
}

impl Target {
    /// Returns true if the target is a RISC-V based chip.
    pub fn is_riscv(&self) -> bool {
        !self.is_xtensa()
    }

    /// Returns true if the target is a Xtensa based chip.
    pub fn is_xtensa(&self) -> bool {
        matches!(self, Target::ESP32 | Target::ESP32S2 | Target::ESP32S3)
    }
}

/// Returns a vector of Chips from a comma or space separated string.
pub fn parse_targets(targets_str: &str) -> Result<HashSet<Target>, Error> {
    debug!("Parsing targets: {}", targets_str);

    let targets_str = targets_str.to_lowercase();
    let targets_str = targets_str.trim();

    let targets: HashSet<Target> = if targets_str.contains("all") {
        Target::iter().collect()
    } else {
        let mut targets = HashSet::new();
        for target in targets_str.split([',', ' ']) {
            targets.insert(
                Target::from_str(target).map_err(|_| Error::UnsupportedTarget(target.into()))?,
            );
        }

        targets
    };

    debug!("Parsed targets: {:?}", targets);
    Ok(targets)
}

#[cfg(test)]
mod tests {
    use crate::targets::{parse_targets, Target};
    use std::collections::HashSet;

    #[test]
    #[allow(unused_variables)]
    fn test_parse_targets() {
        let targets: HashSet<Target> = [Target::ESP32].into_iter().collect();
        assert!(matches!(parse_targets("esp32"), Ok(targets)));
        let targets: HashSet<Target> = [Target::ESP32, Target::ESP32S2].into_iter().collect();
        assert!(matches!(parse_targets("esp32,esp32s2"), Ok(targets)));
        let targets: HashSet<Target> = [Target::ESP32S3, Target::ESP32].into_iter().collect();
        assert!(matches!(parse_targets("esp32s3 esp32"), Ok(targets)));
        let targets: HashSet<Target> = [Target::ESP32S3, Target::ESP32, Target::ESP32C3]
            .into_iter()
            .collect();
        assert!(matches!(
            parse_targets("esp32s3,esp32,esp32c3"),
            Ok(targets)
        ));
        let targets: HashSet<Target> = [
            Target::ESP32,
            Target::ESP32C2,
            Target::ESP32C3,
            Target::ESP32C6,
            Target::ESP32H2,
            Target::ESP32S2,
            Target::ESP32S3,
        ]
        .into_iter()
        .collect();
        assert!(matches!(parse_targets("all"), Ok(targets)));
    }
}