#check #tidy #ci #style #cargo

app cargo-tidy

Run easily configurable style checks on your project

1 unstable release

Uses old Rust 2015

0.1.0 Oct 12, 2016

#9 in #tidy

CC0 license

16KB
333 lines

Tidy up your project!

This is a small Cargo subcommand, cargo tidy, which allows you to configure various code style checks to be executed. You can then put it in CI to make sure that all PRs adhere to the rules.

An example configuration can be found in tidy-config.toml.

For example, tidy allows you to check:

  • That a line doesn't exceed a maximum line length
  • That a file only uses \n as line endings
  • That only spaces and no tabs are used for indentation

Installation

Tidy can be installed like any other crate:

cargo install cargo-tidy

CI Integration

The cargo tidy project itself uses cargo tidy to check its own code style!

Take a look at the .travis.yml to see how to run it for your own project.

Different languages, different rules

When working on a large-scale project which combines multiple programming languages, you might want to run multiple sets of style checks. Or maybe you just want different rules for .md files than for .rs files.

Since cargo tidy allows specifying custom file globs, you can write multiple configuration files for different file types (or folders).

Dependencies

~6MB
~114K SLoC