perl-module 0.16.0

Perl module resolution, import analysis, and refactoring — unified facade
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

use perl_module::resolution::path::resolve_module_path;
use std::path::PathBuf;

fn next_u64(state: &mut u64) -> u64 {
    *state ^= *state >> 12;
    *state ^= *state << 25;
    *state ^= *state >> 27;
    state.wrapping_mul(0x2545F4914F6CDD1D)
}

fn fuzz_segment(state: &mut u64, max_len: usize) -> String {
    let len = (next_u64(state) as usize % max_len).saturating_add(1);
    let mut out = String::with_capacity(len);
    for _ in 0..len {
        let byte = (next_u64(state) & 0x7F) as u8;
        let ch = match byte {
            0..=31 => b'a' + byte % 26,
            b':' | b'/' | b'\\' => b'x',
            _ => byte,
        } as char;
        out.push(ch);
    }
    out
}

fn fuzz_module_segment(state: &mut u64, max_len: usize) -> String {
    let len = (next_u64(state) as usize % max_len).saturating_add(1);
    let mut out = String::with_capacity(len);
    for _ in 0..len {
        let idx = (next_u64(state) % 63) as u8;
        let ch = match idx {
            0..=25 => (b'A' + idx) as char,
            26..=51 => (b'a' + (idx - 26)) as char,
            52..=61 => (b'0' + (idx - 52)) as char,
            _ => '_',
        };
        out.push(ch);
    }
    out
}

fn fuzz_include_path(state: &mut u64) -> String {
    let mode = next_u64(state) % 8;
    match mode {
        0 => ".".to_string(),
        1 => "..".to_string(),
        2 => format!("../{}", fuzz_segment(state, 10)),
        3 => format!("./{}", fuzz_segment(state, 10)),
        4 => format!("{}/../{}", fuzz_segment(state, 8), fuzz_segment(state, 8)),
        5 => format!("{}//{}", fuzz_segment(state, 8), fuzz_segment(state, 8)),
        6 => format!("\\{}\\{}", fuzz_segment(state, 8), fuzz_segment(state, 8)),
        _ => fuzz_segment(state, 12),
    }
}

#[test]
fn fuzz_inputs_never_panic_and_return_root_prefixed_path() {
    let mut seed = 0xC0FFEE_u64;
    let root = PathBuf::from("/workspace");

    for _ in 0..2000 {
        let module = format!(
            "{}::{}",
            fuzz_module_segment(&mut seed, 12),
            fuzz_module_segment(&mut seed, 12),
        );

        // Include path generation intentionally covers traversal-like and odd separator inputs
        // to exercise workspace path-security validation in resolution.
        let include_paths: Vec<String> = (0..4).map(|_| fuzz_include_path(&mut seed)).collect();

        let resolved = resolve_module_path(&root, &module, &include_paths);

        assert!(resolved.is_some(), "resolver unexpectedly returned None");

        if let Some(resolved) = resolved {
            assert!(resolved.to_string_lossy().ends_with(".pm"));
            assert!(
                resolved.starts_with(&root),
                "resolved path escaped workspace root: {}",
                resolved.display()
            );
        }
    }
}