opendev-tools-symbol 0.1.4

Symbol operations for OpenDev: find, references, rename, and replace body via LSP
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

//! Shared utilities for symbol tools.

use std::path::Path;

/// Validate that a string is a valid identifier (letter/underscore start, alphanumeric/underscore rest).
pub fn is_valid_identifier(name: &str) -> bool {
    if name.is_empty() {
        return false;
    }
    let mut chars = name.chars();
    let first = chars.next().unwrap();
    if !first.is_alphabetic() && first != '_' {
        return false;
    }
    chars.all(|c| c.is_alphanumeric() || c == '_')
}

/// Detect file language category from extension.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum LangCategory {
    Python,
    CLike,
    Other,
}

#[allow(dead_code)]
pub fn detect_lang(path: &Path) -> LangCategory {
    match path.extension().and_then(|e| e.to_str()) {
        Some("py" | "pyi" | "pyw") => LangCategory::Python,
        Some(
            "c" | "cpp" | "cc" | "cxx" | "h" | "hpp" | "java" | "js" | "ts" | "tsx" | "jsx" | "go"
            | "rs" | "cs" | "swift" | "kt" | "scala" | "m" | "mm",
        ) => LangCategory::CLike,
        _ => LangCategory::Other,
    }
}

/// Truncate a string to max chars, appending "..." if truncated.
pub fn truncate(s: &str, max: usize) -> String {
    if s.len() <= max {
        s.to_string()
    } else {
        format!("{}...", &s[..max])
    }
}

/// Make a path relative to a base, falling back to absolute.
pub fn relative_display(path: &Path, base: &Path) -> String {
    path.strip_prefix(base)
        .map(|p| p.display().to_string())
        .unwrap_or_else(|_| path.display().to_string())
}

#[cfg(test)]
#[path = "util_tests.rs"]
mod tests;