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

Инструменты через uvx

Вы научитесь запускать программы-инструменты одной командой, ничего не устанавливая.

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

Пакеты проекта и его версию Python вы вести умеете. А как быть с программами, которые просто помогают писать код?

uvx: запустить и забыть

Помните --with: взяли на один раз и вернули. С программами-инструментами так же. Возьмём Ruff — он читает код и ищет ошибки и лишнее. В папке banner запустите:

Терминал
$ uvx ruff check
Вывод
All checks passed!

Всё. Ничего не устанавливали: uv сам скачал Ruff во временное окружение, запустил и забыл. uvx — короткое имя для uv tool run.

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

  • uvx ruff check — запустить инструмент ruff с командой check («проверь»).
  • All checks passed! — замечаний нет, код чистый.

Проект при этом не меняется. Если же инструменту нужен сам проект (как pytest), берите uv run.

Найдём замечание

Создайте src/banner/extra.py с лишним импортом и кривым пробелом:

Python · src/banner/extra.py
import os

print( "hi" )
Терминал
$ uvx ruff check
Вывод
F401 [*] `os` imported but unused
 --> src/banner/extra.py:1:8
  |
1 | import os
  |        ^^
2 |
3 | print( "hi" )
  |
help: Remove unused import: `os`
  |
  - import os
1 |
  |

Found 1 error.
[*] 1 fixable with `--fix`.

F401: os импортирован, но не нужен. Пометка [*] — Ruff исправит сам:

Терминал
$ uvx ruff check --fix
$ uvx ruff format
Вывод
Found 1 error (1 fixed, 0 remaining).
1 file reformatted, 3 files left unchanged

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

  • check --fix — убирает то, что можно исправить безопасно: import os пропал.
  • ruff format — приводит код к единому виду: print( "hi" ) стало print("hi").

Версия и установка насовсем

Нужна самая свежая версия? Допишите @latest:

Терминал
$ uvx ruff@latest check

А если инструмент нужен каждый день, поставьте его насовсем:

Терминал
$ uv tool install ruff
$ ruff --version
Вывод
Installed 1 executable: ruff
ruff 0.17.5

Теперь ruff работает в любой папке без uvx. Если uv предупредит про PATH, выполните uv tool update-shell и откройте терминал заново.

Про Ruff подробно — в бесплатном курсе Ruff для начинающих (те же авторы, что у uv).

Попробуйте

  • Допишите в начало src/banner/extra.py строку import sys и снова запустите uvx ruff check: Ruff найдёт новый лишний импорт с тем же кодом F401.
  • Когда наиграетесь, удалите файл src/banner/extra.py: он был нужен только для опыта.

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

  • uvx инструмент (то же, что uv tool run) запускает программу без установки, во временной коробке.
  • uvx ruff@latest берёт свежую версию, uv tool install ruff ставит инструмент насовсем.
  • Разово — uvx, везде и всегда — uv tool install, в одном проекте — uv add --dev.

А что делать со старым проектом, который живёт на pip и requirements.txt?

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