$ sudo teach IT
Модуль 1 · Знакомство · Урок 1.3

Первый запуск

Вы запустите Python-файл через uv и возьмёте пакет на один запуск — без установки.

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

uv у вас уже стоит. Давайте что-нибудь им запустим: это одна короткая команда.

Запуск файла: uv run

Создайте файл hi.py из одной строки. Затем запустите его не через python, а через uv run («uv, запусти»).

Python · hi.py
print("Привет от uv")
Терминал
$ uv run hi.py
Привет от uv

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

  • uv run hi.py — запускает файл, как python hi.py. Разница одна: Python для запуска выбирает сам uv.
  • Привет от uv — то, что напечатал ваш файл. Всё.

Нет Python? Не беда

Если подходящего Python на компьютере нет, uv скачает его сам. Вы увидите примерно такую строку, а потом обычный результат программы:

Вывод
Downloading cpython-3.10.22-macos-aarch64-none (download) (24.6MiB)
 Downloaded cpython-3.10.22-macos-aarch64-none (download)
Привет от uv

Версия и система в строке у вас будут свои. Скачанный Python лежит отдельно от системных: ничего не ломается.

Пакет на один запуск: --with

Иногда нужна чужая библиотека. Раньше для этого делали pip install — и пакет оставался в системе навсегда. Здесь проще, как взять инструмент напрокат: взяли, поработали, вернули. Измените hi.py, чтобы он рисовал надпись крупными буквами из символов (пакет pyfiglet):

Python · hi.py
import pyfiglet

print(pyfiglet.figlet_format("hi"))
Терминал
$ python hi.py
ModuleNotFoundError: No module named 'pyfiglet'

Python ругается: пакета нет. Скажем uv, чтобы он взял его на один запуск:

Терминал
$ uv run --with pyfiglet hi.py
Вывод
 _     _ 
| |__ (_)
| '_ \| |
| | | | |
|_| |_|_|
         

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

  • --with pyfiglet — «возьми пакет pyfiglet для этого запуска». uv кладёт его во временное окружение (изолированную коробку с пакетами).
  • После запуска коробка не нужна: в системе пакета нет, а python hi.py снова выдаст ModuleNotFoundError.

Попробуйте

Замените "hi" в figlet_format("...") на другое слово (латиницей — шрифт не знает кириллицу) и снова запустите uv run --with pyfiglet hi.py. Вы получите новую надпись. Весь вывод выше показан целиком, так что можно просто читать.

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

  • uv run hi.py запускает файл, а нужный Python uv находит или скачивает сам.
  • --with пакет даёт библиотеку только на один запуск.
  • Система остаётся чистой: ничего не устанавливается навсегда.

Скрипт — это хорошо, но для своей программы нужен проект, и uv делает его одной командой.

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