Cline rules

1---
2description: Testing standards and best practices for mtg-utils
3author: Simone Gasbarroni
4version: 1.0
5tags: ["testing", "pytest", "coverage"]
6---
7 
8# Testing Standards
9 
10## Overview
11 
12mtg-utils uses pytest for testing with a 100% coverage requirement. This document outlines the testing standards and practices for the project.
13 
14---
15 
16## Test Structure
17 
18```
19tests/
20├── conftest.py              # Shared fixtures and configurations
21├── test_main.py             # CLI entry point tests
22├── test_config.py           # Configuration loading tests
23├── test_console.py          # Console output tests
24├── test_moxfield_api.py     # API integration tests
25├── test_compare_decks.py    # Deck comparison tests
26├── test_list_decks.py       # List decks tests
27├── test_readers.py          # File reading utilities tests
28├── test_commands/           # Command-specific tests
29│   ├── test_check_missing_cards.py
30│   └── test_update_card_library.py
31└── test_utils/              # Utility module tests
32    ├── test_cards.py
33    ├── test_config.py
34    ├── test_moxfield_api.py
35    └── test_readers.py
36```
37 
38---
39 
40## Test Types
41 
42### Unit Tests
43 
44- Pure logic tests, no file I/O or network mocking
45- Mark with `@pytest.mark.unit`
46- Focus on isolated function/class behavior
47 
48### Integration Tests
49 
50- CLI runner + filesystem + mocks
51- Mark with `@pytest.mark.integration`
52- Test end-to-end workflows
53 
54---
55 
56## Coverage Requirements
57 
58- **Target**: 100% coverage
59- Configured in `pyproject.toml`:
60- When checking for coverage always run entire test suite
61 
62```toml
63[tool.coverage.report]
64fail_under = 100
65exclude_lines = [
66    "pragma: no cover",
67    "if __name__ == .__main__.:",
68]
69```
70 
71---
72 
73## Writing Good Tests
74 
75### Use Fixtures
76 
77Utilize `conftest.py` fixtures to avoid duplication:
78 
79```python
80def test_something(repo):
81    cfg = repo(binder_id="abc", decks={"my_deck": {"id": "x", "file": "card_library/decks/my_deck.txt"}})
82```
83 
84### Mock External Dependencies
85 
86Use `monkeypatch` or `unittest.mock` for API calls:
87 
88```python
89from unittest.mock import patch
90 
91@patch("requests.get")
92def test_api_call(mock_get):
93 
94```