assert-one-assert-per-pytest

Assert that each pytest test function contains exactly one assert.

Why One Assert Per Test?

The "one assert per test" pattern encourages writing focused, atomic tests that verify a single behavior. Benefits include:

Clear failure messages: When a test fails, you know exactly what behavior broke
Better test names: Tests naturally describe specific behaviors
Easier maintenance: Changes to one behavior don't affect unrelated assertions
Faster debugging: No need to hunt through multiple assertions

Installation

pip install assert-one-assert-per-pytest

Usage

Command Line

# Scan specific files
assert-one-assert-per-pytest test_example.py

# Scan directories recursively
assert-one-assert-per-pytest tests/

# Use glob patterns
assert-one-assert-per-pytest "tests/**/test_*.py"

# Exclude patterns
assert-one-assert-per-pytest tests/ --exclude "**/conftest.py"

# Verbose output
assert-one-assert-per-pytest tests/ --verbose

# Fail fast (exit on first finding)
assert-one-assert-per-pytest tests/ --fail-fast

# Warn only (always exit 0)
assert-one-assert-per-pytest tests/ --warn-only

GitHub Actions

- uses: 10U-Labs-LLC/assert-one-assert-per-pytest@v1
  with:
    files: "tests/"
    exclude: "**/conftest.py"
    verbose: "true"

As a Python Module

python -m assert_one_assert_per_pytest tests/

Output Format

Default output shows one finding per line:

path/to/test_file.py:10:test_example:0
path/to/test_file.py:25:test_another:3

Format: file_path:line_number:function_name:assert_count

Exit Codes

0: No findings (or --warn-only specified)
1: Findings detected
2: Error (missing files, syntax errors, etc.)

What Counts as an Assert?

This tool counts Python assert statements at the immediate level of test functions. It also counts:

pytest.raises() context managers
pytest.warns() context managers

It does not count:

Assertions in nested functions or classes
Helper assertions in fixtures or utility functions

Options

Option	Description
`--exclude PATTERNS`	Glob patterns to exclude (comma-separated)
`--quiet`	Suppress all output (exit code only)
`--verbose`	Show detailed processing information
`--fail-fast`	Exit after first finding
`--warn-only`	Always exit 0, even with findings

License

Apache 2.0 - See LICENSE.txt

Download files

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

Source Distribution

assert_one_assert_per_pytest-20260830055519.tar.gz (24.0 kB view details)

Uploaded Aug 30, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

assert_one_assert_per_pytest-20260830055519-py3-none-any.whl (11.1 kB view details)

Uploaded Aug 30, 2026 Python 3

File details

Details for the file assert_one_assert_per_pytest-20260830055519.tar.gz.

File metadata

Download URL: assert_one_assert_per_pytest-20260830055519.tar.gz
Upload date: Aug 30, 2026
Size: 24.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for assert_one_assert_per_pytest-20260830055519.tar.gz
Algorithm	Hash digest
SHA256	`2d7df3ae52007ff324c2d802a36c963be3f3549c8665ee7af533f0fb1a5998e8`
MD5	`9e0561908f48076dbdc30eaaf5775cdd`
BLAKE2b-256	`2445213fd373dcb94c7c0168154d949ff60a5091b57170d1e76983551adcc6aa`

See more details on using hashes here.

Provenance

The following attestation bundles were made for assert_one_assert_per_pytest-20260830055519.tar.gz:

Publisher: release.yml on 10U-Labs/assert-one-assert-per-pytest

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: assert_one_assert_per_pytest-20260830055519.tar.gz
- Subject digest: 2d7df3ae52007ff324c2d802a36c963be3f3549c8665ee7af533f0fb1a5998e8
- Sigstore transparency entry: 2647755383
- Sigstore integration time: Aug 30, 2026
Source repository:
- Permalink: 10U-Labs/assert-one-assert-per-pytest@f3f272426cc0cafe392c7636e1b3653db031d987
- Branch / Tag: refs/heads/main
- Owner: https://github.com/10U-Labs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@f3f272426cc0cafe392c7636e1b3653db031d987
- Trigger Event: push