Crate rustc_lint

Expand description

Lints, aka compiler warnings.

A ‘lint’ check is a kind of miscellaneous constraint that a user might want to enforce, but might reasonably want to permit as well, on a module-by-module basis. They contrast with static constraints enforced by other phases of the compiler, which are generally required to hold in order to compile the program at all.

Most lints can be written as LintPass instances. These run after all other analyses. The LintPasses built into rustc are defined within rustc_session::lint::builtin, which has further comments on how to add such a lint. rustc can also load user-defined lint plugins via the plugin mechanism.

Some of rustc’s lints are defined elsewhere in the compiler and work by calling add_lint() on the overall Session object. This works when it happens before the main lint pass, which emits the lints stored by add_lint(). To emit lints after the main lint pass (from codegen, for example) requires more effort. See emit_lint and GatherNodeLevels in context.rs.

Some code also exists in rustc_session::lint, rustc_middle::lint.

Note

This API is completely unstable and subject to change.

Re-exports

pub use builtin::SoftLints;

pub use rustc_session::lint::Level::*;

Modules

array_into_iter 🔒

builtin

Lints in the Rust compiler.

context 🔒

Implementation of lint checking.

deref_into_dyn_supertrait 🔒

early 🔒

Implementation of lint checking.

enum_intrinsics_non_enums 🔒

errors 🔒

expect 🔒

for_loops_over_fallibles 🔒

hidden_unicode_codepoints

internal 🔒

Some lints that are only useful in the compiler or crates that use compiler internals, such as Clippy.

late 🔒

Implementation of lint checking.

let_underscore 🔒

levels 🔒

methods 🔒

non_ascii_idents 🔒

non_fmt_panic 🔒

nonstandard_style 🔒

noop_method_call 🔒

opaque_hidden_inferred_bound 🔒

pass_by_value 🔒

passes 🔒

redundant_semicolon 🔒

traits 🔒

types 🔒

unused 🔒

Macros

declare_combined_early_lint_pass

Combines multiple lints passes into a single lint pass, at compile time, for maximum speed. Each check_foo method in $methods within this pass simply calls check_foo once per $pass. Compare with EarlyLintPassObjects, which is similar, but combines lint passes at runtime.

declare_combined_late_lint_pass

Combines multiple lints passes into a single lint pass, at compile time, for maximum speed. Each check_foo method in $methods within this pass simply calls check_foo once per $pass. Compare with LateLintPassObjects, which is similar, but combines lint passes at runtime.

early_lint_methods

expand_combined_early_lint_pass_method

expand_combined_early_lint_pass_methods

expand_combined_late_lint_pass_method

expand_combined_late_lint_pass_methods

late_lint_methods