Apa saja konvensi penamaan populer untuk Tes Unit? [Tutup]

Umum

• Ikuti standar yang sama untuk semua tes.
• Perjelas tentang apa masing-masing negara tes.
• Lebih spesifik tentang perilaku yang diharapkan.

Contohnya

1) MethodName_StateUnderTest_ExpectedBehavior

Public void Sum_NegativeNumberAs1stParam_ExceptionThrown() 

Public void Sum_NegativeNumberAs2ndParam_ExceptionThrown () 

Public void Sum_simpleValues_Calculated ()

Sumber: Penamaan standar untuk Tes Unit

2) Memisahkan Setiap Kata Dengan Garis Bawah

Public void Sum_Negative_Number_As_1st_Param_Exception_Thrown() 

Public void Sum_Negative_Number_As_2nd_Param_Exception_Thrown () 

Public void Sum_Simple_Values_Calculated ()

Lain

• Akhiri nama metode dengan Test
• Mulai nama metode dengan nama kelas

Saya cukup banyak dengan Anda pada pria yang satu ini. Konvensi penamaan yang Anda gunakan adalah:

• Jelas tentang apa masing-masing negara tes.
• Khusus tentang perilaku yang diharapkan.

Apa lagi yang Anda butuhkan dari nama tes?

Bertolak belakang dengan jawaban Ray, saya pikir Tes awalan tidak diperlukan. Itu kode uji, kita tahu itu. Jika Anda perlu melakukan ini untuk mengidentifikasi kode, maka Anda memiliki masalah yang lebih besar, kode pengujian Anda tidak boleh bercampur dengan kode produksi Anda.

Adapun panjang dan penggunaan garis bawah, kode tesnya , siapa yang peduli? Hanya Anda dan tim Anda yang akan melihatnya, asalkan itu dapat dibaca, dan jelas tentang apa yang dilakukan tes, lakukan! :)

Yang mengatakan, saya masih cukup baru untuk menguji dan membuat blog petualangan saya dengan itu :)

Ini juga layak dibaca: Tes Unit Penataan

Struktur memiliki kelas uji per kelas yang diuji. Itu tidak biasa. Tetapi yang tidak biasa bagi saya adalah dia memiliki kelas bersarang untuk setiap metode yang diuji.

misalnya

using Xunit;

public class TitleizerFacts
{
    public class TheTitleizerMethod
    {
        [Fact]
        public void NullName_ReturnsDefaultTitle()
        {
            // Test code
        }

        [Fact]
        public void Name_AppendsTitle()
        {
            // Test code
        }
    }

    public class TheKnightifyMethod
    {
        [Fact]
        public void NullName_ReturnsDefaultTitle()
        {
            // Test code
        }

        [Fact]
        public void MaleNames_AppendsSir()
        {
            // Test code
        }

        [Fact]
        public void FemaleNames_AppendsDame()
        {
            // Test code
        }
    }
}

Dan inilah alasannya:

Nah untuk satu hal, ini cara yang bagus untuk menjaga agar tes tetap teratur. Semua tes (atau fakta) untuk suatu metode dikelompokkan bersama. Misalnya, jika Anda menggunakan pintasan CTRL + M, CTRL + O untuk meruntuhkan badan metode, Anda dapat dengan mudah memindai tes Anda dan membacanya seperti spesifikasi untuk kode Anda.

Saya juga suka pendekatan ini:

MethodName_StateUnderTest_ExpectedBehavior

Jadi mungkin sesuaikan dengan:

StateUnderTest_ExpectedBehavior

Karena setiap tes akan berada di kelas bersarang

Saya cenderung menggunakan konvensi MethodName_DoesWhat_WhenTheseConditionsjadi misalnya:

Sum_ThrowsException_WhenNegativeNumberAs1stParam

Namun, apa yang saya lihat banyak adalah untuk membuat nama tes mengikuti struktur unit pengujian

• Mengatur
• Bertindak
• Menegaskan

Yang juga mengikuti sintaks BDD / Gherkin dari:

• Diberikan
• Kapan
• Kemudian

yang akan menamai tes dengan cara: UnderTheseTestConditions_WhenIDoThis_ThenIGetThis

jadi untuk contoh Anda:

WhenNegativeNumberAs1stParam_Sum_ThrowsAnException

Namun saya lebih suka menempatkan nama metode yang diuji terlebih dahulu, karena dengan demikian pengujian dapat disusun berdasarkan abjad, atau muncul menurut abjad di dalam kotak dropdown anggota di VisStudio, dan semua tes untuk 1 metode dikelompokkan bersama.

Dalam hal apapun, saya seperti memisahkan utama bagian dari nama tes dengan garis bawah, sebagai lawan setiap kata , karena saya pikir itu membuat lebih mudah untuk membaca dan mendapatkan titik uji di.

Dengan kata lain, saya suka: Sum_ThrowsException_WhenNegativeNumberAs1stParamlebih baik daripada Sum_Throws_Exception_When_Negative_Number_As_1st_Param.

Saya memberi nama metode pengujian saya seperti metode lain menggunakan "PascalCasing" tanpa garis bawah atau pemisah. Saya meninggalkan Tes postfix untuk metode ini, karena tidak menambah nilai. Bahwa metode tersebut adalah metode uji ditunjukkan oleh atribut TestMethod .

[TestMethod]
public void CanCountAllItems() {
  // Test the total count of items in collection.
}

Karena fakta bahwa setiap kelas Uji hanya boleh menguji satu kelas lain saya meninggalkan nama kelas dari nama metode. Nama kelas yang berisi metode tes diberi nama seperti kelas yang diuji dengan postfix "Tes".

[TestClass]
public class SuperCollectionTests(){
    // Any test methods that test the class SuperCollection
}

Untuk metode yang menguji pengecualian atau tindakan yang tidak mungkin, saya awali metode pengujian dengan kata Tidak Dapat .

[TestMethod]
[ExpectedException(typeOf(ArgumentException))]
public void CannotAddSameObjectAgain() {
  // Cannot add the same object again to the collection.
}

Konversi penamaan saya didasarkan pada artikel "Kiat TDD: Konvensi & Pedoman Penamaan Tes" dari Bryan Cook. Saya menemukan artikel ini sangat membantu.

Rangkaian nama pertama lebih mudah dibaca oleh saya, karena CamelCasing memisahkan kata-kata dan bagian bawah underbars dari skema penamaan.

Saya juga cenderung menyertakan "Tes" di suatu tempat, baik dalam nama fungsi atau namespace atau kelas terlampir.

Selama Anda mengikuti satu latihan, itu tidak terlalu penting. Secara umum, saya menulis tes unit tunggal untuk metode yang mencakup semua variasi untuk suatu metode (saya punya metode sederhana;) dan kemudian menulis set tes yang lebih kompleks untuk metode yang memerlukannya. Struktur penamaan saya biasanya diuji (peninggalan dari JUnit 3).

Saya menggunakan awalan 'T' untuk ruang nama tes, kelas dan metode.

Saya mencoba untuk menjadi rapi dan membuat folder yang mereplikasi ruang nama, kemudian membuat folder tes atau proyek terpisah untuk tes dan mereplikasi struktur produksi untuk tes dasar:

AProj
   Objects
      AnObj
         AProp
   Misc
      Functions
         AFunc
   Tests
      TObjects
         TAnObj
            TAnObjsAreEqualUnderCondition
      TMisc
         TFunctions
            TFuncBehavesUnderCondition

Saya dapat dengan mudah melihat bahwa ada sesuatu yang merupakan tes, saya tahu persis apa kode asli yang berkaitan, (jika Anda tidak dapat menyelesaikannya, maka tesnya terlalu berbelit-belit).

Sepertinya konvensi penamaan antarmuka, (maksud saya, Anda tidak bingung dengan hal-hal yang dimulai dengan 'I', Anda juga tidak akan dengan 'T').

Mudah dikompilasi dengan atau tanpa tes.

Itu baik secara teori, dan bekerja cukup baik untuk proyek-proyek kecil.