partest-atlas

Агент сбора для «Вехи» — карты системы, раскрашенной тестами.

Пакет снимает наблюдения на прогоне автотестов и рядом с ним, складывает их в версионированные JSON-артефакты и на этом останавливается. Выводы из артефактов делает сервер «Веха» — отдельная программа, которая этот пакет не импортирует и не требуется ему для работы.

PyPI: partest-atlas · Лицензия: MIT

pip install partest-atlas

Зачем разделено так

Агент — измерительные приборы: он записывает, что клик ушёл в такой-то запрос, что за тест изменилось в счётчиках таблиц, какие смещения были у топиков до и после. Каждое наблюдение само по себе бесполезно.

Сервер — тот, кто из наблюдений делает вывод: «в таблицу писал не API, а консьюмер, потому что между последним пишущим запросом теста и изменением прошло событие шины».

Поэтому агент открыт: он ходит в базу, шину и логи заказчика, и его должна иметь возможность прочитать служба безопасности. Защищать здесь нечего — ценность не в сборе.

Что внутри

partest_atlas/
  artifacts.py      контракт артефактов: version, kind, scope, атомарная запись
  collect/          сборщики: схема БД, эффекты в БД, шина, логи контейнеров,
                    контракт OpenAPI, требования из спецификаций, поток UI
  adapters/         доступ к чужим системам: db/ bus/ containers/ ci/ tests/ contract/
  plugins/          pytest-плагины (entry point pytest11), молчат без переменных окружения
  wrap.py           `atlas wrap -- <любая команда>` — снимки до и после чужого прогона

Три уровня внедрения

Плагины подключаются через pytest11 и молчат, пока не выставлена соответствующая переменная окружения — обычный прогон не платит за их присутствие ничего.

Раскладка артефактов

atlas/<система>/<контур>/db_schema.json
atlas/<система>/<контур>/ui_flow.json
...

Заголовок каждого файла несёт version, kind, scope и время сбора, поэтому потребитель может честно сказать «артефакт старого формата», а не упасть на отсутствующем поле.

Отношение к partest

partest-atlas зависит от partest и переиспользует её, а не дублирует: сопоставление URL с шаблоном OpenAPI (partest.path_match), разбор контракта, редактирование секретов (partest.redact), маркер тестовых данных, покрытие по методике. Обратной зависимости нет и не будет: partest про partest-atlas не знает.

Статус

Ранняя разработка. Код переносится из прототипа (src/atlas проекта-прародителя) по плану в документации сервера.