Skip to content

README.md

Latest commit

 

History

History
82 lines (63 loc) · 3.48 KB

README.md

File metadata and controls

82 lines (63 loc) · 3.48 KB

BeCoMe Test Suite

Tests for the BeCoMe implementation: 953 tests total, 100% code coverage.

Overview

Unit tests cover models, calculators, interpreters, utilities, and API components in isolation. Integration tests validate core results against the original Excel implementation (tolerance: 0.001) and test API routes with a real database. End-to-end tests exercise full API workflows. All tests follow the GIVEN-WHEN-THEN pattern.

Running Tests

uv run pytest                          # all tests
uv run pytest tests/unit/              # unit tests only
uv run pytest tests/integration/       # integration tests only
uv run pytest -v                       # verbose output
uv run pytest -x                       # stop on first failure

Code Coverage

uv run pytest --cov=src --cov-report=term-missing
uv run pytest --cov=src --cov-report=html          # generates htmlcov/

Current coverage: 100% (all statements and branches).

Test Structure

tests/
├── unit/
│   ├── models/          # FuzzyTriangleNumber, ExpertOpinion, BeCoMeResult
│   ├── calculators/     # arithmetic mean, median, strategies, compromise
│   ├── interpreters/    # Likert scale interpreter
│   ├── utilities/       # display, formatting, analysis helpers
│   └── api/             # API unit tests
│       ├── auth/            # JWT, password hashing, token blacklist
│       ├── middleware/      # rate limiting, security headers, exceptions
│       ├── schemas/         # request/response validation
│       ├── services/        # business logic (users, projects, opinions)
│       └── utils/           # sanitization
├── integration/
│   ├── test_excel_reference.py   # validates against Excel (3 case studies)
│   ├── test_data_loading.py      # text file parsing
│   └── api/                      # API integration tests
│       ├── auth/            # authentication flows
│       ├── db/              # database models, relationships, cascades
│       └── routes/          # HTTP endpoint integration tests
├── e2e/                 # end-to-end API workflow tests
├── shared/              # test helpers and utilities
└── reference/
    ├── budget_case.py    # 22 experts, expected results
    ├── floods_case.py    # 13 experts, expected results
    └── pendlers_case.py  # 22 experts, Likert scale

Unit tests (571) check individual components in isolation, including API auth, schemas, services, and middleware. Integration tests (329) validate core calculations against Excel results (tolerance: 0.001) and test API routes with a real database. End-to-end tests (53) exercise complete API workflows including auth, projects, and invitations. Reference data contains expected values from the original Excel implementation.

Writing Tests

Tests follow GIVEN-WHEN-THEN:

def test_example():
    # GIVEN
    opinions = [ExpertOpinion("E1", FuzzyTriangleNumber(5, 10, 15))]

    # WHEN
    result = calculator.calculate_compromise(opinions)

    # THEN
    assert result.best_compromise.peak == expected_value

Each test runs in isolation — no shared state, fresh fixtures, deterministic outcomes.

Related Documentation