A linter for Python tests
Project description
Flake8-AAA
A linter for Python tests.
Flake8-AAA enforces simple formatting of your test suite making it more consistent and easier to grok, especially across teams.
Installation and usage
Flake8-AAA is a Flake8 plugin.
Install flake8-aaa with pip, which will also install flake8:
$ pip install flake8-aaa
Invoke Flake8 on your test suite, in this case in the tests directory:
$ flake8 tests
Errors returned by Flake8-AAA have the AAA code, for example:
tests/block/test_init.py:14:1: AAA02 multiple Act blocks found in test
Arrange Act Assert
Tests are linted against the Arrange Act Assert pattern.
TL;DR following the AAA pattern means tests are laid out like this:
def test():
"""
__docstring__
"""
<ARRANGE block> # set up of the system under test (SUT)
<ACT block> # perform a single action on the SUT
<ASSERT block> # check that the SUT changed as expected
For example:
def test(tmpdir):
"""
Checker is able to parse provided file at load time
"""
target_file = tmpdir.join('test.py')
target_file.write('assert 1 + 2 == 3\n')
tree = ast.parse(target_file.read())
checker = Checker(tree, ['assert 1 + 2 == 3\n'], target_file.strpath)
result = checker.load()
assert result is None
assert len(checker.tree.body) == 1
assert type(checker.tree.body[0]) == ast.Assert
assert len(checker.ast_tokens.tokens) == 8
More examples are in our test suite’s “good” files.
Compatibility
Pytest and unittest supported.
Compatible with Black and yapf formatted code.
Current release works with the latest versions of Python 3 (3.5, 3.6, 3.7 and 3.8). Older releases have support for older Pythons.
See the Compatibility list for more info.
Resources
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for flake8_aaa-0.7.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e747bdddf6689755ce8bc6d87a0819448029f6ddf806bab686429d2a8c900693 |
|
MD5 | 3305561f452bdeb6dfb7872d62345ae7 |
|
BLAKE2b-256 | aa41d91ce9850dbb3f7130d17a9c4acc2113fdce2b602d95937a6a9f040d9b72 |