rustqual 1.0.0

Comprehensive Rust code quality analyzer — seven dimensions: IOSP, Complexity, DRY, SRP, Coupling, Test Quality, Architecture
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

//! Contract tests for the `SourceLoader` port.
//!
//! These tests verify the port's *shape*: object-safety, Send + Sync
//! supertraits, and the semantic error set. Concrete loader impls live
//! in adapters and carry their own behaviour tests.

use crate::domain::SourceUnit;
use crate::ports::{LoadError, SourceLoader};
use std::path::{Path, PathBuf};

/// Trivial fake loader: returns what it was constructed with.
struct FakeLoader {
    units: Vec<SourceUnit>,
}

impl SourceLoader for FakeLoader {
    fn load(&self, _root: &Path) -> Result<Vec<SourceUnit>, LoadError> {
        Ok(self.units.clone())
    }
}

#[test]
fn port_is_object_safe() {
    // If `dyn SourceLoader` compiles, the trait is object-safe.
    let fake = FakeLoader { units: vec![] };
    let _boxed: Box<dyn SourceLoader> = Box::new(fake);
}

#[test]
fn port_requires_send_and_sync() {
    // Compile-time assertion via trait-object coercion: if FakeLoader is
    // not Send + Sync, this line does not compile.
    let _: Box<dyn Send + Sync> = Box::new(FakeLoader { units: vec![] });
}

#[test]
fn fake_loader_returns_injected_units() {
    let units = vec![
        SourceUnit::new(PathBuf::from("a.rs"), "fn a() {}".into()),
        SourceUnit::new(PathBuf::from("b.rs"), "fn b() {}".into()),
    ];
    let loader = FakeLoader {
        units: units.clone(),
    };
    let loaded = loader.load(Path::new("/ignored")).unwrap();
    assert_eq!(loaded, units);
}

#[test]
fn load_error_variants_carry_diagnostic_information() {
    let e = LoadError::RootNotFound(PathBuf::from("/nowhere"));
    assert!(e.to_string().contains("/nowhere"));

    let e = LoadError::Io {
        path: PathBuf::from("/a.rs"),
        message: "disk full".into(),
    };
    assert!(e.to_string().contains("/a.rs"));
    assert!(e.to_string().contains("disk full"));

    let e = LoadError::DecodeError {
        path: PathBuf::from("/b.rs"),
        message: "invalid byte".into(),
    };
    assert!(e.to_string().contains("invalid byte"));

    let e = LoadError::Refused("not a workspace".into());
    assert!(e.to_string().contains("not a workspace"));
}