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

Создайте `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`. Запустите покрытие снова и убедитесь, что достигнуто 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__":`. Запустите покрытие и убедитесь, что эти файлы и строки не появляются в отчёте.

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

[report]
exclude_lines =
    # добавить паттерн guard __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