rustqual 1.2.2

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

//! Port: extract suppression directives from source files.

use crate::domain::{SourceUnit, Suppression};

/// Parses `qual:allow(...)` comments (and legacy `iosp:allow`) from a
/// `SourceUnit` into Domain `Suppression` values.
pub trait SuppressionParser: Send + Sync {
    /// Parse all suppressions from one source unit.
    ///
    /// Returns an empty Vec if the file contains none — not an error.
    fn parse(&self, unit: &SourceUnit) -> Result<Vec<Suppression>, SuppressionParseError>;
}

/// Errors a `SuppressionParser` may report.
#[derive(Debug, thiserror::Error)]
pub enum SuppressionParseError {
    #[error("malformed suppression at {file}:{line}: {message}")]
    Malformed {
        file: String,
        line: usize,
        message: String,
    },
    #[error("unknown dimension referenced at {file}:{line}: {dimension}")]
    UnknownDimension {
        file: String,
        line: usize,
        dimension: String,
    },
}