nu-lint 1.2.0

Linter for Nu shell scripts that helpfully suggests improvements
Documentation
mod ast;
pub mod cli;
mod config;
mod context;
mod dsl;
mod effect;
mod engine;
mod fix;
mod format;
mod format_conversions;
mod ignore;
pub mod log;
#[cfg(feature = "lsp")]
mod lsp;
mod rule;
mod rules;
mod span;
mod violation;

use std::{error::Error, fmt, io, path::PathBuf};

pub use config::{Config, LintLevel};
pub use engine::LintEngine;
pub use fix::apply_fixes_iteratively;
use toml::{de, ser};
use violation::{Fix, Replacement};

pub const NU_PARSER_VERSION: &str = env!("NU_PARSER_VERSION");

#[derive(Debug)]
pub enum LintError {
    Io {
        path: PathBuf,
        source: io::Error,
    },
    Config {
        source: de::Error,
    },
    ConfigSerialize {
        source: ser::Error,
    },
    RuleDoesNotExist {
        non_existing_id: String,
    },
    RuleConflict {
        rule_a: &'static str,
        rule_b: &'static str,
    },
    NoConfigLocation,
}

impl fmt::Display for LintError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::Io { path, source } => {
                write!(f, "failed to read '{}': {source}", path.display())
            }
            Self::RuleDoesNotExist { non_existing_id } => write!(
                f,
                "Rule declared in config with id `{non_existing_id}` does not exist in this \
                 version."
            ),
            Self::Config { source } => write!(f, "invalid configuration: {source}"),
            Self::ConfigSerialize { source } => {
                write!(f, "failed to serialize configuration: {source}")
            }
            Self::RuleConflict { rule_a, rule_b } => {
                write!(
                    f,
                    "Based on the defaults merged with any configuration file (if present), the \
                     following two rules are both enabled and conclicting: '{rule_a}' and \
                     '{rule_b}'. The linter will not be able to start until you make sure at most \
                     one of both is active. Use the configuration file to override the lint \
                     levels."
                )
            }
            Self::NoConfigLocation => {
                write!(f, "no workspace root or home directory available")
            }
        }
    }
}

impl Error for LintError {
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        match self {
            Self::Io { source, .. } => Some(source),
            Self::Config { source } => Some(source),
            Self::ConfigSerialize { source } => Some(source),
            Self::RuleConflict { .. } | Self::RuleDoesNotExist { .. } | Self::NoConfigLocation => {
                None
            }
        }
    }
}