Skip to content

Test File Too Large ​

Rule ID: test-file-too-large

What it does ​

Flag test files that exceed the configured non-blank, non-comment-only line budget.

Why this matters ​

Oversized test modules tend to become monolithic and less actionable when failures occur.

Default severity ​

warning

Trigger conditions ​

  • A test file is discovered.
  • Non-blank, non-comment line count exceeds configured threshold.

Examples ​

  • Source module: n/a
  • Test module: tests/app/engine/test_runner.py (over configured line limit)

How to address ​

  • Split the suite by concern using stable qualifiers.
  • Move shared setup into nearby conftest.py fixtures.
  • --select test-file-too-large
  • --ignore test-file-too-large
  • [tool.tq].select / [tool.tq].ignore
  • [tool.tq].max_test_file_non_blank_lines

Added in ​

pre-1.0

Behavior changes ​

None to date.