1
import pytest
2
from src.calculator import add
3

4
@pytest.mark.parametrize("a,b,expected", [
5
    (2,3,5),
6
    (0,0,0),
7
    (-5,5,0),
8
    (1.5, 2.5, 4.0)
9
])
10
def test_add_param(a,b,expected):
11
    assert add(a,b) == expected

1
from hypothesis import given
2
import hypothesis.strategies as st
3
from src.calculator import add
4

5
@given(st.integers(), st.integers())
6
def test_add_commutative(a, b):
7
    assert add(a, b) == add(b, a)

1
myproject/
2
├─ src/
3
│  └─ calculator.py
4
├─ tests/
5
│  └─ test_calculator.py
6
├─ requirements-dev.txt
7
├─ pyproject.toml        # 可选：项目元数据 / pytest 配置
8
├─ pytest.ini
9
├─ .github/
10
│  └─ workflows/
11
│     ├─ ci.yml
12
│     └─ mutation.yml
13
└─ Makefile

1
src/calculator.py
2
def add(a, b):
3
    return a + b
4

5
def divide(a, b):
6
    if b == 0:
7
        raise ValueError("division by zero")
8
    return a / b
9
tests/test_calculator.py
10
import pytest
11
from src.calculator import add, divide
12
from hypothesis import given, strategies as st
13

14
def test_add_basic():
15
    assert add(2, 3) == 5
16
    assert add(-1, 1) == 0
17

18
def test_divide_by_zero():
19
    with pytest.raises(ValueError):
20
        divide(1, 0)
21

22
@given(st.integers(), st.integers().filter(lambda x: x != 0))
23
def test_divide_inverse(a, b):
24
    # property: a == divide(a*b, b) for integer pairs with b != 0
25
    assert abs(divide(a * b, b) - a) < 1e-9

1
pytest>=7.0
2
pytest-cov>=4.0
3
hypothesis>=6.0
4
mutmut>=2.0
5
codecov>=2.2

1
[pytest]
2
addopts = -q --strict-markers --maxfail=1 --cov=src --cov-report=xml
3
testpaths = tests

1
.PHONY: install test coverage mutation
2

3
install:
4
  pip install -r requirements-dev.txt
5

6
test:
7
  pytest
8

9
coverage:
10
  pytest --cov=src --cov-report=term --cov-report=xml
11

12
mutation:
13
  # 说明：mutmut 在 CI 中通常单独运行（耗时），本地运行示例：
14
  mutmut run --paths-to-mutate src
15
  mutmut results

1
name: Python CI
2

3
on:
4
  push:
5
    branches: [ main ]
6
  pull_request:
7
    branches: [ main ]
8

9
jobs:
10
  test:
11
    runs-on: ubuntu-latest
12
    strategy:
13
      matrix:
14
        python-version: [3.10, 3.11]
15

16
    steps:
17
      - name: Checkout
18
        uses: actions/checkout@v4
19

20
      - name: Set up Python
21
        uses: actions/setup-python@v4
22
        with:
23
          python-version: ${{ matrix.python-version }}
24

25
      - name: Cache pip
26
        uses: actions/cache@v4
27
        with:
28
          path: ~/.cache/pip
29
          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements-dev.txt') }}
30

31
      - name: Install dependencies
32
        run: |
33
          python -m pip install --upgrade pip
34
          pip install -r requirements-dev.txt
35

36
      - name: Run tests with coverage
37
        run: pytest
38

39
      - name: Upload coverage to Codecov
40
        if: always() && env.CODECOV_TOKEN != ''
41
        env:
42
          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
43
        uses: codecov/codecov-action@v5
44
        with:
45
          files: ./coverage.xml
46
          flags: unittests
47
          fail_ci_if_error: true
48

49
      - name: Upload pytest junit xml (artifact)
50
        if: always()
51
        uses: actions/upload-artifact@v4
52
        with:
53
          name: pytest-junit
54
          path: ./junit.xml

1
name: Mutation Testing
2

3
on:
4
  workflow_dispatch:
5
  schedule:
6
    - cron: "0 3 * * 1"   # 每周一 UTC 03:00 运行（可删除）
7

8
jobs:
9
  mutmut:
10
    runs-on: ubuntu-latest
11
    timeout-minutes: 120
12
    steps:
13
      - name: Checkout
14
        uses: actions/checkout@v4
15

16
      - name: Set up Python
17
        uses: actions/setup-python@v4
18
        with:
19
          python-version: '3.11'
20

21
      - name: Install dependencies
22
        run: |
23
          python -m pip install --upgrade pip
24
          pip install -r requirements-dev.txt
25

26
      - name: Run mutation testing (mutmut)
27
        run: |
28
          # 只对 src 包做变异；如果你的代码在包内调整路径
29
          mutmut run --paths-to-mutate src
30
          mutmut results --show
31
          mutmut html  # 生成 html 报告 artifacts/mutmut-report
32
      - name: Upload mutmut report
33
        uses: actions/upload-artifact@v4
34
        with:
35
          name: mutmut-report
36
          path: .mutmut-html-report || html_report || mutmut-report || ./mutmut-report || .