From 56740972675eacf52d9981c32aa023670178af40 Mon Sep 17 00:00:00 2001 From: Andrey Epifancev Date: Sun, 4 Oct 2026 07:17:53 +0400 Subject: [PATCH] =?UTF-8?q?docs(dev):=20=D0=BF=D1=80=D0=B8=D1=87=D0=B8?= =?UTF-8?q?=D0=BD=D0=B0=20=D0=BD=D0=B5=20=D0=B7=D0=B0=D0=BF=D1=83=D1=81?= =?UTF-8?q?=D0=BA=D0=B0=D1=82=D1=8C=20make=20-j=20=E2=80=94=20=D0=BF=D0=B0?= =?UTF-8?q?=D1=80=D0=B0=D0=BB=D0=BB=D0=B5=D0=BB=D1=8C=D0=BD=D1=8B=D0=B5=20?= =?UTF-8?q?=D0=BF=D1=80=D0=B5=D1=80=D0=B5=D0=BA=D0=B2=D0=B8=D0=B7=D0=B8?= =?UTF-8?q?=D1=82=D1=8B=20check,=20=D0=B0=20=D0=BD=D0=B5=20check-full?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 5.5 --- dev/Makefile.common | 3 ++- dev/checks.md | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/dev/Makefile.common b/dev/Makefile.common index 37b03ce..f9be8ee 100644 --- a/dev/Makefile.common +++ b/dev/Makefile.common @@ -21,7 +21,8 @@ # test-integration docker-build web-check). Собственные цели сервиса (migrate, seed, web-check ...) # определяются в его Makefile, не здесь. # -# Запускайте без `make -j`: шаги check-full вызываются последовательно через $(MAKE) и останавливаются на первой ошибке. +# Запускайте без `make -j`: шаги check-full вызываются последовательно через $(MAKE) и при -j, но `check: lint test` — +# пререквизиты, и при -j `lint` и `test` идут параллельно, поэтому остановка на первой упавшей проверке не гарантируется. VENV ?= api/.venv BIN ?= $(CURDIR)/$(VENV)/bin diff --git a/dev/checks.md b/dev/checks.md index f53c388..37176ff 100644 --- a/dev/checks.md +++ b/dev/checks.md @@ -20,13 +20,13 @@ | `make lint` | `ruff check .`, `ruff format --check .`, `mypy src` (в `arm-core` — `mypy src scripts`) | нет | | `make test` | `pytest -m "not integration"`: юнит-тесты; **включает тест идентичности вендоренного контракта** `api/contracts/` с `../docs/contracts` | нет | | `make test-integration` | `pytest -m integration` против инфраструктуры compose (PostgreSQL 16, NATS, MinIO; бакет `arm-ka` должен существовать, его создаёт `make up`) | да, `make up` | -| `make check` | `make lint` затем `make test`; останавливается на первой упавшей проверке | нет | +| `make check` | `make lint` затем `make test`; останавливается на первой упавшей проверке (только при последовательном запуске: `lint` и `test` — пререквизиты, при `make -j` они идут параллельно) | нет | | `make check-full` | `make check` + `make test-integration` + сборка docker-образа (`docker build`); для `arm-core` — расширенный набор, см. ниже | да, `make up` и Docker | | `make up` | поднимает инфраструктуру из `../docs/dev/docker-compose.yml`; постоянные сервисы `postgres`, `nats`, `minio` | Docker | Сводка шагов `make check`: `ruff check .` → `ruff format --check .` → `mypy src` (в `arm-core` — `mypy src scripts`) → `pytest -m "not integration"`. -Любой ненулевой код останавливает цель на этом шаге, следующие не выполняются. `make check` не требует Docker, +Любой ненулевой код останавливает цель на этом шаге, следующие не выполняются. Запускайте без `-j`: при параллельной сборке шаги идут одновременно. `make check` не требует Docker, PostgreSQL, NATS и сети. ### `make up`