Запуск тестов
Shell запускает вашу команду тестирования, а карточка показывает реальный код выхода и полный вывод.
Мок API — это замена реального сервиса: он возвращает фиксированные ответы из файла, поэтому ваши тесты ведут себя одинаково при каждом запуске. CycleMantle создаёт этот файл, генерирует тестовые данные и запускает команду тестирования из чата, пока вы наблюдаете за каждым шагом. Вы решаете, какие предложения агента попадут в ваш проект.
Shell запускает вашу команду тестирования, а карточка показывает реальный код выхода и полный вывод.
write_file и edit_file предлагают тесты и фикстуры в виде диффа, который вы принимаете или отклоняете.
read_file и grep открывают отчёты и логи, чтобы агент мог указать строки, которые ещё не покрыты тестами.
Вы описываете задачу в чате. Агент читает ваш код, запускает команды и показывает каждый результат в виде карточки, затем ожидает вашего решения, прежде чем что-либо изменится в режиме Ask first. Plan only появляется первым, когда вы хотите прочитать шаги перед их запуском. Каждая карточка остаётся в чате, поэтому вы можете прокрутить назад и увидеть, что было запущено.
src/RateClient.phploadedtests/fixtures/rates.jsonsavedtests/RateClientTest.phpsavedyour test commandexit 0rates.json2 matchestests/RateClientTest.phpdiff shownВаш класс запрашивает у сервиса курсов валют число, и тест не должен зависеть от живого сервера. Попросите агента создать мок API: read_file загружает класс клиента, write_file сохраняет tests/fixtures/rates.json с фиксированными ответами, а edit_file изменяет тест так, чтобы он читал этот файл вместо вызова внешнего сервиса. Вызов реальных функций в настройке unit-теста делает тест зависимым от кода, который вы не собирались проверять, поэтому держите фикстуру небольшой и называйте её в соответствии с вызовом, который она заменяет. Ask first показывает дифф перед сохранением. Примите его, позвольте Shell запустить вашу команду тестирования и прочитайте код выхода. Затем раскройте карточку, чтобы подтвердить, что ответы в выводе — это вымышленные данные. Если в выводе указан адрес реального сервера, остановитесь и исправьте тест.
Для класса отчёта вам может потребоваться 3 пользователя с именами, датами и суммами. Генерация тестовых данных здесь означает, что агент создаёт JSON-файл с вымышленными людьми; он никогда не копирует строки из реального списка клиентов. Среди инструментов, которые тестировщики используют для генерации тестовых данных, обычный файл, созданный агентом, легко проверить в диффе и легко изменить позже. Используйте glob, чтобы сначала найти существующие фикстуры, чтобы новый файл не конфликтовал с уже занятым именем. Откройте файл в чате, вручную исправьте любые странные значения, добавьте одну строку с пустым именем, чтобы покрыть граничный случай, и снова запустите тесты. Делайте имена явно вымышленными. Закоммитьте файл вместе с вашим кодом, чтобы коллеги делились теми же данными.
Запустите команду покрытия через Shell, затем попросите агента прочитать отчёт с помощью read_file. Он укажет функции, строки которых никогда не выполнялись, и предложит тесты для них в виде диффа. Люди часто спрашивают, что тестировать в unit-тесте, и ответ начинается с малого: один нормальный ввод, один граничный, например пустой список, и одно некорректное значение. Принимайте тесты по одному, а не все сразу, чтобы замечать слабые места. Более высокий процент всё ещё не доказывает, что код корректен. Сохраняйте критичность. Читайте каждое утверждение самостоятельно и спрашивайте, упало бы оно, если бы функция была неверной. После последнего принятого теста запустите команду в последний раз. Повторяйте, пока самые важные файлы не получат тесты, которым вы доверяете.
Когда тест падает, карточка показывает реальный вывод вашей команды тестирования. Попросите агента прочитать тест и тестируемый класс с помощью read_file, затем объясните несоответствие. Он может использовать grep, чтобы найти место, где формируется значение, и предложить исправление в виде диффа. Люди спрашивают, почему мокинг вызывает проблемы, и один из ответов заключается в том, что фиктивный ответ может отклониться от реального сервиса. Сравните фикстуру с сервисом, которым вы владеете, примите дифф только если он совпадает, и снова запустите команду. Если тот же тест падает дважды, переключитесь на Plan only и попросите объяснения перед любым дальнейшим редактированием. Сохраняйте вывод упавшего теста до принятия исправления.
CycleMantle — это не хостинговый сервис и не плагин. Он предназначен только для ваших собственных файлов, вашего собственного ПК и серверов, которыми вы имеете право пользоваться, и вы решаете, какие папки, команды и серверы может затрагивать агент, потому что Shell, веб и SSH не ограничены рабочей папкой. Пройденные тесты не гарантируют, что код корректен.