$ sudo teach IT
Модуль 3 · В работе · Урок 3.2

Старый проект на uv

Запустите чужой проект с requirements.txt через uv и переведите его на pyproject.toml.

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

Не все проекты начинались с uv init. Многие живут с requirements.txt — списком пакетов для pip. Возьмём папку old: в ней main.py и строка pyfiglet==1.0.4. Путей два.

Структура проекта
old/
├── main.py
└── requirements.txt

Быстро, как раньше

Привычные venv и pip заменяем на uv: то же самое, только быстрее. Проект не меняется.

Терминал
$ uv venv
Using CPython 3.15.2 interpreter at: ~/.local/bin/python3.15
Creating virtual environment at: .venv
Activate with: source .venv/bin/activate
$ uv pip install -r requirements.txt
Resolved 1 package
Installed 1 package
 + pyfiglet==1.0.4

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

  • uv venv — создать окружение .venv (коробку с пакетами).
  • uv pip install -r requirements.txt — поставить всё из списка, как это делал pip.

Активируйте окружение и запускайте как обычно:

Терминал
$ source .venv/bin/activate
$ python main.py
       _     _
  ___ | | __| |
 / _ \| |/ _` |
| (_) | | (_| |
 \___/|_|\__,_|
Терминал · PowerShell
PS> .venv\Scripts\activate
PS> python main.py

Переезд насовсем

Проект ваш? Сделайте его проектом uv. Это второй путь вместо первого: папка без .venv.

Терминал
$ cd old
$ uv init --bare
Initialized project `old`
$ uv add -r requirements.txt
Using CPython 3.15.2 interpreter at: ~/.local/bin/python3.15
Creating virtual environment at: .venv
Resolved 2 packages
Installed 1 package
 + pyfiglet==1.0.4
$ uv run main.py
       _     _
  ___ | | __| |
 / _ \| |/ _` |
| (_) | | (_| |
 \___/|_|\__,_|

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

  • uv init --bare — создать только pyproject.toml, без src и README.md.
  • uv add -r requirements.txt — перенести пакеты в проект; появились .venv и uv.lock.
  • uv run main.py — запустить; активировать ничего не нужно.
TOML · pyproject.toml
[project]
name = "old"
version = "0.1.0"
requires-python = ">=3.15"
dependencies = [
    "pyfiglet==1.0.4",
]

Когда все перешли на uv, requirements.txt можно удалить.

Что выбрать

СитуацияКоманды
Чужой проект, не хочу ничего менятьuv venv и uv pip install -r requirements.txt
Мой проектuv init --bare и uv add -r requirements.txt

Частая ошибка: ModuleNotFoundError

Запустили python3 main.py, не активировав .venv: работает системный Python, а пакет лежит в коробке.

Вывод
Traceback (most recent call last):
  File "~/old/main.py", line 1, in <module>
    import pyfiglet
ModuleNotFoundError: No module named 'pyfiglet'

Лечится активацией .venv или командой uv run main.py.

Попробуйте

В двух копиях old выполните uv venv и uv init --bare, затем посмотрите файлы (в PowerShell — ls):

Терминал
$ ls -A
.venv  main.py  requirements.txt

$ ls -A
main.py  pyproject.toml  requirements.txt

Первая получила окружение, вторая — файл проекта.

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

  • Чужой проект: uv venv и uv pip install -r requirements.txt.
  • Свой проект: uv init --bare и uv add -r requirements.txt, запуск — uv run main.py.
  • Без активации .venv пакетов не видно; uv run активации не требует.

Со старыми проектами разобрались. Вернёмся к banner и посмотрим, как uv собирает его в Docker и проверяет в CI.

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