tqlint 0.4.2

tq inspects a codebase's tests and enforces quality rules so tests remain discoverable, focused, actionable, and maintainable

tq - Test Quality Toolkit

tq inspects a codebase's tests and enforces quality rules so tests remain discoverable, focused, actionable, and maintainable.

Installation

PyPI distribution name: tqlint

Add to a project:

uv add --dev tqlint
uv run tq check

Run without installing (ephemeral):

uvx tqlint check

Install as a persistent global tool:

uv tool install tqlint
tq check

Note: uvx tq check is not available because the tq package name on PyPI is owned by another project.

Current scope

tq currently analyzes Python source and Python tests (.py) only.

Usage

Run checks:

uv run tq check

Emit machine-readable diagnostics:

uv run tq check --output-format json

Configuration

Configure tq in pyproject.toml under [tool.tq]:

[tool.tq]
package = "tq"
source_root = "src"
test_root = "tests"
ignore_init_modules = true
max_test_file_non_blank_lines = 600
qualifier_strategy = "allowlist"
allowed_qualifiers = ["regression"]

Documentation

• See docs/developer/tools/tq_check.md for tool usage and configuration details.
• See docs/developer/tools/rules.md for built-in rules.

Development

Contribution guidelines are in CONTRIBUTING.md. For local development, follow below steps.

Install dependencies:

uv sync

Install pre-commit hooks (including pre-commit, commit-msg, and pre-push):

uv run prek install

Run tests:

uv run pytest -q