assert-no-linter-config-files 20260103184015

CLI tool to assert that no linter config files exist

assert-no-linter-config-files

A command-line tool that asserts there are no configuration files (or embedded configuration sections) for common linters in your codebase. This is useful for enforcing that linter configurations are managed centrally rather than in individual repositories.

Installation

pip install assert-no-linter-config-files

Or install from source:

pip install -e .

Usage

assert-no-linter-config-files --linters LINTERS [OPTIONS] DIRECTORY [DIRECTORY ...]

Required Arguments

• --linters LINTERS - Comma-separated linters to check: pylint,mypy,pytest,yamllint,jscpd
• DIRECTORY - One or more directories to scan

Optional Arguments

• --exclude PATTERN - Glob pattern to exclude paths (repeatable)
• --quiet - Suppress output, exit code only
• --count - Print finding count only
• --json - Output findings as JSON
• --fail-fast - Exit on first finding
• --warn-only - Always exit 0, report only

Exit Codes

• 0 - No linter configuration found (or --warn-only)
• 1 - One or more linter configurations found
• 2 - Usage/runtime error (invalid args, unreadable files)

Examples

Check for pylint and mypy configs in the current directory:

assert-no-linter-config-files --linters pylint,mypy .

Check specific directories:

assert-no-linter-config-files --linters pylint,mypy src/ tests/

Check all linters:

assert-no-linter-config-files --linters pylint,mypy,pytest,yamllint,jscpd .

Exclude vendor directories:

assert-no-linter-config-files --linters pylint,mypy \
  --exclude "*vendor*" --exclude "*node_modules*" .

Get JSON output for CI integration:

assert-no-linter-config-files --linters pylint --json . | jq .

Use in CI to enforce no local linter configs:

assert-no-linter-config-files --linters pylint,mypy . || exit 1

What It Checks

Dedicated Config Files

The tool flags the presence of these files anywhere in the scanned tree:

pylint: .pylintrc, pylintrc, .pylintrc.toml

pytest: pytest.ini

mypy: mypy.ini, .mypy.ini

yamllint: .yamllint, .yamllint.yml, .yamllint.yaml

jscpd: .jscpd.json, .jscpd.yml, .jscpd.yaml, .jscpd.toml, .jscpdrc, .jscpdrc.json, .jscpdrc.yml, .jscpdrc.yaml

Embedded Config Sections

The tool also checks shared config files for tool-specific sections:

pyproject.toml:

• [tool.pylint] or [tool.pylint.*]
• [tool.mypy]
• [tool.pytest.ini_options]
• [tool.jscpd]
• [tool.yamllint]

setup.cfg:

• [mypy]
• [tool:pytest]
• Any section containing "pylint"

tox.ini:

• [pytest] or [tool:pytest]
• [mypy]
• Any section containing "pylint"

Output Format

When findings are detected, each is printed on a separate line:

<path>:<tool>:<reason>

Examples:

./pytest.ini:pytest:config file
./pyproject.toml:mypy:tool.mypy section
./setup.cfg:pylint:pylint.messages_control section

With --json:

[{"path": "./pytest.ini", "tool": "pytest", "reason": "config file"}]

CI Checks

The following checks run on every push and pull request:

• yamllint - YAML linting for workflow files
• markdownlint - Markdown linting
• pylint - Python linting for source and test code
• mypy - Static type checking for source code
• jscpd - Duplicate code detection
• pytest - Unit, integration, and E2E tests