CycleMantle
Робочі процеси

Інструкція: створення першого фіксту

03
Фіксту за хвилину

Від порожньої папки до зелених тестів

У вас є PHP-функція, що формує загальну суму замовлення, і ви хочете перевірити її на кількох вхідних даних. CycleMantle виступає як генератор даних: він створює JSON-файл із вигаданими замовленнями, а потім генерує перевірки, які його читають. Жодні дані реальних клієнтів не копіюються. З хмарною моделлю ваш запит і текст файлу надходять до провайдера; із локальною моделлю дані залишаються на вашому ПК. Розраховуйте приблизно на 4 короткі повідомлення в чаті: відкрийте папку, запитайте про записи, запитайте про перевірки та запустіть їх. Кожне повідомлення генерує картки, які ви можете прочитати, прийняти або відхилити перед початком наступного кроку. Читайте картки зверху вниз: кожна з них називає інструмент, файл або команду, які він використав, і отриманий результат. Якщо ви надаєте перевагу читанню перед виконанням, почніть чат у режимі Plan only і переключіться на Ask first після ознайомлення з планом.

01

Відкрийте папку проєкту

Запустіть додаток, виберіть папку, де міститься ваш PHP-код та оберіть режим затвердження Ask first, щоб кожна зміна чекала на ваше підтвердження. Ви можете змінити режим пізніше, коли захочете, наприклад, на Auto-run, коли переконатиметесь у правильності кроків.

02

Запитайте про вигадані записи

Опишіть потрібні поля, такі як ім'я, дата та сума, і запитайте про JSON-файл із вигаданими рядками. Вкажіть, скільки рядків вам потрібно. Переконайтеся, що кожне ім'я, адреса та сума є явно вигаданими, щоб ніхто не сплутав рядок із реальними даними людини.

03

Запитайте про перевірки

Запитайте про невеликий тестовий скрипт, який читає JSON-файл і порівнює відомі вхідні дані з очікуваними результатами. Вкажіть функцію, яку потрібно протестувати. Попросіть агента пояснити кожну перевірку одним реченням, щоб ви розуміли, яку помилку вона має виявляти.

04

Перегляд та запуск

Прочитайте diff, прийміть його та дозвольте Shell запустити вашу команду тестування. Потім прочитайте код виходу та розгорніть картку, щоб побачити вивід. Якщо перевірка не пройшла, запитайте агента пояснити причину збою, перш ніж він вносить будь-які зміни.

Невеликий тестовий скрипт для початку

tests.php
<?php
function discount(int $cents, int $percent): int {
    return intdiv($cents * (100 - $percent), 100);
}
assert(discount(1000, 0) === 1000);
assert(discount(1000, 10) === 900);
assert(discount(0, 50) === 0);
assert(discount(999, 100) === 0);
echo 'All checks ran';

Одна проста функція та чотири перевірки 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 перед прийняттям.

CycleMantle для Windows

Згенеруйте свій перший фіксту сьогодні

Завантажити CycleMantle ↗