Покриття тестами

Створіть `src/calculator.py` з трьома функціями: `add(a, b)`, `divide(a, b)` (підіймає `ZeroDivisionError` при `b == 0`) і `absolute_value(x)`. Створіть `tests/test_calc.py` з єдиним тестом, що тестує лише `add()`. Запустіть `pytest --cov=src --cov-report=term-missing tests/` і прочитайте вивід. Визначте, які функції не покриті і які конкретні номери рядків вказані у стовпці Missing.

# src/calculator.py

def add(a, b):
    return a + b

def divide(a, b):
    if b == 0:
        raise ZeroDivisionError('cannot divide by zero')
    return a / b

def absolute_value(x):
    if x < 0:
        return -x
    return x


# tests/test_calc.py
from src.calculator import add

def test_add():
    assert add(2, 3) == 5
    assert add(-1, 1) == 0

# Запуск: pytest --cov=src --cov-report=term-missing tests/
# Який відсоток покриття?
# Які рядки з'являються у стовпці Missing?

# src/calculator.py

def add(a, b):
    return a + b

def divide(a, b):
    if b == 0:
        raise ZeroDivisionError('cannot divide by zero')
    return a / b

def absolute_value(x):
    if x < 0:
        return -x
    return x


# tests/test_calc.py
from src.calculator import add

def test_add():
    assert add(2, 3) == 5
    assert add(-1, 1) == 0

# Очікуваний звіт (приблизно -- точні номери рядків залежать від порожніх рядків у файлі):
# Name               Stmts   Miss  Cover   Missing
# src/calculator.py    <N>   <Miss>  ~40%   <рядки у divide() і absolute_value()>
#
# Стовпець Missing показуватиме рядки тіла divide() і absolute_value().
# Відкрийте файл і перевірте: вказані рядки мають бути всередині цих двох функцій.
# Покриття: ~40% -- виконується лише add().

Використовуючи `src/calculator.py` з вправи 1: запустіть `pytest --cov=src --cov-report=html tests/`, щоб згенерувати `htmlcov/index.html`. Відкрийте у браузері (або використайте `--cov-report=term-missing` для знаходження рядків). Напишіть тести для `divide()` і `absolute_value()` -- включаючи шлях з помилкою і обидві гілки оператора if. Запустіть coverage знову і переконайтеся, що досягнуто 100%.

# tests/test_calc.py  (розширення з вправи 1)
from src.calculator import add, divide, absolute_value
import pytest


def test_add():
    assert add(2, 3) == 5
    assert add(-1, 1) == 0


def test_divide():
    # покрийте як звичайний шлях, так і шлях з ZeroDivisionError
    pass


def test_absolute_value():
    # покрийте як гілку з від'ємним входом, так і з додатнім
    pass

# Запуск: pytest --cov=src --cov-report=html tests/
# Відкрийте htmlcov/index.html -- червоні рядки не покриті

# tests/test_calc.py
from src.calculator import add, divide, absolute_value
import pytest


def test_add():
    assert add(2, 3) == 5
    assert add(-1, 1) == 0


def test_divide_normal():
    assert divide(10, 2) == 5.0


def test_divide_by_zero():
    with pytest.raises(ZeroDivisionError):
        divide(10, 0)


def test_absolute_value_negative():
    assert absolute_value(-5) == 5


def test_absolute_value_positive():
    assert absolute_value(3) == 3

# Після додавання цих тестів:
# src/calculator.py    9    0   100%
# Всі червоні рядки мають стати зеленими у HTML-звіті.

Використовуючи частковий тест-сьют з вправи 1 (лише test_add): запустіть `pytest --cov=src --cov-fail-under=80 tests/` і спостерігайте код завершення -- він має бути 2, а не 0. Зверніть увагу на повідомлення про збій у виводі. Потім додайте повні тести з вправи 2 і запустіть знову -- має пройти з кодом завершення 0. Додайте прапор у `pytest.ini` через `addopts`, щоб зробити його постійним.

# Запуск 1 -- лише з test_add (очікується код завершення 2, покриття ~33%):
# pytest --cov=src --cov-fail-under=80 tests/

# Запуск 2 -- після додавання всіх тестів (очікується код завершення 0, покриття 100%):
# pytest --cov=src --cov-fail-under=80 tests/

# Щоб зробити мінімум постійним, додайте у pytest.ini:
# [pytest]
# addopts = --cov=src --cov-report=term-missing --cov-fail-under=80

# pytest.ini
# [pytest]
# addopts = --cov=src --cov-report=term-missing --cov-fail-under=80

# Вивід запуску 1 (часткові тести):
# FAIL Required test coverage of 80% not reached. Total coverage: 33.33%
# (код завершення 2)

# Вивід запуску 2 (повний тест-сьют):
# Required test coverage of 80% reached. Total coverage: 100.00%
# (код завершення 0)

# addopts застосовується до кожного запуску pytest автоматично -- і локально, і у CI
# використовуються ті самі налаштування без необхідності пам'ятати прапори.

Створіть файл `.coveragerc`, що виключає `tests/` і `setup.py` з вимірювання, а також рядки, що відповідають `"if __name__ == .__main__.:"`. Створіть `setup.py` з кількома рядками та `src/main.py` з функцією `run()` і блоком `if __name__ == "__main__":`. Запустіть coverage і переконайтеся, що ці файли і рядки не з'являються у звіті.

# .coveragerc  (створіть у кореневій директорії проекту)
[run]
omit =
    # додайте: tests/*
    # додайте: setup.py

[report]
exclude_lines =
    # додайте шаблон для захисту __main__


# setup.py
from setuptools import setup
setup(name='myproject', version='0.1')


# src/main.py
def run():
    print('running')

if __name__ == '__main__':
    run()

# Запуск: pytest --cov=src tests/
# setup.py і рядок __main__ не мають з'являтися у звіті

# .coveragerc
[run]
omit =
    tests/*
    setup.py

[report]
exclude_lines =
    if __name__ == .__main__.:
    raise NotImplementedError

[html]
directory = htmlcov


# setup.py
from setuptools import setup
setup(name='myproject', version='0.1')


# src/main.py
def run():
    print('running')

if __name__ == '__main__':
    run()

# Запуск: pytest --cov=src tests/
# setup.py не з'явиться; рядок __main__ виключений зі статистики

Додайте функцію `debug_print(a, b)` до `src/calculator.py`, що виводить обидва аргументи (два оператори print). Додайте `# pragma: no cover` до рядка визначення функції. Запустіть `pytest --cov=src --cov-report=term-missing tests/` з повним тест-сьютом з вправи 2. Переконайтеся, що рядки `debug_print` не з'являються у звіті. Потім видаліть pragma і запустіть знову -- переконайтеся, що рядки відображаються як пропущені.

# src/calculator.py  (додайте до існуючого файлу)

def add(a, b):
    return a + b

def divide(a, b):
    if b == 0:
        raise ZeroDivisionError('cannot divide by zero')
    return a / b

def absolute_value(x):
    if x < 0:
        return -x
    return x

def debug_print(a, b):  # додайте сюди pragma: no cover
    print(f'debug: a={a}, b={b}')
    print(f'debug: sum={a + b}')

# Запуск: pytest --cov=src --cov-report=term-missing tests/
# З pragma: рядки debug_print НЕ мають бути у Missing
# Без pragma: вони з'являються як не покриті

# src/calculator.py

def add(a, b):
    return a + b

def divide(a, b):
    if b == 0:
        raise ZeroDivisionError('cannot divide by zero')
    return a / b

def absolute_value(x):
    if x < 0:
        return -x
    return x

def debug_print(a, b):  # pragma: no cover
    print(f'debug: a={a}, b={b}')
    print(f'debug: sum={a + b}')

# Запуск: pytest --cov=src --cov-report=term-missing tests/
# З pragma: покриття 100%, debug_print відсутня у статистиці
# Без pragma: покриття падає і рядки 17-18 з'являються у Missing