Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add assert(true) and assert(false) lints #3582

Merged
merged 9 commits into from
Jan 23, 2019
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -616,6 +616,7 @@ All notable changes to this project will be documented in this file.
[`absurd_extreme_comparisons`]: https://rust-lang.github.io/rust-clippy/master/index.html#absurd_extreme_comparisons
[`almost_swapped`]: https://rust-lang.github.io/rust-clippy/master/index.html#almost_swapped
[`approx_constant`]: https://rust-lang.github.io/rust-clippy/master/index.html#approx_constant
[`assertions_on_constants`]: https://rust-lang.github.io/rust-clippy/master/index.html#assertions_on_constants
[`assign_op_pattern`]: https://rust-lang.github.io/rust-clippy/master/index.html#assign_op_pattern
[`assign_ops`]: https://rust-lang.github.io/rust-clippy/master/index.html#assign_ops
[`bad_bit_mask`]: https://rust-lang.github.io/rust-clippy/master/index.html#bad_bit_mask
Expand Down Expand Up @@ -679,10 +680,8 @@ All notable changes to this project will be documented in this file.
[`expect_fun_call`]: https://rust-lang.github.io/rust-clippy/master/index.html#expect_fun_call
[`expl_impl_clone_on_copy`]: https://rust-lang.github.io/rust-clippy/master/index.html#expl_impl_clone_on_copy
[`explicit_counter_loop`]: https://rust-lang.github.io/rust-clippy/master/index.html#explicit_counter_loop
[`explicit_false`]: https://rust-lang.github.io/rust-clippy/master/index.html#explicit_false
[`explicit_into_iter_loop`]: https://rust-lang.github.io/rust-clippy/master/index.html#explicit_into_iter_loop
[`explicit_iter_loop`]: https://rust-lang.github.io/rust-clippy/master/index.html#explicit_iter_loop
[`explicit_true`]: https://rust-lang.github.io/rust-clippy/master/index.html#explicit_true
[`explicit_write`]: https://rust-lang.github.io/rust-clippy/master/index.html#explicit_write
[`extend_from_slice`]: https://rust-lang.github.io/rust-clippy/master/index.html#extend_from_slice
[`extra_unused_lifetimes`]: https://rust-lang.github.io/rust-clippy/master/index.html#extra_unused_lifetimes
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@
A collection of lints to catch common mistakes and improve your [Rust](https://github.com/rust-lang/rust) code.

<<<<<<< HEAD
[There are 290 lints included in this crate!](https://rust-lang.github.io/rust-clippy/master/index.html)
[There are 291 lints included in this crate!](https://rust-lang.github.io/rust-clippy/master/index.html)
||||||| merged common ancestors
[There are 291 lints included in this crate!](https://rust-lang.github.io/rust-clippy/master/index.html)
=======
[There are 293 lints included in this crate!](https://rust-lang.github.io/rust-clippy/master/index.html)
[There are 291 lints included in this crate!](https://rust-lang.github.io/rust-clippy/master/index.html)
>>>>>>> run ./util/dev update_lints

We have a bunch of lint categories to allow you to choose how much Clippy is supposed to ~~annoy~~ help you:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,50 +11,40 @@ use crate::rustc::hir::{Expr, ExprKind};
use crate::rustc::lint::{LateContext, LateLintPass, LintArray, LintPass};
use crate::rustc::{declare_tool_lint, lint_array};
use crate::syntax::ast::LitKind;
use crate::utils::{is_direct_expn_of, span_lint};
use crate::utils::{is_direct_expn_of, span_lint, span_lint_and_sugg};
use rustc_errors::Applicability;
use if_chain::if_chain;

/// **What it does:** Check explicit call assert!(true)
/// **What it does:** Check explicit call assert!(true/false)
///
/// **Why is this bad?** Will be optimized out by the compiler
///
/// **Known problems:** None
///
/// **Example:**
/// ```rust
/// assert!(true)
/// ```
declare_clippy_lint! {
pub EXPLICIT_TRUE,
correctness,
"assert!(true) will be optimized out by the compiler"
}

/// **What it does:** Check explicit call assert!(false)
///
/// **Why is this bad?** Should probably be replaced by a panic!() or unreachable!()
/// **Why is this bad?** Will be optimized out by the compiler or should probably be replaced by a panic!() or unreachable!()
///
/// **Known problems:** None
///
/// **Example:**
/// ```rust
/// assert!(false)
/// // or
/// assert!(true)
/// // or
/// const B: bool = false;
/// assert!(B)
/// ```
declare_clippy_lint! {
pub EXPLICIT_FALSE,
correctness,
"assert!(false) should probably be replaced by a panic!() or unreachable!()"
pub ASSERTIONS_ON_CONSTANTS,
style,
"assert!(true/false) will be optimized out by the compiler/should probably be replaced by a panic!() or unreachable!()"
}

pub struct AssertChecks;
pub struct AssertionsOnConstants;

impl LintPass for AssertChecks {
impl LintPass for AssertionsOnConstants {
fn get_lints(&self) -> LintArray {
lint_array![EXPLICIT_TRUE, EXPLICIT_FALSE]
lint_array![ASSERTIONS_ON_CONSTANTS]
}
}

impl<'a, 'tcx> LateLintPass<'a, 'tcx> for AssertChecks {
impl<'a, 'tcx> LateLintPass<'a, 'tcx> for AssertionsOnConstants {
fn check_expr(&mut self, cx: &LateContext<'a, 'tcx>, e: &'tcx Expr) {
if_chain! {
if is_direct_expn_of(e.span, "assert").is_some();
Expand All @@ -63,12 +53,18 @@ impl<'a, 'tcx> LateLintPass<'a, 'tcx> for AssertChecks {
then {
match inner.node {
LitKind::Bool(true) => {
span_lint(cx, EXPLICIT_TRUE, e.span,
span_lint(cx, ASSERTIONS_ON_CONSTANTS, e.span,
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The span_lint_and_sugg should work. The problem you had was in the assert(true) branch but you were still using span_lint there.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"assert!(true) will be optimized out by the compiler");
},
LitKind::Bool(false) => {
span_lint(cx, EXPLICIT_FALSE, e.span,
"assert!(false) should probably be replaced by a panic!() or unreachable!()");
span_lint_and_sugg(
cx,
ASSERTIONS_ON_CONSTANTS,
e.span,
"assert!(false) should probably be replaced",
"try",
"panic!()".to_string(),
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

panic!() or unreachable!()

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Work in progress. I pushed the current state of PR to test span_lint_and_sugg. Seems it not work as expected for assert!() macro. Maybe I should replace it with span_lint_and_help function?

Applicability::MachineApplicable);
},
_ => (),
}
Expand Down
10 changes: 4 additions & 6 deletions clippy_lints/src/lib.rs
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ mod utils;
// begin lints modules, do not remove this comment, it’s used in `update_lints`
pub mod approx_const;
pub mod arithmetic;
pub mod assert_checks;
pub mod assertions_on_constants;
pub mod assign_ops;
pub mod attrs;
pub mod bit_mask;
Expand Down Expand Up @@ -487,7 +487,7 @@ pub fn register_plugins(reg: &mut rustc_plugin::Registry<'_>, conf: &Conf) {
reg.register_late_lint_pass(box ptr_offset_with_cast::Pass);
reg.register_late_lint_pass(box redundant_clone::RedundantClone);
reg.register_late_lint_pass(box slow_vector_initialization::Pass);
reg.register_late_lint_pass(box assert_checks::AssertChecks);
reg.register_late_lint_pass(box assertions_on_constants::AssertionsOnConstants);

reg.register_lint_group("clippy::restriction", Some("clippy_restriction"), vec![
arithmetic::FLOAT_ARITHMETIC,
Expand Down Expand Up @@ -565,8 +565,7 @@ pub fn register_plugins(reg: &mut rustc_plugin::Registry<'_>, conf: &Conf) {

reg.register_lint_group("clippy::all", Some("clippy"), vec![
approx_const::APPROX_CONSTANT,
assert_checks::EXPLICIT_FALSE,
assert_checks::EXPLICIT_TRUE,
assertions_on_constants::ASSERTIONS_ON_CONSTANTS,
assign_ops::ASSIGN_OP_PATTERN,
assign_ops::MISREFACTORED_ASSIGN_OP,
attrs::DEPRECATED_CFG_ATTR,
Expand Down Expand Up @@ -788,6 +787,7 @@ pub fn register_plugins(reg: &mut rustc_plugin::Registry<'_>, conf: &Conf) {
]);

reg.register_lint_group("clippy::style", Some("clippy_style"), vec![
assertions_on_constants::ASSERTIONS_ON_CONSTANTS,
assign_ops::ASSIGN_OP_PATTERN,
attrs::UNKNOWN_CLIPPY_LINTS,
bit_mask::VERBOSE_BIT_MASK,
Expand Down Expand Up @@ -944,8 +944,6 @@ pub fn register_plugins(reg: &mut rustc_plugin::Registry<'_>, conf: &Conf) {

reg.register_lint_group("clippy::correctness", Some("clippy_correctness"), vec![
approx_const::APPROX_CONSTANT,
assert_checks::EXPLICIT_FALSE,
assert_checks::EXPLICIT_TRUE,
attrs::DEPRECATED_SEMVER,
attrs::USELESS_ATTRIBUTE,
bit_mask::BAD_BIT_MASK,
Expand Down
18 changes: 0 additions & 18 deletions tests/ui/assert_checks.stderr

This file was deleted.

File renamed without changes.
16 changes: 16 additions & 0 deletions tests/ui/assertions_on_constants.stderr
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
error: assert!(true) will be optimized out by the compiler
--> $DIR/assertions_on_constants.rs:11:5
|
LL | assert!(true);
| ^^^^^^^^^^^^^^
|
= note: `-D clippy::assertions-on-constants` implied by `-D warnings`

error: assert!(false) should probably be replaced
--> $DIR/assertions_on_constants.rs:12:5
|
LL | assert!(false);
| ^^^^^^^^^^^^^^^ help: try: `panic!()`

error: aborting due to 2 previous errors

2 changes: 1 addition & 1 deletion tests/ui/attrs.rs
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
// except according to those terms.

#![warn(clippy::inline_always, clippy::deprecated_semver)]
#![allow(clippy::assert_checks::explicit_true)]
#![allow(clippy::assertions_on_constants::assertions_on_constants)]
#[inline(always)]
fn test_attr_lint() {
assert!(true)
Expand Down
2 changes: 1 addition & 1 deletion tests/ui/empty_line_after_outer_attribute.rs
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
// except according to those terms.

#![warn(clippy::empty_line_after_outer_attr)]
#![allow(clippy::assert_checks::explicit_true)]
#![allow(clippy::assertions_on_constants::assertions_on_constants)]
// This should produce a warning
#[crate_type = "lib"]

Expand Down
2 changes: 1 addition & 1 deletion tests/ui/panic_unimplemented.rs
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
// except according to those terms.

#![warn(clippy::panic_params, clippy::unimplemented)]
#![allow(clippy::assert_checks::explicit_true)]
#![allow(clippy::assertions_on_constants::assertions_on_constants)]
fn missing() {
if true {
panic!("{}");
Expand Down