weavatrix-scan 0.4.3

Deterministic, safe repository scanner for code intelligence
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

use crate::report::FileIdentity;
use std::io;
use std::path::Path;

pub(crate) fn identity() -> Option<FileIdentity> {
    platform_stdout_identity()
}

pub(crate) fn path_matches(path: &Path, expected: FileIdentity) -> io::Result<bool> {
    platform_path_identity(path).map(|actual| actual == Some(expected))
}

#[cfg(unix)]
fn platform_stdout_identity() -> Option<FileIdentity> {
    use std::os::fd::AsFd as _;

    let stdout = std::io::stdout();
    let descriptor = stdout.as_fd().try_clone_to_owned().ok()?;
    let metadata = std::fs::File::from(descriptor).metadata().ok()?;
    if !metadata.is_file() {
        return None;
    }
    metadata_identity(&metadata)
}

#[cfg(unix)]
fn platform_path_identity(path: &Path) -> io::Result<Option<FileIdentity>> {
    std::fs::metadata(path).map(|metadata| metadata_identity(&metadata))
}

#[cfg(unix)]
#[expect(
    clippy::unnecessary_wraps,
    reason = "the target-specific helpers intentionally share one portable return shape"
)]
fn metadata_identity(metadata: &std::fs::Metadata) -> Option<FileIdentity> {
    use std::os::unix::fs::MetadataExt as _;
    Some(FileIdentity {
        file_system: metadata.dev(),
        file: metadata.ino(),
    })
}

#[cfg(windows)]
fn platform_stdout_identity() -> Option<FileIdentity> {
    let handle = winapi_util::HandleRef::stdout();
    if !winapi_util::file::typ(&handle).ok()?.is_disk() {
        return None;
    }
    let information = winapi_util::file::information(&handle).ok()?;
    Some(FileIdentity {
        file_system: information.volume_serial_number(),
        file: information.file_index(),
    })
}

#[cfg(windows)]
fn platform_path_identity(path: &Path) -> io::Result<Option<FileIdentity>> {
    let handle = winapi_util::Handle::from_path(path)?;
    let information = winapi_util::file::information(&handle)?;
    Ok(Some(FileIdentity {
        file_system: information.volume_serial_number(),
        file: information.file_index(),
    }))
}

#[cfg(not(any(unix, windows)))]
const fn platform_stdout_identity() -> Option<FileIdentity> {
    None
}

#[cfg(not(any(unix, windows)))]
fn platform_path_identity(_path: &Path) -> io::Result<Option<FileIdentity>> {
    Ok(None)
}