cargo-cranky

I wish that I could check in a file that would specify various clippy lints for my entire Cargo workspace, and have that be applied to all the crates, libraries, binaries, and examples.

That's not possible with clippy, but it is possible with cranky!

cargo-cranky is just a wrapper around cargo-clippy; it examines your Cranky.toml config file, and constructs the necessary cargo-clippy command line.

For example, if Cranky.toml contains this:

toml warn = [ "empty_structs_with_brackets", "cast_possible_truncation", ]

and I run cargo cranky, I get those extra lints: txt warning: found empty brackets on struct declaration --> src/main.rs:11:12 | 11 | struct Unit {} | ^^^

txt warning: casting `u64` to `u8` may truncate the value --> src/main.rs:23:9 | 23 | x as u8

This is exactly the same as manually running cargo clippy with the extra parameters --warn clippy::empty_structs_with_brackets and --warn clippy::cast_possible_truncation.

You may find some useful clippy lints for your project in the clippy documentation. I recommend browsing the "pedantic" and "restriction" groups.

Installing

cargo install cargo-cranky

Configuring

Create a file called Cranky.toml at the top of your project tree. The file can contain keys allow, warn, or deny that contain an array of clippy lint names.

Example: ```toml warn = [ "emptystructswithbrackets", "castpossible_truncation", ]

allow = [ "double_comparisons", ]

deny = [ "needless_return", ] ```

FAQ

Does it work with vscode?

Yes! Just type cranky into the "Check On Save: Command" setting, or drop this into settings.json: txt { "rust-analyzer.checkOnSave.command": "cranky" }

Set it back to "check" (or "clippy") to return to the previous behavior.

Is this reckless or non-idiomatic?

That depends on how you use it. If your goal is to enforce a non-idiomatic coding style, that's probably not a great idea. Additionally, using allow to suppress clippy lints that are enabled by default is not recommended. Sometimes that kind of thing is necessary.

The main goal of this tool is to make it easier to enable additional clippy lints, that improve code maintainability or safety (i.e. cast_possible_truncation).

I have ~~complaints~~ suggestions!

Please file a GitHub issue if you have ideas that could make this tool better.