RSHB/arm-core
9
0
Fork 0
Code Issues 24 Pull Requests 4 Actions Packages Projects Releases Wiki Activity

statements-version: сверка checkout библиотеки с requirements.txt в make venv/install; тег — из requirements (AURORA-1677)

Browse Source 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Andrey Epifancev 2026-10-27 17:07:13 +04:00
parent 14d2904b48
commit 97896a4ec3
3 changed files with 21 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
Makefile
View File

@ -2,22 +2,35 @@
VENV := api/.venv
BIN := $(CURDIR)/$(VENV)/bin
STATEMENTS_DIR ?= ../pylib_ai_arm_statements
STATEMENTS_TAG ?= v0.1.1
# Тег выпуска библиотеки — по версии, закреплённой в api/requirements.txt
STATEMENTS_TAG ?= v$(shell sed -n 's/^pylib_ai_arm_statements==//p' api/requirements.txt)
COMPOSE_FILE ?= ../docs/dev/docker-compose.yml
# DBML относительно api/: и в основном workspace, и в worktree .wt/<срез>/ это соседний docs/
DBML ?= ../../docs/model/data-model-v5.23.dbml
.PHONY: venv install lint test test-integration e2e dbml-check migration-cycle check check-infra docker-build web-check statements-check check-full up migrate seed seed-dev
.PHONY: venv install statements-version lint test test-integration e2e dbml-check migration-cycle check check-infra docker-build web-check check-full up migrate seed seed-dev
# Сверка checkout библиотеки с версией из api/requirements.txt (pylib_ai_arm_statements==<версия>): VERSION checkout
# не равен закреплённой — ошибка; checkout не на теге v<версия> — предупреждение (правка библиотеки до выпуска).
# docker-build требует тег строго.
statements-version:
@ver=$$(cat "$(STATEMENTS_DIR)/VERSION" 2>/dev/null) || \
{ echo "Ошибка: нет $(STATEMENTS_DIR)/VERSION — клонируйте RSHB/pylib_ai_arm_statements рядом или задайте STATEMENTS_DIR" >&2; exit 1; }; \
[ "v$$ver" = "$(STATEMENTS_TAG)" ] || \
{ echo "Ошибка: в $(STATEMENTS_DIR) версия $$ver, в api/requirements.txt — $(STATEMENTS_TAG:v%=%)" >&2; exit 1; }; \
release=$$(git -C "$(STATEMENTS_DIR)" rev-parse -q --verify "refs/tags/$(STATEMENTS_TAG)^{commit}"); \
[ -n "$$release" ] && [ "$$release" = "$$(git -C "$(STATEMENTS_DIR)" rev-parse HEAD)" ] || \
echo "Предупреждение: $(STATEMENTS_DIR) не на теге $(STATEMENTS_TAG) — ставится рабочее дерево библиотеки"
# Python 3.11 (версия платформы); пропускаем внутренние raisa_* и устанавливаемые локально pylib_ai*
venv:
venv: statements-version
cd api && uv venv --python 3.11 --allow-existing .venv
cd api && grep -Ev '^(raisa_|pylib_ai)' requirements.txt | uv pip install --python .venv/bin/python -r -
cd api && grep -v '^-r' requirements-dev.txt | uv pip install --python .venv/bin/python -r -
uv pip install --python "$(BIN)/python" --reinstall-package pylib-ai-arm-statements "$(STATEMENTS_DIR)"
# Установить или переустановить Python-пакет из соседнего репозитория в окружение backend.
install:
install: statements-version
uv venv --python 3.11 --allow-existing "$(VENV)"
uv pip install --python "$(BIN)/python" --reinstall-package pylib-ai-arm-statements "$(STATEMENTS_DIR)"
@ -69,14 +82,6 @@ web-check:
cd web && npx tsc --noEmit
cd web && npm run build
# Историческая проверка копии api/arm_statements/ отключена: теперь это устанавливаемая библиотека.
# Обновление библиотеки из ../pylib_ai_arm_statements — make install.
ARM_KA_DOCS ?= ../docs
# statements-check:
# @rc=0; $(ARM_KA_DOCS)/scripts/sync-statements.sh --check --host-dir . || rc=$$?; \
# if [ $$rc -eq 10 ]; then echo "statements-check: ПРЕДУПРЕЖДЕНИЕ — впишите в описание PR"; \
# elif [ $$rc -ne 0 ]; then exit $$rc; fi
# Полная проверка перед PR. Порядок: быстрые без БД (check, dbml-check), затем БД/NATS из compose (test-integration),
# затем docker, затем web. Цикл миграций upgrade -> downgrade -> upgrade на чистой БД входит в test-integration
# (tests/test_migrations.py), поэтому отдельным шагом не гоняется: второй запуск только удлинил бы прогон. e2e — после

4
README.md
View File

@ -637,7 +637,9 @@ S3 (storage); без S3 — предупреждение в логе, цикл
зависимости `raisa_*` и `pylib_ai*` из `requirements.txt`, устанавливает dev-зависимости и локальную библиотеку
из `../pylib_ai_arm_statements`. После изменения библиотеки выполните `make install` для её переустановки
без повторной установки всех зависимостей. Другой путь задаётся через `STATEMENTS_DIR`:
`make venv STATEMENTS_DIR=/путь/к/репозиторию` или `make install STATEMENTS_DIR=/путь/к/репозиторию`. Исходники и YAML-правила меняются в репозитории библиотеки;
`make venv STATEMENTS_DIR=/путь/к/репозиторию` или `make install STATEMENTS_DIR=/путь/к/репозиторию`. Перед установкой обе цели сверяют checkout (`make statements-version`): его `VERSION` должен совпадать с версией
в `api/requirements.txt` (иначе ошибка), checkout не на теге `v<версия>` — предупреждение. `make docker-build` требует тег.
Исходники и YAML-правила меняются в репозитории библиотеки;
копирование в `api/arm_statements/` и `sync-statements` больше не используются. `service.statements_version` —
маркер `VERSION` библиотеки, если он есть, иначе версия установленного дистрибутива.