Создание первого файла с тестовыми данными: пошаговое руководство
03
Фикстура за минуту
От пустой папки до зелёного теста
У вас есть PHP-функция, которая форматирует итоговую сумму заказа, и вы хотите проверить её работу на нескольких наборах входных данных. CycleMantle выступает в роли генератора данных: он создаёт JSON-файл с вымышленными заказами, а затем пишет проверки, которые его читают. Ничего не берётся из реальных данных клиентов. С облачной моделью ваш запрос и текст файла, которые читает агент, отправляются этому провайдеру; с локальной моделью ничего не покидает ваш ПК. Рассчитывайте примерно на 4 коротких сообщения в чате: откройте папку, запросите записи, запросите проверки и запустите их. Каждое сообщение генерирует карточки, которые вы можете прочитать, принять или отклонить перед началом следующего шага. Читайте карточки сверху вниз: в каждой указан инструмент, файл или команда, которые он использовал, и полученный результат. Если вы предпочитаете читать перед выполнением, начните чат в режиме Plan only и переключитесь на Ask first после прочтения плана.
01
Откройте папку проекта
Запустите приложение, выберите папку с вашим PHP-кодом и выберите режим Ask first, чтобы каждое изменение ждало вашего подтверждения. Вы можете изменить режим позже, когда захотите, например, на Auto-run, когда будете уверены в шагах.
02
Запросите вымышленные записи
Опишите необходимые поля, такие как имя, дата и сумма, и запросите JSON-файл с вымышленными строками. Укажите, сколько строк вам нужно. Убедитесь, что каждое имя, адрес и сумма явно являются вымышленными, чтобы никто не принял строку за реального человека.
03
Запросите проверки
Запросите небольшой тестовый скрипт, который читает JSON-файл и сравнивает известные входные данные с ожидаемыми результатами. Укажите имя функции, которую нужно протестировать. Попросите агента объяснить каждую проверку в одной строке, чтобы вы понимали, что она должна выявить.
04
Проверьте и запустите
Прочитайте diff, примите его и позвольте Shell запустить вашу тестовую команду. Затем прочитайте код выхода и раскройте карточку, чтобы увидеть вывод. Если проверка не прошла, попросите агента объяснить причину сбоя, прежде чем он внесёт какие-либо изменения.
Небольшой тестовый скрипт для начала
CycleMantle · Фикстура и проверки● Ask first
Создайте tests/orders.json с 3 вымышленными заказами и скриптом, который проверяет функцию скидки.
write_filetests/orders.jsonsaved
write_filetests.phpsaved
Shellyour test commandexit 0
read_filetests.phploaded
ждёт вашего подтверждения перед следующим шагомОтклонитьПринять
Одна простая функция и четыре проверки assert с известными входными данными и результатами. Она не использует базу данных, сеть или секреты. Позже агент может заменить фиксированные числа строками из вашего JSON-файла, а структура проверок останется прежней. Намеренно измените одно ожидаемое значение, чтобы увидеть сбой. Сохраните его как tests.php в папке вашего проекта, запустите с помощью вашей тестовой команды и прочитайте код выхода в карточке, прежде чем запрашивать что-либо ещё. Затем намеренно измените одно ожидаемое значение и наблюдайте, как карточка станет красной.
Четыре задачи для инструментов генерации тестовых данных
Создайте тестовые записи
Многие задаются вопросом, как генерировать тестовые данные быстрее, чем вручную. Опишите желаемую структуру и позвольте агенту создать её: JSON-файл с 3 вымышленными клиентами, каждый из которых имеет имя, дату регистрации и сумму заказа. Среди инструментов генерации тестовых данных простой файл в вашем проекте легче всего читать и изменять позже, так как diff показывает каждое значение. Команды glob и list_dir показывают, где уже находятся фикстуры, поэтому новый файл появится рядом с остальными. Откройте карточку, убедитесь, что каждое значение явно вымышленное, и отредактируйте странные строки вручную перед принятием. Используйте зарезервированные домены для примеров в адресах электронной почты. Запросите несколько строк, а не сотни, чтобы вы могли прочитать каждую. Записывайте даты в одном фиксированном формате, чтобы все строки выглядели одинаково.
Создайте проверки, которые читают файл
Запросите скрипт, который загружает JSON и проверяет один результат для каждой строки. Агент открывает ваш исходный код с помощью read_file, находит функцию с помощью grep и предлагает тестовый файл в виде diff. Мокание статических методов в php затруднительно, поэтому попросите агента перечислить статические вызовы перед тем, как что-либо писать, и оставьте эти вызовы за небольшой функцией, которую тест может заменить. Режим Ask first удерживает изменение до вашего принятия. Прочитайте каждое утверждение и спросите, не провалится ли оно, если функция будет работать неверно. Отклоните любую проверку, которая просто повторяет тестируемый код. Затем добавьте одну строку, которая должна намеренно завершиться ошибкой. Если агент не может определить, какую функцию вы имеете в виду, укажите её имя в запросе и упомяните файл. Держите одну концепцию в одном тесте.
Запустите тесты и прочитайте код выхода
Shell запускает вашу тестовую команду в выбранной вами среде, например, локальной Windows, WSL или SSH на сервере, которым вы владеете. Карточка показывает реальный код выхода, и нулевой код выхода означает, что все проверки прошли успешно, а любое другое значение означает сбой. Раскройте карточку, чтобы прочитать вывод построчно. Если что-то не прошло, агент читает сообщение и предлагает исправление в виде diff. Не принимайте исправление только потому, что запуск стал зелёным. Сначала проверьте ожидаемое значение в тесте. Если следует второй сбой, попросите агента объяснить первый, прежде чем он внесёт изменения. Режим Plan only — хороший первый проход, если команда вам незнакома, так как в этом случае агент сначала составляет план и ничего не запускает.
Решите, какой код нуждается в тесте
После прохождения тестов запустите команду покрытия кода и позвольте агенту прочитать отчёт. Команды спорят, включать ли инфраструктурный код в покрытие кода, и разумный ответ — договориться об этом до того, как число станет целью. Некоторые команды также требуют обязательного покрытия тестами критических методов, таких как проверка цены или разрешений. Попросите агента перечислить эти методы с помощью grep и предложить тесты для первого из них. Проверьте diff, снова запустите тесты и остановитесь, когда критические пути будут покрыты. Запишите, какие папки вы учли, чтобы показатели следующего месяца были сопоставимы. Попросите агента поместить список учтённых папок в обычный текстовый файл в вашем проекте и прочитайте diff перед принятием.