Проект 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 только ставит, а записывать пакет в список — ваша забота.
dependencies = [
"pyfiglet>=1.0.4",
]
Это зависимость — пакет, который нужен проекту. >=1.0.4 значит «эта версия или новее».
Пишем код
Заменим содержимое 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. Что в нём и почему его не трогают руками — в следующем уроке.