Clippy lint · Restriction · checked with Clippy 0.1.99

clippy::mod_module_files: Checks that module layout uses only self named module files; bans mod.rs files

What it meansChecks that module layout uses only self named module files; bans mod.rs files. It is in the restriction group and off by default.

Does it matter?

Having multiple module layout styles in a project can be confusing.

Lints that forbid language features for specific codebases (no unwrap, no indexing...). Off by default; pick them one by one, never the whole group.

How to fix it

Clippy does not fix this one automatically. Change the code by hand:

Turn it off, or on

It is off by default. To use it, set it to warn or deny:

Whole crate (Cargo.toml)

[lints.clippy]
mod_module_files = "warn"

In code

#![warn(clippy::mod_module_files)]

One run

cargo clippy -- -W clippy::mod-module-files

The [lints] table needs Rust 1.74 or newer. In a workspace, put it under [workspace.lints.clippy] and add [lints] workspace = true to each member.

Restrictiongroup

allowdefault level

nofixed by cargo clippy --fix

1.57.0added in Rust

Clippy's own documentation

What it does

Checks that module layout uses only self named module files; bans mod.rs files.

Why restrict this?

Having multiple module layout styles in a project can be confusing.

Example

src/
  stuff/
    stuff_files.rs
    mod.rs
  lib.rs

Use instead:

src/
  stuff/
    stuff_files.rs
  stuff.rs
  lib.rs

From the Clippy lint list (0.1.99), part of the Rust project, MIT or Apache-2.0. Official entry.

Up next

Also worth your time

Did this answer your question?