clippy.toml

# Allow unwrap/expect/panic in test code — production code is restricted via lints
allow-expect-in-tests = true
allow-panic-in-tests = true
allow-unwrap-in-tests = true

# Panic safety — force explicit error handling
disallowed-macros = [
    { path = "std::unimplemented", reason = "Use a proper error type or todo! only in stubs that must not reach production" },
    { path = "std::todo", reason = "Remove all todo! before merging to main" },
]

disallowed-methods = [
    { path = "std::process::exit", reason = "Verify that it's okay to shut down the entire process without our normal shutdown logic" },
]

# Cognitive complexity limit — keeps logic reviewable
cognitive-complexity-threshold = 25

# Type complexity — flag deeply nested generics
type-complexity-threshold = 250

# Enforce API discipline during refactors
avoid-breaking-exported-api = false

# Warn on paths with 4+ segments — encourages use statements over deep inline paths
absolute-paths-max-segments = 3