X-Git-Url: https://git.lizzy.rs/?a=blobdiff_plain;f=README.md;h=9dd41f6513c25882c9b42570c725ea3d9471ada9;hb=a16edf84ce17095ebeebccb5662441ef1c824905;hp=25dbeaedcba9ea48e74c64e68d96cfcc38e0fe08;hpb=dac5e2d3a5cb37351edd348f4ca55b52f71982ef;p=rust.git diff --git a/README.md b/README.md index 25dbeaedcba..9dd41f6513c 100644 --- a/README.md +++ b/README.md @@ -5,11 +5,11 @@ We are currently in the process of discussing Clippy 1.0 via the RFC process in [![Build Status](https://travis-ci.org/rust-lang-nursery/rust-clippy.svg?branch=master)](https://travis-ci.org/rust-lang-nursery/rust-clippy) [![Windows Build status](https://ci.appveyor.com/api/projects/status/id677xpw1dguo7iw?svg=true)](https://ci.appveyor.com/project/rust-lang-libs/rust-clippy) [![Current Version](https://meritbadge.herokuapp.com/clippy)](https://crates.io/crates/clippy) -[![License: MPL-2.0](https://img.shields.io/crates/l/clippy.svg)](#license) +[![License: MIT/Apache-2.0](https://img.shields.io/crates/l/clippy.svg)](#license) A collection of lints to catch common mistakes and improve your [Rust](https://github.com/rust-lang/rust) code. -[There are 275 lints included in this crate!](https://rust-lang-nursery.github.io/rust-clippy/master/index.html) +[There are 279 lints included in this crate!](https://rust-lang-nursery.github.io/rust-clippy/master/index.html) We have a bunch of lint categories to allow you to choose how much Clippy is supposed to ~~annoy~~ help you: @@ -64,6 +64,8 @@ rustup component add clippy-preview Now you can run Clippy by invoking `cargo clippy`. +If it says that it can't find the `clippy` subcommand, please run `rustup self update` + ### Running Clippy from the command line without installing it To have cargo compile your crate with Clippy without Clippy installation @@ -76,6 +78,27 @@ cargo run --bin cargo-clippy --manifest-path=path_to_clippys_Cargo.toml *[Note](https://github.com/rust-lang-nursery/rust-clippy/wiki#a-word-of-warning):* Be sure that Clippy was compiled with the same version of rustc that cargo invokes here! +### Travis CI + +You can add Clippy to Travis CI in the same way you use it locally: + +```yml +language: rust +rust: + - stable + - beta +before_script: + - rustup component add clippy-preview +script: + - cargo clippy + # if you want the build job to fail when encountering warnings, use + - cargo clippy -- -D warnings + # in order to also check tests and none-default crate features, use + - cargo clippy --all-targets --all-features -- -D warnings + - cargo test + # etc. +``` + ## Configuration Some lints can be configured in a TOML file named `clippy.toml` or `.clippy.toml`. It contains a basic `variable = value` mapping eg. @@ -122,7 +145,14 @@ enable/disable Clippy lints until `tool_lints` are stable: #![cfg_attr(feature = "cargo-clippy", allow(clippy_lint))] ``` +If you do not want to include your lint levels in your code, you can globally enable/disable lints by passing extra flags to clippy during the run: `cargo clippy -- -A lint_name` will run clippy with `lint_name` disabled and `cargo clippy -- -W lint_name` will run it with that enabled. On newer compilers you may need to use `clippy::lint_name` instead. + ## License -Licensed under [MPL](https://www.mozilla.org/MPL/2.0/). -If you're having issues with the license, let me know and I'll try to change it to something more permissive. +Copyright 2014-2018 The Rust Project Developers + +Licensed under the Apache License, Version 2.0 or the MIT license +, at your +option. All files in the project carrying such notice may not be +copied, modified, or distributed except according to those terms.