cargo-caps 0.0.2

Audit what a crate is capable of by analyzing what linker symbols it emits
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

use std::ops::Deref;

/// Always normalized to `snake_case` (NEVER `kebab-case`).
#[derive(Clone, PartialEq, Eq, Hash, PartialOrd, Ord)]
pub struct CrateName(String);

impl CrateName {
    pub fn new(name: impl Into<String>) -> anyhow::Result<Self> {
        let name = name.into();
        if name.is_empty() {
            anyhow::bail!("Crate name cannot be empty");
        }

        let normalized = name.replace('-', "_");

        // Basic validation for valid Rust identifier characters
        if !normalized
            .chars()
            .all(|c| c.is_ascii_alphanumeric() || c == '_')
        {
            anyhow::bail!("Invalid crate name: '{name}' contains invalid characters");
        }

        if normalized.starts_with(|c: char| c.is_ascii_digit()) {
            anyhow::bail!("Invalid crate name: '{name}' cannot start with a digit");
        }

        Ok(Self(normalized))
    }

    pub fn is_standard_crate(&self) -> bool {
        matches!(self.0.as_str(), "alloc" | "core" | "std")
    }
}

impl std::fmt::Debug for CrateName {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.0)
    }
}

impl std::fmt::Display for CrateName {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.0)
    }
}

impl AsRef<str> for CrateName {
    fn as_ref(&self) -> &str {
        &self.0
    }
}

impl Deref for CrateName {
    type Target = String;

    fn deref(&self) -> &Self::Target {
        &self.0
    }
}