Testing Strategy¶

pytest                                          # Full test suite
pytest --cov=file_organizer --cov-report=html  # With coverage
pytest tests/services/ -v                       # Specific directory
pytest -m smoke -x                              # Fast smoke suite (~3.5s, pre-commit validation)
pytest -m ci -x                                 # CI tests for PR validation
pytest -m "not regression" -x                   # All tests except regression (full run)
pytest -k "backup or dedup"                     # Filter by name

@pytest.mark.unit          # Unit tests
@pytest.mark.smoke         # Fast critical-path tests (pre-commit validation)
@pytest.mark.integration   # Integration tests
@pytest.mark.e2e           # End-to-end tests
@pytest.mark.asyncio       # Async tests (FastAPI, TUI, services)
@pytest.mark.benchmark     # Performance benchmarks
@pytest.mark.ci            # CI-specific tests
@pytest.mark.slow          # Slow tests
@pytest.mark.regression    # Regression tests (full suite only)
@pytest.mark.no_ollama     # Tests for graceful degradation when Ollama is unavailable

def test_example():
    pass