Python-проект в 2026: uv + Ruff + Pyright за 10 минут | End Way — сообщество разработчиков и готовых решений
  • Больше материалов без ожидания и лишних условий
    Доступ к скрытым публикациям на 2 месяца, 3 месяца или навсегда. Ограничения «Команда форума» и «Личный» сохраняются.

    Сравнить варианты доступа →

    🔔 EndWay в Telegram

    Следите за новостями и релизами:
    EndWay | EndSoft

Python-проект в 2026: uv + Ruff + Pyright за 10 минут

Json Qiest

Что такое Бытие?
Автор темы
the VoX
15 Ноя 2022
824
574
🐍 Коротко: современный Python-проект можно собрать вокруг одного pyproject.toml, воспроизводимого uv.lock и четырёх понятных проверок.

Задача стека: uv управляет Python, окружением и зависимостями; Ruff отвечает за линтинг и форматирование; Pyright — за типы; pytest — за тесты.

1. Создаём проект​

uv init demo
cd demo
uv add fastapi
uv add --dev ruff pyright pytest
uv сам создаст .venv, запишет зависимости в pyproject.toml и сформирует uv.lock. Lock-файл стоит коммитить: разработчик, CI и сервер получат одинаковые версии пакетов.

2. Ежедневные команды​

uv run ruff check .
uv run ruff check --fix .
uv run ruff format .
uv run pyright
uv run pytest
Отдельно активировать окружение обычно не требуется: uv run запускает команду в окружении проекта.

  • 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 lock --check
uv sync --locked
uv run ruff check .
uv run ruff format --check .
uv run pyright
uv run pytest
Важный нюанс: uv sync по умолчанию делает точную синхронизацию и удаляет пакеты, которых нет в lock-файле. Это хорошо для воспроизводимости, но не направляйте его случайно в системный Python.

Итог​

Для большинства API, ботов и утилит этого достаточно. Более тяжёлые надстройки лучше добавлять только тогда, когда они действительно решают конкретную проблему.

Официальная документация​

А какой стек используете вы: Poetry, uv, PDM или старый requirements.txt? Если тема зайдёт — соберу готовый шаблон с GitHub Actions и Dockerfile.
 
Последнее редактирование:
  • 1
Реакции: 1 user
Активность:
Пока что здесь никого нет