swarmauri_tests_loc_tersity 0.2.0.dev3

Pytest plugin enforcing line count limits

---

Overview

swarmauri_tests_loc_tersity is a pytest plugin that keeps modules small and readable. It scans a package for Python files and asserts that each file stays under a configurable line‑of‑code (LOC) limit (docstrings included). The default limit is 400 lines.

The plugin runs in parameterized mode by default, turning every file into an individual test case. You can also switch to an aggregate mode that reports all failures as a single test.

Installation

pip install swarmauri_tests_loc_tersity

pytest automatically discovers the plugin once it is installed.

Usage

Parameterized (default)

Run pytest normally to create one LOC check per Python file:

pytest

Example failure:

E   AssertionError: pkg/example.py has 425 lines (>400)

Aggregate

Use the --loc-mode=aggregate flag to consolidate checks into one test that lists every file exceeding the threshold:

pytest --loc-mode=aggregate

Example output:

E   pkg/example.py has 425 lines (>400)
E   pkg/other.py has 410 lines (>400)

Customizing

• --loc-root PATH – directory to scan (defaults to the package root)
• --loc-max-lines N – change the maximum line count

pytest --loc-root=src --loc-max-lines=200

License

Licensed under the Apache 2.0 License.