diff --git a/README.md b/README.md index 428e29e..48ab7d6 100644 --- a/README.md +++ b/README.md @@ -23,37 +23,6 @@ Если что‑то не работает — смотрите «Типичные проблемы» и «Быстрый reset» ниже. -## Локальное окружение разработчика - -Локальным окружением управляет [uv](https://docs.astral.sh/uv/) — он скачивает нужный Python и создаёт `.venv` на основе `pyproject.toml` / `uv.lock`. - -```bash -uv sync -``` - -`uv sync` сам подтянет версию Python из `.python-version`/`pyproject.toml`, создаст `.venv` и установит зависимости. Для тех же действий можно использовать `make dev-sync`. Цель `make dev-setup` (или вручную `uv python install` + `uv python pin`) нужна только когда вы меняете версию Python или прогреваете кэш. - -> Если требуется «классическое» активированное окружение, после `uv sync` выполните `.\.venv\Scripts\Activate.ps1` в PowerShell или `source .venv/bin/activate` в Unix-терминале. - -Проверки и форматирование выполняем через uv: - -```bash -make test # uv run pytest -q -make lint # black/isort в режиме проверки -make fmt # автоформатирование black + isort -``` - -### Быстрый старт с uv - -```bash -uv sync -uv run pytest -q -uv run black --check airflow tests -``` - -> Не устанавливайте пакеты напрямую через `pip install --user ...`. Если что-то уже попало в user-site, удалите `pip uninstall ` и проверьте `pip list --user`. ---- - ## 🚀 Быстрый старт (для новичков) ### Шаг 1: Подготовка окружения @@ -155,6 +124,38 @@ make gp-psql # Подключение к Greenplum --- +### Локальное окружение разработчика + +Локальным окружением управляет [uv](https://docs.astral.sh/uv/) — он скачивает нужный Python и создаёт `.venv` на основе `pyproject.toml` / `uv.lock`. + +```bash +uv sync +``` + +`uv sync` сам подтянет версию Python из `.python-version`/`pyproject.toml`, создаст `.venv` и установит зависимости. Для тех же действий можно использовать `make dev-sync`. Цель `make dev-setup` (или вручную `uv python install` + `uv python pin`) нужна только когда вы меняете версию Python или прогреваете кэш. + +> Если требуется «классическое» активированное окружение, после `uv sync` выполните `.\.venv\Scripts\Activate.ps1` в PowerShell или `source .venv/bin/activate` в Unix-терминале. + +Проверки и форматирование выполняем через uv: + +```bash +make test # uv run pytest -q +make lint # black/isort в режиме проверки +make fmt # автоформатирование black + isort +``` + +#### Быстрый старт с uv + +```bash +uv sync +uv run pytest -q +uv run black --check airflow tests +``` + +> Не устанавливайте пакеты напрямую через `pip install --user ...`. Если что-то уже попало в user-site, удалите `pip uninstall ` и проверьте `pip list --user`. +--- + + ## 📋 Что входит в стенд ### Основные компоненты