Struct Config 

pub struct Config {

    pub languages: HashSet<String>,
    pub includes: Vec<String>,
    pub excludes: Vec<String>,
    pub max_complexity: Option<u32>,
    pub preset: Option<String>,
    pub verbose: Option<bool>,
    pub source: Option<SourceConfig>,
    pub language_overrides: LanguageOverrides,
    pub plugins: Option<PluginConfig>,
    pub plugin_auto_sync: Option<AutoSyncConfig>,
    pub self_auto_update: Option<SelfUpdateConfig>,
    pub tool_auto_install: Option<ToolAutoInstallConfig>,
    pub performance: PerformanceConfig,
    pub hook: HookConfig,
    pub cmsg: CmsgConfig,
    pub rules: RulesConfig,
    pub ai: AiConfig,
    pub review: ReviewConfig,
    pub retention: RetentionConfig,
    pub checks: ChecksConfig,
}

Main configuration structure for linthis.

Contains all configuration options for controlling lint behavior, formatting, language-specific settings, and plugin configuration.

Example

use linthis::config::Config;
use std::path::Path;

// Load from project directory
let config = Config::load_merged(Path::new("."));

// Access configuration values
println!("Max complexity: {:?}", config.max_complexity);
println!("Excluded patterns: {:?}", config.excludes);

Fields

languages: HashSet<String>

Languages to check (empty = auto-detect)

includes: Vec<String>

Paths/patterns to include (glob patterns)

excludes: Vec<String>

Paths/patterns to exclude (glob patterns)

max_complexity: Option<u32>

Maximum cyclomatic complexity allowed

preset: Option<String>

Format preset to use (google, standard, airbnb)

verbose: Option<bool>

Verbose output

source: Option<SourceConfig>

Source configuration (compatible with CodeCC .code.yml)

language_overrides: LanguageOverrides

Language-specific overrides (flattened to root level)

plugins: Option<PluginConfig>

Plugin configuration

plugin_auto_sync: Option<AutoSyncConfig>

Plugin auto-sync configuration

self_auto_update: Option<SelfUpdateConfig>

Self auto-update configuration

tool_auto_install: Option<ToolAutoInstallConfig>

Tool auto-install configuration

performance: PerformanceConfig

Performance settings

hook: HookConfig

Hook settings

cmsg: CmsgConfig

Commit message validation settings

rules: RulesConfig

Custom rules, rule disable, and severity overrides

ai: AiConfig

AI configuration for fix suggestions

review: ReviewConfig

Code review settings

retention: RetentionConfig

Retention settings for results, backups, reviews, and cache

checks: ChecksConfig

Checks configuration: which checks to run and per-check settings.

[checks]
run = ["lint"]                    # default: only lint
# run = ["lint", "security", "complexity"]  # enable all

[checks.security]
scan_type = "sast"
fail_on = "high"

[checks.complexity]
threshold = 15

Implementations

impl Config

pub fn new() -> Self

Create a new empty configuration

pub fn load(path: &Path) -> Result<Self>

Load configuration from a file

pub fn built_in_defaults() -> Self

Load built-in default configuration

pub fn load_user_config() -> Option<Self>

Load user-level configuration from ~/.linthis/config.toml

pub fn load_project_config(start_dir: &Path) -> Option<Self>

Load project-level configuration from the given directory Searches for .linthis/config.toml in the start directory and parent directories

pub fn merge(&mut self, other: Config)

Merge another configuration into this one. Values from other override values in self.

pub fn get_plugin_sources(&self) -> Vec<PluginSource>

Get plugin sources from config, converting to PluginSource type

pub fn load_merged(project_dir: &Path) -> Self

Load and merge configuration from all sources with proper precedence.

Priority chain (lowest to highest): built-in defaults → global plugin linthis.toml (from plugins in ~/.linthis/config.toml) → project plugin linthis.toml (from plugins in .linthis/config.toml) → ~/.linthis/config.toml (user config — overrides plugin) → .linthis/config.toml (project config — highest)

pub fn get_active_config_paths(project_dir: &Path) -> Vec<PathBuf>

Return the ordered list of config file paths that are actually loaded by [load_merged], from lowest to highest priority.

Only paths that exist on disk are included. Built-in defaults have no file path and are therefore not listed.

pub fn generate_default_toml() -> String

Generate a default configuration file content

pub fn project_config_path(project_dir: &Path) -> PathBuf

Get the path for a new project config file

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.