nu_protocol/errors/
shell_warning.rs

1#![allow(unused_assignments)]
2use crate::Span;
3use miette::Diagnostic;
4use std::hash::Hash;
5use thiserror::Error;
6
7use crate::{ConfigWarning, ReportMode, Reportable};
8
9#[derive(Clone, Debug, Error, Diagnostic)]
10#[diagnostic(severity(Warning))]
11pub enum ShellWarning {
12    /// A parse-time deprecation. Indicates that something will be removed in a future release.
13    ///
14    /// Use [`ParseWarning::Deprecated`](crate::ParseWarning::Deprecated) if this is a deprecation
15    /// which is detectable at parse-time.
16    #[error("{dep_type} deprecated.")]
17    #[diagnostic(code(nu::shell::deprecated))]
18    Deprecated {
19        dep_type: String,
20        label: String,
21        #[label("{label}")]
22        span: Span,
23        #[help]
24        help: Option<String>,
25        report_mode: ReportMode,
26    },
27    /// Warnings reported while updating the config
28    #[error("Encountered {} warnings(s) when updating config", warnings.len())]
29    #[diagnostic(code(nu::shell::invalid_config))]
30    InvalidConfig {
31        #[related]
32        warnings: Vec<ConfigWarning>,
33    },
34    /// The interactive last-result value was truncated to fit `max_last_result_size`.
35    ///
36    /// Once-per-store is controlled by a stack flag; use [`ReportMode::EveryUse`] so the
37    /// engine report log does not permanently suppress later truncations at the same limit.
38    #[error(
39        "Last result was truncated to fit $env.config.max_last_result_size ({limit_bytes} bytes by Value::memory_size)."
40    )]
41    #[diagnostic(code(nu::shell::last_result_truncated))]
42    LastResultTruncated {
43        /// Access site span (not used as a source label — truncation is a state warning).
44        span: Span,
45        limit_bytes: usize,
46        #[help]
47        help: Option<String>,
48        report_mode: ReportMode,
49    },
50}
51
52impl Reportable for ShellWarning {
53    fn report_mode(&self) -> ReportMode {
54        match self {
55            ShellWarning::Deprecated { report_mode, .. }
56            | ShellWarning::LastResultTruncated { report_mode, .. } => *report_mode,
57            ShellWarning::InvalidConfig { .. } => ReportMode::FirstUse,
58        }
59    }
60}
61
62// To keep track of reported warnings
63impl Hash for ShellWarning {
64    fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
65        match self {
66            ShellWarning::Deprecated {
67                dep_type, label, ..
68            } => {
69                dep_type.hash(state);
70                label.hash(state);
71            }
72            // We always report config warnings, so no hash necessary
73            ShellWarning::InvalidConfig { .. } => (),
74            // EveryUse — hash unused for suppression; include fields for completeness
75            ShellWarning::LastResultTruncated { limit_bytes, .. } => {
76                limit_bytes.hash(state);
77            }
78        }
79    }
80}
nu_protocol/errors/shell_warning.rs

nu_protocol/errors/
shell_warning.rs
