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
39
40
41
42

//! Proof-only access to resolution invariants ordinary callers cannot reach.

use std::path::Path;

use super::identity::TargetId;
use super::project::RustProject;

/// Proof-facing form of a lexical relative-path normalization failure.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum RelativePathNormalizationError {
    /// The path does not begin with the root's lexical components.
    OutsideRoot,
    /// A relative component has no UTF-8 representation.
    NonUtf8,
}

/// Exercise the crate-private lexical path authority without widening the
/// ordinary resolution surface.
pub fn normalize_relative_path(
    root: &Path,
    path: &Path,
) -> Result<Box<str>, RelativePathNormalizationError> {
    super::super::path_normalization::relative_text(root, path).map_err(|error| match error {
        super::super::path_normalization::RelativePathError::OutsideRoot => {
            RelativePathNormalizationError::OutsideRoot
        }
        super::super::path_normalization::RelativePathError::NonUtf8 => {
            RelativePathNormalizationError::NonUtf8
        }
    })
}

/// A defensively invalid target identity: this project's authority with a local
/// index past every target it issued.
///
/// `RustSnapshotError::UnknownTarget` guards an invariant the safe public API
/// cannot break, so proving both snapshot operations refuse it needs a
/// construction path that only the proof feature compiles.
pub fn unknown_target_id(project: &RustProject) -> TargetId {
    let index = u32::try_from(project.targets().len()).unwrap_or(u32::MAX);
    TargetId::new(project.authority, index)
}