testing

Testing Documentation

This directory contains documentation about Firewood's testing infrastructure and practices.

Contents

Pytest Setup

• PYTEST_SETUP.md - Pytest migration documentation

  • What changed from manual testing to pytest
  • Configuration details
  • Benefits of pytest
  • Future test plans

• PYTEST_MIGRATION_COMPLETE.md - Migration completion summary

  • Migration status
  • Test results
  • Files affected
  • Quick reference commands

• TESTING_SUMMARY.md - Current testing status

  • Test statistics
  • Coverage breakdown
  • Test files and their purposes
  • Goals and next steps

Running Tests

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=firewood --cov-report=html

# Run specific tests
uv run pytest tests/test_config_save.py -v

See ../../tests/README.md for complete testing guide.

Current Status

• Framework: pytest 9.0.2
• Total Tests: 12
• Coverage: 31%
• Status: ✅ All passing

For Contributors

• See TESTING_SUMMARY.md for current test status
• See ../../tests/README.md for how to write tests
• See PYTEST_SETUP.md for testing framework details

For AI Agents

When adding tests:

1. Use pytest framework
2. Follow patterns in ../../tests/
3. Update test statistics in TESTING_SUMMARY.md
4. Run full test suite before committing

---

Last Updated: 2026-02-01