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

Добавляем пакеты

Вы сможете добавить пакет в проект одной командой и так же легко убрать его.

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

Проект banner пока печатает только Hello from banner!. Чтобы надпись стала крупной, нужен готовый пакет — и uv добавляет его одной командой.

Одна команда: uv add

Пакет — чужой готовый код. Лежат пакеты на PyPI, складе пакетов для Python. Нам нужен pyfiglet: он рисует слова крупными буквами. Команду выполняем в папке banner.

Терминал
$ uv add pyfiglet
Вывод
Resolved 2 packages in 1.73s
Prepared 2 packages in 19.19s
Installed 2 packages in 16ms
 ~ banner==0.1.0 (from file:///home/you/banner)
 + pyfiglet==1.0.4

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

  • Resolved 2 packages — uv подобрал пакеты: banner и pyfiglet.
  • + pyfiglet==1.0.4 — плюс значит «установлено», 1.0.4 — версия.

Одна команда сделала четыре вещи: скачала пакет, положила его в .venv (виртуальное окружение — коробка с пакетами проекта), записала в pyproject.toml и обновила uv.lock. pip install только ставит, а записывать пакет в список — ваша забота.

TOML · pyproject.toml
dependencies = [
    "pyfiglet>=1.0.4",
]

Это зависимость — пакет, который нужен проекту. >=1.0.4 значит «эта версия или новее».

Пишем код

Заменим содержимое src/banner/__init__.py:

Python · src/banner/__init__.py
import pyfiglet


def main() -> None:
    print(pyfiglet.figlet_format("uv"))

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

  • import pyfiglet — подключаем установленный пакет.
  • def main() -> None: — функция main, её вызывает команда banner; -> None — «ничего не возвращает».
  • pyfiglet.figlet_format("uv") — превращает "uv" в большую надпись из символов, print её печатает.
Терминал
$ uv run banner
Вывод
 _   ___   __
| | | \ \ / /
| |_| |\ V /
 \__,_| \_/

Готово. Пустые строки вокруг надписи добавляет сам пакет.

Посмотреть и убрать

uv tree показывает дерево зависимостей, uv remove убирает пакет.

Терминал
$ uv tree
$ uv remove pyfiglet
Вывод
Resolved 2 packages in 4ms
banner v0.1.0
└── pyfiglet v1.0.4

Под проектом banner висит пакет pyfiglet. После uv remove pyfiglet запись исчезает из pyproject.toml, а пакет — из .venv. Запуск uv run banner теперь даст ModuleNotFoundError: код просит пакет, которого нет. Он нам нужен, возвращаем:

Терминал
$ uv add pyfiglet

Попробуйте

  • В __init__.py замените вызов на pyfiglet.figlet_format("uv", font="slant") (шрифт).
  • Запустите uv run banner — буквы наклонятся:
Вывод
  __  ___   __
 / / / / | / /
/ /_/ /| |/ /
\__,_/ |___/

Потом верните figlet_format("uv").

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

  • uv add пакет ставит его в .venv и сам записывает в pyproject.toml и uv.lock.
  • uv remove пакет убирает пакет из проекта; uv tree показывает, что подключено.
  • Нет пакета в проекте — будет ModuleNotFoundError.

Каждый uv add обновляет файл uv.lock. Что в нём и почему его не трогают руками — в следующем уроке.

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