$ sudo teach IT
Модуль 2 · Свой проект · Урок 2.4

Пакеты для разработки

Вы научитесь ставить пакеты, нужные только вам, и запускать тесты одной командой.

Теория + практика~5 минутНовичок

До сих пор мы добавляли пакет, без которого программа не работает (pyfiglet). Бывают и другие: нужные только вам, пока вы пишете код.

Пакеты «только для разработки»

Представьте строительные леса. Пока дом строят, они нужны, а жильцам — нет. Так и pytest — программа, которая запускает тесты: она нужна вам, а тому, кто запустит баннер, нет. Такие пакеты называют dev-зависимостями. Добавляем с флагом --dev:

Терминал
$ uv add --dev pytest
Вывод
Resolved 8 packages
Prepared 6 packages
Installed 6 packages
 ~ banner==0.1.0 (from file:///home/you/banner)
 + iniconfig==2.3.1
 + packaging==26.3
 + pluggy==1.7.0
 + pygments==2.21.0
 + pytest==9.2.0

В pyproject.toml появился новый раздел:

TOML · pyproject.toml
[dependency-groups]
dev = [
    "pytest>=9.2.0",
]

Разбор по строкам

  • [dependency-groups] — раздел для отдельных групп зависимостей.
  • dev = [...] — группа dev: сюда uv записал pytest, а dependencies не тронуты.

Код и тест

Чтобы было что проверять, вынесем надпись в отдельную функцию make_banner, а рядом положим тест в папку tests.

Python · src/banner/__init__.py
import pyfiglet


def make_banner(text: str) -> str:
    return pyfiglet.figlet_format(text)


def main() -> None:
    print(make_banner("uv"))
Python · tests/test_banner.py
from banner import make_banner


def test_banner_has_lines():
    assert len(make_banner("uv").splitlines()) > 1

Разбор по строкам

  • def make_banner(text: str) -> str — возвращает надпись, а не печатает её, поэтому её легко проверить.
  • print(make_banner("uv")) — main() печатает то, что вернула функция.
  • from banner import make_banner — тест берёт функцию из нашего пакета.
  • def test_banner_has_lines() — тест: имя начинается с test_, так pytest его находит.
  • assert len(...) > 1 — проверка: в надписи больше одной строки. Если условие верно, тест зелёный.

Запускаем тесты

Терминал
$ uv run pytest
Вывод
collected 1 item

tests/test_banner.py .                                                   [100%]

============================== 1 passed in 0.02s ===============================

Всё. Тест прошёл. Команда uv run берёт pytest из .venv проекта. Без неё pytest может не найтись. Подробно про тесты — в курсе Pytest.

Попробуйте

  • В tests/test_banner.py замените > 1 на > 100 и снова запустите uv run pytest.
  • Тест упадёт: 1 failed и assert 6 > 100 — строк в надписи шесть.
  • Верните > 1 — снова 1 passed.

Что запомнить

  • uv add --dev пакет ставит пакет, нужный только при разработке, и записывает его в [dependency-groups], группа dev.
  • Обычные зависимости остаются в dependencies.
  • uv run pytest запускает тесты проекта: 1 passed — всё хорошо.

Осталось решить, на какой версии Python живёт проект, — об этом в следующем уроке.

На следующий урок