senfgurke

Senfgurke

Senfgurke adalah contoh kerangka pengujian berbasis VBA. Apa artinya ini? Dengan menggunakan Senfgurke Anda dapat mengubah contoh yang diberikan dalam bahasa alami menjadi pengujian otomatis yang dijalankan oleh VBA (Visual Basic for Applications).

• Perkenalan
• Pengaturan
• Desain fungsional
• Arsitektur

AWAS! Ini sedang dalam proses. Versi mendatang mungkin merusak kode otomatisasi pengujian Anda dari versi yang lebih lama!

Perkenalan

Bayangkan seseorang meminta Anda untuk menulis fungsi penjumlahan "khusus" baru untuk Excel yang menambahkan nilai 1 pada hasilnya dengan memberi Anda contoh ini:

 Example: add +1 to sum
  Given a is 2
    And b is 3
   When sum+1 is applied to a and b
   Then the result is 6

Anda sekarang dapat menambahkan contoh ini ke fitur dan menyimpan semuanya dalam file bernama 'sum_plus_one.feature' ke direktori bernama 'features'. Direktori tersebut harus berada di lokasi yang sama dengan file kantor Anda yang berisi kode VBA Anda.

Jika Anda menjalankan Senfgurke pertama kali, Anda akan disarankan untuk menambahkan fungsi baru seperti ini:

 Public Sub Given_a_is_INT_C722764574FB(step_parameters As Collection)
    'Given a is 2

End Sub

Harap jangan bingung dengan bagian C722764574FB dari nama fungsi. Nilai hash ini membantu Senfgurke mencocokkan fungsi dengan langkah asli dari contoh. Sekarang terserah Anda untuk mengisi fungsi tersebut dengan kode, sehingga Anda dapat menguji fungsi baru Anda untuk memastikan bahwa sum+1 mengembalikan hasil yang benar.

Ketika Anda mengulangi ini untuk setiap langkah contoh dan menjalankan Senfgurke, Anda mungkin menerima ini di konsol:

 Feature: sum plus one


  Rule: add one to sum results

    Example: add +1 to sum
     OK       Given a is 2
     OK       And b is 3
     OK       When sum+1 is applied to a and b
     OK       Then the result is 6

Dengan cara ini Senfgurke memberi tahu Anda apakah kode Anda berhasil atau menyebabkan kesalahan apa pun.

Pengaturan

Senfgurke disediakan sebagai Addin khusus aplikasi. Dengan cara ini Anda dapat dengan mudah memisahkan aplikasi yang sedang diuji dan kerangka pengujian Senfgurke. Untuk memulai aplikasi VBA baru ikuti langkah-langkah berikut:

1. Aktifkan Add-In Senfgurke untuk aplikasi Anda
2. Buat dokumen baru untuk kode Anda (mis.: file xlm baru untuk Excel)
3. Impor modul TRun dari step_definitions/TRun.bas ke aplikasi Anda
4. Tambahkan referensi ke Add-In Senfgurke untuk aplikasi Anda di VBA IDE
5. Buat direktori baru bernama "fitur" di direktori yang sama dengan aplikasi Anda (dokumen yang berisi kode VBA Anda)
6. Buat file fitur Gherkin pertama Anda di bawah fitur (tambahkan setidaknya 1 contoh)
7. Jalankan TRun.test dari Jendela Langsung di IDE VBA Anda
8. Tambahkan Kelas "Step_" baru ke aplikasi Anda
9. Salin kode yang disarankan untuk fungsi langkah dari Jendela Segera ke kelas Langkah Anda
10. Daftarkan kelas Step Anda dengan memperluas Properti StepImplementations di modul TRun

Desain fungsional

Peta peristiwa berikut akan menjelaskan apa yang akan terjadi ketika Anda meminta Senfgurke untuk menjalankan fitur Anda.

Jalankan tes

Pengujian biasanya dimulai dari jendela konsol VBA. Dengan cara ini Anda dapat menambahkan tag atau filter (untuk nama file) untuk membatasi pengujian yang dijalankan pada tag atau file fitur tertentu.

Memuat file fitur

Hal pertama yang Senfgurke lakukan adalah mencari file fitur dan memuatnya ke dalam memori untuk diproses nanti.

Mengurai fitur

Memiliki semua fitur di memori memudahkan Senfgurke menerjemahkan (mengurai) bahasa Gherkin menjadi instruksi detail untuk dieksekusi nanti. Misalnya, contoh tanpa tag yang cocok yang ditetapkan pada awal pengujian mungkin diabaikan untuk eksekusi selanjutnya atau langkah latar belakang dari suatu fitur akan ditambahkan ke setiap contoh (alias skenario) dalam fitur ini.

Jalankan fitur

Langkah selanjutnya jelas tentang mengeksekusi semua instruksi eksekusi terperinci dari langkah sebelumnya. Ini juga termasuk mengembalikan semua hasil eksekusi.

Laporkan hasil

Sejalan dengan penerapan fitur yang disebutkan di atas, hasilnya akan dilaporkan dalam format berbeda. Defaultnya adalah format verbose yang menulis fitur Gherkin ke jendela konsol VBA hanya dengan menambahkan hasil eksekusi ke setiap langkah contoh.

Statistik laporan

Di akhir setiap pengujian yang dijalankan, Senfgurke akan menambahkan beberapa statistik, misalnya durasi dan jumlah langkah contoh yang dijalankan.

Satu hal lagi

Untuk dokumentasi lebih detail silakan lihat file fitur untuk Senfgurke dimulai dengan indeks yang dihasilkan oleh Pengindeks Fitur.

Arsitektur

Diagram blok FMC menunjukkan bahwa pengaturan tipikal terdiri dari tiga lapisan:

1. OS akan menyediakan penyimpanan untuk file fitur.
2. Add-in Senfgurke mencakup semua fungsi untuk mencocokkan langkah-langkah contoh (alias skenario) dari file fitur dengan fungsi langkah yang cocok.
3. Lapisan atas diwakili oleh aplikasi yang sedang diuji (biasanya dokumen kantor yang berisi kode VBA).

Keputusan Umum

Lihat log keputusan arsitektur untuk beberapa keputusan umum.

Sasaran

Perpisahan yang menjadi perhatian

Arsitektur berlapis harus memastikan bahwa fungsionalitas yang disediakan oleh Senfgurke dipisahkan dari logika aplikasi.

tbc