pedant-core 0.20.2

Analysis engine for pedant: IR extraction, style checks, and capability detection
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

//! Lexical root-relative path normalization shared by resolution adapters.

use std::path::Path;

/// Why a path has no UTF-8 representation relative to the requested root.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) enum RelativePathError {
    /// The path does not begin with the root's lexical components.
    OutsideRoot,
    /// A relative component has no UTF-8 representation.
    NonUtf8,
}

/// Render `path` beneath `root` as lexical, `/`-separated UTF-8 text.
pub(crate) fn relative_text(root: &Path, path: &Path) -> Result<Box<str>, RelativePathError> {
    let relative = path
        .strip_prefix(root)
        .map_err(|_| RelativePathError::OutsideRoot)?;
    let mut text = String::new();
    for component in relative.components() {
        let segment = component
            .as_os_str()
            .to_str()
            .ok_or(RelativePathError::NonUtf8)?;
        push_segment(&mut text, segment);
    }
    Ok(text.into_boxed_str())
}

fn push_segment(text: &mut String, segment: &str) {
    match text.is_empty() {
        true => text.push_str(segment),
        false => {
            text.push('/');
            text.push_str(segment);
        }
    }
}