k11. Тесты pytest и заглушки

Задача 11.1. Модуль battery под тестами

Файл практики: k11_battery.py.

Разместите в проекте модуль с функциями classify_voltage и alt_cm_to_m. Это код, который будут проверять тесты, а не «скрипт с print».

Ожидаемый результат. Файл импортируется без ошибок: from k11_battery import classify_voltage.

• Полный текст файла k11_battery.py

  Скопируйте приведённое ниже содержимое в файл code/M01_python/k11_battery.py в проекте PyCharm (виртуальное окружение) и запустите программу. Ниже приведён полный учебный текст файла с комментариями.

  # k11_battery.py
  # Учебный модуль под тесты K11 (не драйвер реального датчика).
  
  def classify_voltage(voltage_v: float, low_v: float = 14.4, critical_v: float = 14.0) -＞ str:
      """Вернуть учебную метку OK / LOW / CRITICAL по напряжению."""
      if voltage_v ＞= low_v:
          return "OK"
      if voltage_v ＞= critical_v:
          return "LOW"
      return "CRITICAL"
  
  
  def alt_cm_to_m(alt_cm: int) -＞ float:
      """Перевести высоту из сантиметров в метры."""
      if alt_cm ＜ 0:
          raise ValueError(f"alt_cm must be ＞= 0, got {alt_cm}")
      return alt_cm / 100.0

Задача 11.2. Тесты battery

Файл практики: k11_task1_test_battery.py.

Напишите тесты на OK/LOW/CRITICAL, на перевод сантиметров в метры и на ValueError при отрицательной высоте.

Ожидаемый результат. Команда python -m pytest k11_task1_test_battery.py -v показывает все тесты passed.

• Полный текст файла k11_task1_test_battery.py

  Скопируйте приведённое ниже содержимое в файл code/M01_python/k11_task1_test_battery.py в проекте PyCharm (виртуальное окружение) и запустите программу. Ниже приведён полный учебный текст файла с комментариями.

  # k11_task1_test_battery.py
  # Цель: первые unit-тесты pytest для чистых функций.
  # Запуск из каталога code/M01_python:
  #   python -m pytest k11_task1_test_battery.py -v
  
  import pytest
  
  from k11_battery import alt_cm_to_m, classify_voltage
  
  
  def test_classify_ok():
      assert classify_voltage(15.0) == "OK"
  
  
  def test_classify_low():
      assert classify_voltage(14.2) == "LOW"
  
  
  def test_classify_critical():
      assert classify_voltage(13.5) == "CRITICAL"
  
  
  def test_alt_cm_to_m():
      assert alt_cm_to_m(1530) == 15.3
  
  
  def test_alt_cm_rejects_negative():
      with pytest.raises(ValueError):
          alt_cm_to_m(-1)

Задача 11.3. Модуль loader

Файл практики: k11_loader.py.

Разместите функцию load_mode(path), которая читает UTF-8 текст, разбирает JSON и возвращает поле mode.

Ожидаемый результат. Импорт from k11_loader import load_mode проходит успешно.

• Полный текст файла k11_loader.py

  Скопируйте приведённое ниже содержимое в файл code/M01_python/k11_loader.py в проекте PyCharm (виртуальное окружение) и запустите программу. Ниже приведён полный учебный текст файла с комментариями.

  # k11_loader.py
  # Загрузка JSON-телеметрии с диска — объект для mock Path/read в тестах.
  
  import json
  from pathlib import Path
  
  
  def load_mode(path: Path) -＞ str:
      """Прочитать JSON-файл и вернуть поле mode как str.
  
      Ожидается объект вида {"mode": "GUIDED", ...}.
      """
      text = path.read_text(encoding="utf-8")
      data = json.loads(text)
      if "mode" not in data:
          raise KeyError("mode")
      return str(data["mode"])

Задача 11.4. Тесты loader с MagicMock

Файл практики: k11_task2_test_loader_mock.py.

Подмените Path.read_text. Проверьте успешный mode, отсутствие ключа mode (KeyError) и повреждённый JSON.

Ожидаемый результат. pytest по файлу k11_task2_test_loader_mock.py — все passed; для успешного теста есть assert_called_once_with(encoding="utf-8").

• Полный текст файла k11_task2_test_loader_mock.py

  Скопируйте приведённое ниже содержимое в файл code/M01_python/k11_task2_test_loader_mock.py в проекте PyCharm (виртуальное окружение) и запустите программу. Ниже приведён полный учебный текст файла с комментариями.

  # k11_task2_test_loader_mock.py
  # Цель: mock объекта Path — не читать реальный диск.
  # Запуск:
  #   python -m pytest k11_task2_test_loader_mock.py -v
  
  from pathlib import Path
  from unittest.mock import MagicMock
  
  import pytest
  
  from k11_loader import load_mode
  
  
  def test_load_mode_ok():
      fake_path = MagicMock(spec=Path)
      fake_path.read_text.return_value = '{"mode": "GUIDED", "altitude_m": 10}'
      assert load_mode(fake_path) == "GUIDED"
      fake_path.read_text.assert_called_once_with(encoding="utf-8")
  
  
  def test_load_mode_missing_key():
      fake_path = MagicMock(spec=Path)
      fake_path.read_text.return_value = '{"altitude_m": 10}'
      with pytest.raises(KeyError):
          load_mode(fake_path)
  
  
  def test_load_mode_bad_json():
      fake_path = MagicMock(spec=Path)
      fake_path.read_text.return_value = "{not-json"
      with pytest.raises(Exception):
          # json.JSONDecodeError — подкласс Exception
          load_mode(fake_path)

Задача 11.5. Напоминание команды прогона

Файл практики: k11_task3_run_pytest_note.py.

Откройте файл-памятку и выполните команды установки pytest и совместного прогона обоих наборов тестов из комментариев.

Ожидаемый результат. В конце прогона pytest: all passed для task1 и task2.

• Полный текст файла k11_task3_run_pytest_note.py

  Скопируйте приведённое ниже содержимое в файл code/M01_python/k11_task3_run_pytest_note.py в проекте PyCharm (виртуальное окружение) и запустите программу. Ниже приведён полный учебный текст файла с комментариями.

  # k11_task3_run_pytest_note.py
  # Напоминание команд (выполните в venv, каталог code/M01_python).
  #
  # python -m pip install pytest
  # python -m pytest k11_task1_test_battery.py k11_task2_test_loader_mock.py -v
  #
  # Ожидается: все тесты passed.
  
  print("Install pytest in venv if needed, then run the pytest command from comments above.")

Задача 11.6. Команда прогона (обязательно выполнить)

В терминале с активным venv и текущим каталогом code/M01_python выполните:

# Каталог: code/M01_python  (venv активен)
python -m pip install pytest
python -m pytest k11_task1_test_battery.py k11_task2_test_loader_mock.py -v

Задача 11.7. Сохранение в Git

git add code/M01_python/k11_*.py
git commit -m "K11: pytest unit tests and Path mock"