До сих пор мы добавляли пакет, без которого программа не работает (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 появился новый раздел:
[dependency-groups]
dev = [
"pytest>=9.2.0",
]
Разбор по строкам
[dependency-groups]— раздел для отдельных групп зависимостей.dev = [...]— группаdev: сюда uv записалpytest, аdependenciesне тронуты.
Код и тест
Чтобы было что проверять, вынесем надпись в отдельную функцию make_banner, а рядом положим тест в папку tests.
import pyfiglet
def make_banner(text: str) -> str:
return pyfiglet.figlet_format(text)
def main() -> None:
print(make_banner("uv"))
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 живёт проект, — об этом в следующем уроке.