Пакеты проекта и его версию 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 с лишним импортом и кривым пробелом:
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?