pytest-coverage

name	pytest-coverage
description	Run pytest tests with coverage, discover lines missing coverage, and increase coverage to 100%. Use when: - Measuring test coverage for a module - Finding untested code paths - Improving coverage for a specific service

Pytest Coverage Analysis

The goal is for tests to cover all lines of code.

Workflow

1. Generate Coverage Report

pytest --cov --cov-report=annotate:cov_annotate

For a specific module:

pytest --cov=your_module_name --cov-report=annotate:cov_annotate

For specific tests:

pytest tests/test_your_module.py --cov=your_module_name --cov-report=annotate:cov_annotate

2. Review Annotated Files

Open the cov_annotate directory. There will be one file per source file.

• Files with 100% coverage → skip
• Files with <100% coverage → open and review

3. Find Uncovered Lines

Lines starting with ! (exclamation mark) are not covered by tests. Add tests to cover these lines.

4. Iterate

Keep running the tests and improving coverage until all lines are covered.

Project Context

This project has three services with independent test suites:

Service	Test Command	Source
Agent	cd src/agent && pytest	src/agent/
Functions	cd src/functions && pytest	src/functions/
Web App	cd src/web-app && pytest	src/web-app/

Run all: make dev-test

Example for agent coverage:

cd src/agent
pytest --cov=agent --cov-report=annotate:cov_annotate tests/