Skip to main content

Invalid test name checker, plugin for flake8

Project description

Build status Coverage Status

An extension for Flake8 to make sure that test function name follows a given convention

Plugin for Flake8

When both Flake8 and flake8-test-name are installed, the plugin will show up when displaying the version of flake8:

$ flake8 --version
3.6.0 (flake8-test-name: 0.1.2, []

Operation

The hook assumes that your:

  • test files are matching test_.*.py

  • test functions are starting with test_

Any function matching these 2 conditions will be validated against your custom validator

Parameters

This module can be configured in 2 ways. First option is a regex using --test-func-name-validator-regex:

$ flake8 myproject/tests/sample.py --test-func-name-validator-regex="test_funky_convention_.*" --select=TN101

>> myproject/tests/sample.py:14:1: TN101 test function name does not match the convention (test_invalid_method_sample)

Second option is with a python module containing a method named test_function_name_validator. Assuming you have a funky_validator.py file with the following content:

def test_function_name_validator(func_name: str):
    return func_name.startswith("test_funkyconvention")

You can then configure it using --test-func-name-validator-module:

$ flake8 myproject/tests/sample.py --test-func-name-validator-module=./funky_validator.py --select=TN101

>> myproject/tests/sample.py:14:1: TN101 test function name does not match the convention (test_invalid_method_sample)

Error codes

This plugin is using the following error codes:

Code | Error

TN101

TN101 test function name does not match the convention

Changes

0.1.6 - 2023-10-03

  • fix in options parser for flake8 > 6.0

0.1.5 - 2021-03-21

  • minor refactoring and doc improvement

0.1.1 - 2021-03-19

  • Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flake8-test-name-0.1.6.tar.gz (8.0 kB view hashes)

Uploaded Source

Built Distribution

flake8_test_name-0.1.6-py2.py3-none-any.whl (5.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page