CycleMantle
Alur kerja

Panduan generator data untuk file fixture pertama Anda

03
Fixture dalam satu menit

Dari folder kosong hingga tes hijau

Anda memiliki fungsi PHP yang memformat total pesanan, dan Anda ingin fungsi itu diperiksa terhadap beberapa masukan. CycleMantle bertindak sebagai generator data: ia menulis file JSON berisi pesanan buatan, lalu menulis pemeriksaan yang membacanya. Tidak ada data yang disalin dari pelanggan asli. Dengan model cloud, prompt Anda dan teks file yang dibaca agen dikirim ke penyedia tersebut; dengan model lokal, tidak ada data yang keluar dari PC Anda. Rencanakan sekitar empat pesan obrolan pendek: buka folder, minta catatan, minta pemeriksaan, dan jalankan. Setiap pesan menghasilkan kartu yang dapat Anda baca, terima, atau tolak sebelum pesan berikutnya dimulai. Baca kartu dari atas ke bawah: setiap kartu menyebutkan alat, file, atau perintah yang digunakan, serta hasil yang diperoleh. Jika Anda lebih suka membaca sebelum apa pun dijalankan, mulai obrolan dalam mode Plan only dan beralih ke Ask first setelah Anda membaca rencana.

01

Buka folder proyek

Mulai aplikasi, pilih folder yang berisi kode PHP Anda, dan pilih Ask first sebagai mode persetujuan, sehingga setiap perubahan menunggu persetujuan Anda. Anda dapat mengubah mode ini kapan saja nanti, misalnya menjadi Auto-run setelah Anda mempercayai langkah-langkahnya.

02

Minta catatan buatan

Jelaskan bidang yang Anda butuhkan, seperti nama, tanggal, dan jumlah, dan minta file JSON berisi baris buatan. Sebutkan berapa banyak baris yang Anda inginkan. Pastikan setiap nama, alamat, dan jumlah jelas dibuat-buat, agar tidak ada yang mengira baris tersebut berasal dari orang sungguhan.

03

Minta pemeriksaan

Minta skrip tes kecil yang membaca file JSON dan membandingkan masukan yang diketahui dengan hasil yang diharapkan. Sebutkan nama fungsi yang harus diuji. Minta agen untuk menjelaskan setiap pemeriksaan dalam satu baris, agar Anda tahu apa yang harus ditangkapnya.

04

Tinjau dan jalankan

Baca diff, terima, dan biarkan Shell menjalankan perintah tes Anda. Kemudian baca kode keluar dan perluas kartu untuk melihat output. Jika ada pemeriksaan yang gagal, minta agen untuk menjelaskan kegagalan tersebut sebelum ia mengubah apa pun.

Skrip tes kecil untuk memulai

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';

Satu fungsi sederhana dan empat pemeriksaan assert dengan masukan dan hasil yang diketahui. Fungsi ini tidak menggunakan basis data, jaringan, atau rahasia. Nantinya, agen dapat mengganti angka tetap dengan baris dari file JSON Anda, dan pemeriksaan tetap memiliki bentuk yang sama. Ubah satu nilai yang diharapkan secara sengaja untuk melihat kegagalan. Simpan sebagai tests.php di folder proyek Anda, jalankan dengan perintah tes Anda, dan baca kode keluar dalam kartu sebelum meminta apa pun lagi. Kemudian ubah satu nilai yang diharapkan secara sengaja dan lihat kartu berubah menjadi merah.

Empat tugas untuk alat generator data tes

Tulis catatan contoh

Banyak orang bertanya-tanya cara menghasilkan data tes lebih cepat daripada secara manual. Jelaskan bentuk yang Anda inginkan dan biarkan agen menulisnya: file JSON dengan 3 pelanggan buatan, masing-masing dengan nama, tanggal pendaftaran, dan jumlah pesanan. Di antara alat generator data tes, file biasa di proyek Anda adalah yang paling mudah dibaca dan diubah nanti, karena diff menunjukkan setiap nilai. glob dan list_dir menunjukkan tempat fixture sudah ada, sehingga file baru akan ditempatkan di sebelah yang lain. Buka kartu, periksa bahwa setiap nilai jelas dibuat-buat, dan edit baris yang aneh secara manual sebelum menerimanya. Gunakan domain contoh cadangan untuk email. Minta beberapa baris, bukan ratusan, agar Anda dapat membaca setiap satu. Tulis tanggal dalam satu format tetap agar setiap baris terlihat sama.

Tulis pemeriksaan yang membaca file

Minta skrip yang memuat JSON dan memeriksa satu hasil per baris. Agen membuka sumber Anda dengan read_file, menemukan fungsi dengan grep, dan mengusulkan file tes sebagai diff. Memoking metode statis di php agak rumit, jadi minta agen untuk mencantumkan panggilan statis sebelum menulis apa pun, dan simpan panggilan tersebut di balik fungsi kecil yang dapat diganti oleh tes. Ask first menahan perubahan hingga Anda menerimanya. Baca setiap asersi dan tanyakan apakah itu akan gagal jika fungsi salah. Tolak pemeriksaan apa pun yang hanya mengulangi kode yang diujinya. Kemudian tambahkan satu baris yang seharusnya gagal secara sengaja. Jika agen tidak dapat menentukan fungsi mana yang Anda maksud, sebutkan dalam prompt dan sebutkan file tersebut. Jaga satu konsep per tes.

Jalankan tes dan baca kode keluar

Shell menjalankan perintah tes Anda di lingkungan yang Anda pilih, seperti Windows lokal, WSL, atau SSH ke server yang Anda miliki. Kartu menampilkan kode keluar yang sebenarnya, dan kode keluar nol berarti setiap pemeriksaan berhasil, sementara nilai lain berarti kegagalan. Perluas kartu untuk membaca output baris demi baris. Jika ada kegagalan, agen membaca pesan dan mengusulkan perbaikan sebagai diff. Jangan terima perbaikan hanya karena menjalankan tes menjadi hijau. Periksa nilai yang diharapkan dalam tes terlebih dahulu. Jika kegagalan kedua mengikuti, minta agen untuk menjelaskan yang pertama sebelum ia mengubah lagi. Plan only adalah langkah pertama yang baik jika perintahnya baru bagi Anda, karena agen kemudian menulis rencana dan tidak menjalankan apa pun.

Putuskan kode mana yang perlu diuji

Setelah tes berhasil, jalankan perintah cakupan Anda dan biarkan agen membaca laporan. Tim berdebat apakah harus menyertakan kode infrastruktur dalam cakupan kode, dan jawaban yang masuk akal adalah menyepakatinya sebelum angka tersebut menjadi target. Beberapa tim juga menuntut cakupan tes wajib untuk metode kritis, seperti pemeriksaan harga atau izin. Minta agen untuk mencantumkan metode tersebut dengan grep dan mengusulkan tes untuk yang pertama. Tinjau diff, jalankan tes lagi, dan berhenti ketika jalur kritis tertutup. Tuliskan folder mana yang Anda hitung, agar angka bulan depan memiliki arti yang sama. Minta agen untuk menempatkan daftar folder yang dihitung ke dalam file teks biasa di proyek Anda, dan baca diff sebelum menerimanya.

CycleMantle untuk Windows

Hasilkan fixture pertama Anda hari ini

Unduh CycleMantle ↗