a3s-code-core 5.2.7

A3S Code Core - Embeddable AI agent library with tool execution
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! Shared programming-language identification.

use std::path::Path;

/// Stateless catalog for the language identifiers used across the crate.
pub(crate) struct LanguageCatalog;

impl LanguageCatalog {
    /// Return the language identifier associated with a path extension.
    ///
    /// Extension matching is intentionally case-sensitive to preserve the
    /// workspace manifest's existing classification behavior.
    pub(crate) fn id_for_path(path: &Path) -> Option<&'static str> {
        match path.extension().and_then(|ext| ext.to_str())? {
            "rs" => Some("rust"),
            "toml" => Some("toml"),
            "hcl" => Some("hcl"),
            "js" | "mjs" | "cjs" => Some("javascript"),
            "jsx" => Some("javascript-react"),
            "ts" | "mts" | "cts" => Some("typescript"),
            "tsx" => Some("typescript-react"),
            "json" => Some("json"),
            "md" | "mdx" => Some("markdown"),
            "py" => Some("python"),
            "go" => Some("go"),
            "java" => Some("java"),
            "kt" | "kts" => Some("kotlin"),
            "swift" => Some("swift"),
            "c" | "h" => Some("c"),
            "cc" | "cpp" | "cxx" | "hpp" => Some("cpp"),
            "cs" => Some("csharp"),
            "rb" => Some("ruby"),
            "php" => Some("php"),
            "sh" | "bash" | "zsh" => Some("shell"),
            "yml" | "yaml" => Some("yaml"),
            "html" | "htm" => Some("html"),
            "css" => Some("css"),
            "scss" | "sass" => Some("scss"),
            "sql" => Some("sql"),
            "xml" => Some("xml"),
            _ => None,
        }
    }
}

#[cfg(test)]
mod tests {
    use super::LanguageCatalog;
    use std::path::Path;

    #[test]
    fn preserves_all_manifest_language_identifiers_and_aliases() {
        let cases = [
            ("main.rs", "rust"),
            ("Cargo.toml", "toml"),
            ("agent.hcl", "hcl"),
            ("index.js", "javascript"),
            ("index.mjs", "javascript"),
            ("index.cjs", "javascript"),
            ("view.jsx", "javascript-react"),
            ("index.ts", "typescript"),
            ("index.mts", "typescript"),
            ("index.cts", "typescript"),
            ("view.tsx", "typescript-react"),
            ("data.json", "json"),
            ("README.md", "markdown"),
            ("guide.mdx", "markdown"),
            ("main.py", "python"),
            ("main.go", "go"),
            ("Main.java", "java"),
            ("Main.kt", "kotlin"),
            ("build.kts", "kotlin"),
            ("main.swift", "swift"),
            ("main.c", "c"),
            ("main.h", "c"),
            ("main.cc", "cpp"),
            ("main.cpp", "cpp"),
            ("main.cxx", "cpp"),
            ("main.hpp", "cpp"),
            ("Main.cs", "csharp"),
            ("main.rb", "ruby"),
            ("index.php", "php"),
            ("run.sh", "shell"),
            ("run.bash", "shell"),
            ("run.zsh", "shell"),
            ("config.yml", "yaml"),
            ("config.yaml", "yaml"),
            ("index.html", "html"),
            ("index.htm", "html"),
            ("style.css", "css"),
            ("style.scss", "scss"),
            ("style.sass", "scss"),
            ("schema.sql", "sql"),
            ("document.xml", "xml"),
        ];

        for (path, expected) in cases {
            assert_eq!(
                LanguageCatalog::id_for_path(Path::new(path)),
                Some(expected),
                "unexpected language for {path}"
            );
        }
    }

    #[test]
    fn keeps_extension_matching_case_sensitive() {
        assert_eq!(LanguageCatalog::id_for_path(Path::new("main.RS")), None);
        assert_eq!(LanguageCatalog::id_for_path(Path::new("README")), None);
        assert_eq!(LanguageCatalog::id_for_path(Path::new("archive.zip")), None);
    }
}