Запуск тестів
Shell запускає вашу тестову команду, а картка показує реальний код виходу та повний вивід.
Заглушка API — це імітація реальної служби: вона повертає фіксовані відповіді з файлу, тому тести ведуть себе однаково кожного разу. CycleMantle записує цей файл, створює вибіркові тестові записи та запускає вашу тестову команду з чату, поки ви спостерігаєте за кожним кроком. Ви вирішуєте, які пропозиції потраплять у ваш проєкт.
Shell запускає вашу тестову команду, а картка показує реальний код виходу та повний вивід.
write_file та edit_file пропонують тести та фікстури у вигляді diff, який ви приймаєте або відхиляєте.
read_file та grep відкривають звіти та логи, щоб агент міг вказати рядки, які ще не протестовано.
Ви описуєте завдання в чаті. Агент читає ваш код, запускає команди та показує кожен результат як картку, а потім чекає на ваше рішення, перш ніж щось зміниться в режимі Ask first. Plan only спрацьовує першим, коли ви хочете прочитати кроки, перш ніж вони запустяться. Кожна картка залишається в чаті, тому ви можете прокрутити історію назад і побачити, що запустилося.
src/RateClient.phpзавантаженоtests/fixtures/rates.jsonзбереженоtests/RateClientTest.phpзбереженоyour test commandexit 0rates.json2 знахідкиtests/RateClientTest.phpdiff показаноВаш клас запитує у служби курсів валют число, і тест не повинен залежати від живого сервера. Попросіть агента створити заглушку API: read_file завантажує клінт, write_file зберігає тестові дані у файлі tests/fixtures/rates.json з фіксованими відповідями, а edit_file змінює тест так, щоб він читав цей файл замість зовнішнього виклику. Виклик реальних функцій під час налаштування юніт-тесту робить тест залежним від коду, який ви не планували перевіряти, тому тримайте фікстуру мінімальною і називайте її на честь виклику, який вона замінює. Ask first показує diff перед тим, як щось буде збережено. Прийміть його, дозвольте Shell запустити вашу тестову команду та прочитайте код виходу. Потім розгорніть картку, щоб підтвердити, що відповіді у виводі є вигаданими. Якщо у виводі показано адресу реального сервера, зупиніться та виправте тест.
Для класу звітів вам може знадобитися 3 користувачі з іменами, датами та сумами. Генерація тестових даних тут означає, що агент записує JSON-файл із вигаданими людьми; він ніколи не копіює рядки зі справжнього списку клієнтів. Серед інструментів, які тестувальники використовують для генерації тестових даних, звичайний файл, який записує агент, легко переглянути в diff та легко змінити пізніше. Використовуйте glob, щоб спочатку знайти існуючі фікстури, щоб новий файл не конфліктував із вже зайнятим ім'ям. Відкрийте файл у чаті, вручну виправте будь-яке дивне значення, додайте один рядок із порожнім ім'ям, щоб покрити крайній випадок, і знову запустіть тести. Зберігайте імена явно вигаданими. Зафіксуйте файл разом із вашим кодом, щоб колеги ділилися однаковими даними.
Запустіть команду покриття коду через Shell, а потім попросіть агента прочитати звіт за допомогою read_file. Він вкаже функції, рядки яких ніколи не виконувалися, і запропонує тести для них у вигляді diff. Люди часто питають, що тестувати в юніт-тесті, і відповідь починається з малого: один нормальний вхід, один крайній випадок, наприклад, порожній список, та одне некоректне значення. Приймайте тести по одному, а не всі відразу, щоб помічати слабкі місця. Вищий відсоток все одно не доводить, що код правильний. Залишайтеся критичними. Читайте кожне твердження самостійно та запитуйте, чи впало б воно, якби функція була неправильною. Після останнього прийнятого тесту запустіть команду востаннє. Повторюйте, доки найважливіші файли не матимуть тестів, яким ви довіряєте.
Коли тест падає, картка показує реальний вивід вашої тестової команди. Попросіть агента прочитати тест та клас, який тестується, за допомогою read_file, а потім пояснити невідповідність. Він може використати grep, щоб знайти, де формується значення, і запропонувати виправлення у вигляді diff. Люди питають, чому мокування викликає проблеми, і одна з відповідей полягає в тому, що фальшива відповідь може відхилитися від реальної служби. Порівняйте фікстуру зі службою, якою ви володієте, приймайте diff лише якщо він відповідає, і знову запустіть команду. Якщо той самий тест падає двічі, переключіться на Plan only і запитайте пояснення перед будь-якими подальшими редагуваннями. Зберігайте вивід проваленого тесту, доки виправлення не буде прийнято.
CycleMantle — це не хостинговий сервіс чи плагін. Він призначений лише для ваших власних файлів, вашого власного ПК та серверів, якими ви маєте право користуватися, і ви вирішуєте, які папки, команди та сервери може торкатися агент, оскільки Shell, веб та SSH не обмежені робочою папкою. Пройдені тести не гарантують, що код правильний.