weavatrix-rust 2.11.0

Protocol-independent Rust repository intelligence: typed evidence graphs for impact, architecture, APIs, Git, search, and memory
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

//! What an import specifier is evidence of when no indexed file matches it.

use super::PendingImport;
use super::paths::clean_specifier;
use crate::language::Language;
use std::path::Path;

pub(super) enum SpecifierClass {
    /// A repository path that should have matched an indexed file.
    Local,
    /// A bare name a package manager provides.
    Package,
    /// A URL, scheme reference, or non-indexed local asset such as an image.
    Asset,
}

/// File extensions the graph never indexes as source. A reference to one is a
/// local asset, so its absence from the file index proves nothing.
const ASSET_EXTENSIONS: &[&str] = &[
    "avif",
    "bmp",
    "eot",
    "flac",
    "gif",
    "gz",
    "ico",
    "jpeg",
    "jpg",
    "map",
    "mp3",
    "mp4",
    "ogg",
    "otf",
    "pdf",
    "png",
    "svg",
    "tiff",
    "ttf",
    "wasm",
    "wav",
    "webm",
    "webmanifest",
    "webp",
    "woff",
    "woff2",
    "zip",
];

pub(super) fn classify_specifier(item: &PendingImport) -> SpecifierClass {
    let target = clean_specifier(&item.import.target);
    if target.is_empty()
        || target.contains("://")
        || target.starts_with("//")
        || target.starts_with("data:")
        || target.starts_with("mailto:")
        || target.starts_with("tel:")
    {
        return SpecifierClass::Asset;
    }
    let path_shaped = match item.language {
        // Relative, rooted, alias and subpath-import forms address repository
        // files; everything else names an installable package.
        Language::JavaScript | Language::TypeScript => {
            target.starts_with('.') || target.starts_with('/') || target.starts_with('#')
        }
        // Markup and style specifiers are always paths: there is no package
        // manager that `<script src>` or `@import "x.css"` could name.
        _ if matches!(item.language.as_str(), "html" | "css") => true,
        _ => return SpecifierClass::Package,
    };
    if !path_shaped {
        return SpecifierClass::Package;
    }
    let is_asset = Path::new(&target)
        .extension()
        .and_then(|value| value.to_str())
        .is_some_and(|extension| {
            ASSET_EXTENSIONS
                .iter()
                .any(|known| extension.eq_ignore_ascii_case(known))
        });
    if is_asset {
        SpecifierClass::Asset
    } else {
        SpecifierClass::Local
    }
}