alef 0.83.0

Opinionated polyglot binding generator for Rust libraries
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

//! The set of languages a crate's coordinates are actually consumed by.

use super::ResolvedCrateConfig;
use crate::core::config::extras::Language;

impl ResolvedCrateConfig {
    /// Binding languages plus every language selected by full-suite or snippet e2e generation.
    ///
    /// ~keep Coordinate validation must key off this rather than `languages`: an e2e or snippet
    /// target can introduce a language that is absent from the binding list, and that target
    /// still consumes the crate's package coordinates. Validating only `languages` would leave
    /// those coordinates unchecked.
    #[must_use]
    pub(crate) fn effective_languages(&self) -> Vec<Language> {
        let mut languages = self.languages.clone();
        let Some(e2e) = self.e2e.as_ref() else {
            return languages;
        };

        let mut target_names = if e2e.languages.is_empty() {
            crate::e2e::default_e2e_languages(&self.languages)
        } else {
            e2e.languages.clone()
        };
        if let Some(snippets) = &e2e.snippets {
            target_names.extend(snippets.languages.iter().cloned());
        }

        for target_name in target_names {
            let Some(language) = Language::ALL
                .into_iter()
                .find(|language| language.to_string() == target_name)
            else {
                continue;
            };
            if !languages.contains(&language) {
                languages.push(language);
            }
        }
        languages
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::core::config::NewAlefConfig;

    #[test]
    fn effective_languages_deduplicate_binding_e2e_and_snippet_selections() {
        let config: NewAlefConfig = toml::from_str(
            r#"
[workspace]
languages = ["python", "dart"]

[[crates]]
name = "sample-core"
sources = ["src/lib.rs"]

[crates.e2e]
languages = ["dart", "swift"]
[crates.e2e.call]
function = "test"
[crates.e2e.snippets]
output = "docs/snippets-generated"
languages = ["dart", "swift"]
"#,
        )
        .unwrap();
        let resolved = config.resolve().expect("valid coordinates must resolve");
        assert_eq!(
            resolved[0].effective_languages(),
            vec![Language::Python, Language::Dart, Language::Swift]
        );
    }
}