🐍 Коротко: современный Python-проект можно собрать вокруг одного pyproject.toml, воспроизводимого uv.lock и четырёх понятных проверок.
Задача стека: uv управляет Python, окружением и зависимостями; Ruff отвечает за линтинг и форматирование; Pyright — за типы; pytest — за тесты.
1. Создаём проект
uv сам создаст .venv, запишет зависимости в pyproject.toml и сформирует uv.lock. Lock-файл стоит коммитить: разработчик, CI и сервер получат одинаковые версии пакетов.uv init demo
cd demo
uv add fastapi
uv add --dev ruff pyright pytest
2. Ежедневные команды
Отдельно активировать окружение обычно не требуется: uv run запускает команду в окружении проекта.uv run ruff check .
uv run ruff check --fix .
uv run ruff format .
uv run pyright
uv run pytest
- Ruff check находит ошибки и сортирует импорты.
- Ruff format приводит код к единому стилю.
- Pyright проверяет типы — Ruff его не заменяет.
- pytest запускает тесты.
3. Минимальный pyproject.toml
[tool.ruff]
line-length = 100
target-version = "py312"
[tool.ruff.lint]
select = ["E4", "E7", "E9", "F", "I", "B", "UP"]
[tool.ruff.format]
quote-style = "double"
docstring-code-format = true
[tool.pyright]
typeCheckingMode = "standard"
pythonVersion = "3.12"
Практический совет: начинайте с режима standard, а strict включайте после очистки старых ошибок. Иначе команда быстро привыкнет игнорировать сотни предупреждений.
4. Что поставить в CI
Важный нюанс: uv sync по умолчанию делает точную синхронизацию и удаляет пакеты, которых нет в lock-файле. Это хорошо для воспроизводимости, но не направляйте его случайно в системный Python.uv lock --check
uv sync --locked
uv run ruff check .
uv run ruff format --check .
uv run pyright
uv run pytest
Итог
Для большинства API, ботов и утилит этого достаточно. Более тяжёлые надстройки лучше добавлять только тогда, когда они действительно решают конкретную проблему.Официальная документация
А какой стек используете вы: Poetry, uv, PDM или старый requirements.txt? Если тема зайдёт — соберу готовый шаблон с GitHub Actions и Dockerfile. Последнее редактирование: