Installation

Install from PyPI using pip:

$ pip install flake8-assertive

The extension will be activated automatically by flake8. You can verify that it has been loaded by inspecting the flake8 --version string.

$ flake8 --version
3.7.9 (assertive: 1.2.0, ...) CPython 2.7.17 on Darwin

Error Codes

This extension adds three new error codes (using the A50 prefix):

• A500: prefer {func} for ‘{op}’ comparisons

• A501: prefer {func} for ‘{op}’ expressions

• A502: prefer {func} instead of comparing to {obj}

• A503: use {func} instead of the deprecated {name}

Configuration

Configuration values are specified in the [flake8] section of your config file or as command line arguments (e.g. --assertive-snakecase).

• assertive-snakecase: suggest snake_case assert method names (e.g. assert_true()) instead of the standard names (e.g. assertTrue())

• assertive-test-pattern: fnmatch pattern for identifying unittest test files (and all other files will be skipped)

Caveats

There are some specific cases when the suggestion might not match the intent of the original.

assertIs(a == b, True)

1.2.0 (2019-12-05)

• Suggest the preferred names for deprecated methods, such as assertEqual() instead of assertEquals().

1.1.0 (2019-06-26)

• Suggest assertAlmostEqual(a, b, x) for round() expressions like in assertEqual(a, round(b, x)) and assertAlmostEqual(a, round(b, x)) (and similar for assertNotEqual() and assertNotAlmostEqual().

• Recognize assertAmostEquals() and assertNotAlmostEquals() as aliases for assertAlmostEqual() and assertNotAlmostEqual().

• Drop Python 3.4 as a supported version since it has been officially retired.

1.0.1 (2018-07-03)

• Don’t make suggestions for assertions containing multiple comparison operations (e.g. assertTrue(a == b == c)).

1.0.0 (2018-06-04)

• Suggest assertIsNone(a) for assertTrue(a is None), etc.

• Recognize assertEquals() and assertNotEquals() as aliases for assertEqual() and assertNotEqual().

0.9.0 (2018-05-14)

• Initial beta release