perl-diagnostics 0.13.2

Unified diagnostic codes, types, and catalog for Perl LSP.
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

//! Diagnostic types: Diagnostic and RelatedInformation.
//!
//! This module contains the diagnostic message types used by LSP.
//!
//! Type unification: `DiagnosticSeverity` and `DiagnosticTag` are re-exported
//! from the `codes` module, ensuring a single canonical type that can be used
//! from either module path.

// Unified types — canonical definitions are in codes module
pub use crate::codes::{DiagnosticSeverity, DiagnosticTag};

/// A diagnostic message with location and metadata.
#[derive(Debug, Clone, Default, PartialEq, Eq)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct Diagnostic {
    /// The diagnostic code (e.g., PL001).
    pub code: crate::codes::DiagnosticCode,
    /// Severity level.
    pub severity: DiagnosticSeverity,
    /// Location of the diagnostic.
    pub range: (usize, usize),
    /// The message text.
    pub message: String,
    /// Optional related information.
    pub related_information: Option<Vec<RelatedInformation>>,
    /// Optional tags (Unnecessary, Deprecated, etc.).
    pub tags: Option<Vec<DiagnosticTag>>,
}

/// Information related to a diagnostic.
#[derive(Debug, Clone, Default, PartialEq, Eq)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct RelatedInformation {
    /// The message text.
    pub message: String,
    /// Location of the related information.
    pub location: (usize, usize),
}