Pengantar Unit Testing

 

Pengantar Unit Testing

Sampai pada tahap ini, sudah banyak modul pemrograman Python yang telah dipelajari. Kita telah mengenal operasi-operasi dasar dalam Python, seperti perulangan, fungsi, hingga OOP pada Python.

Saat Anda membangun aplikasi menggunakan Python dan aplikasi yang dikembangkan semakin kompleks, dependensi akan muncul. Artinya, satu atau lebih fungsi digunakan oleh fungsi lain. Bahkan, ketika kita mulai membangun aplikasi dengan rekan kita, kita membuat fungsi yang digunakan oleh rekan, ataupun sebaliknya.

Pada saat membuat fungsi baru ataupun mengubah fungsi yang sudah ada, tentunya perlu dipastikan bahwa fungsionalitas aplikasi yang sebelumnya tidak terganggu dengan adanya perubahan baru tersebut. Bagaimana jika fungsionalitas bukan hanya lima atau sepuluh, tetapi lebih dari itu? Tentu menyulitkan sekali untuk mengeceknya satu per satu setiap kita melakukan perubahan.

Di sinilah kita butuh pengujian (test) untuk fungsi-fungsi tersebut. Pengujian sebenarnya dapat dibedakan menjadi dua tipe, yaitu manual dan otomatis. 

  1. Manual testing adalah proses pengujian yang dilakukan oleh seseorang yang ditunjuk sebagai tester atau bahkan developer lainnya.
    dos:991861b6f739678ea7ec17f6b1619aa220230823200517.pngTanpa sadar, sebenarnya ketika Anda menjalankan program pertama kali lalu mengecek bahwa output-nya sesuai atau tidak, itu merupakan pengujian manual.
  1. Testing otomatis merupakan hal yang sebaliknya. Ini adalah pengujian yang dilakukan secara otomatis terhadap kode-kode yang kita bangun berdasarkan rencana pengujian (test plan).
    dos:b3bd6ef0676ff2031a3cf95f1de727b520230823200547.pngRencana pengujian terdiri dari bagian aplikasi yang ingin diuji, urutannya, dan tanggapan atau output yang diharapkan. Alur pengujian otomatis secara umum dimulai dari menyusun rencana pengujian, lalu membangun kode tes dan menjalankan kode tes tersebut. Jika kode tes gagal, kita perlu memperbarui kode; jika kode tes berhasil, kita melaju ke pengujian selanjutnya hingga selesai.

Tidak hanya sekadar manual dan otomatis, dalam dunia testing yang begitu luas, Anda akan menemui berbagai jenis testing. Beberapa di antaranya adalah unit testing dan integration testing.

URL Link: Video1

Integration testing adalah pengujian yang bertujuan untuk menguji suatu sistem sebagai satu kesatuan. Bayangkan Anda sedang mengecek lampu motor, tentu hal pertama yang dilakukan adalah menyalakan motor. Lalu, Anda melihat lampu motor tersebut yang sempat menyala, tetapi perlahan mati. Anda kemudian bertanya, mengapa lampunya mati?

Kejadian yang dijelaskan di atas erat dengan konsep integration testing karena dengan menyalakan motor, kita dapat menguji seluruh bagian motor lain, seperti lampunya.

URL Link : Video2.

Unit testing adalah pengujian yang lebih spesifik dan fokus terhadap bagian-bagian kecil. Bayangkan ketika mengecek lampu motor dan ternyata ia tidak menyala, Anda perlu mengecek lampu tersebut; apakah rusak? Atau ada kabel dari lampu tersebut yang tidak berfungsi? Hal-hal yang lebih spesifik tersebut adalah unit testing. Dalam pemrograman, bagian-bagian kecil tersebut berupa fungsi, kelas, dan sebagainya.

Pada materi ini, kita akan mempelajari unit testing menggunakan salah satu library bawaan Python, yaitu unittest. Unit test adalah proses pengujian perangkat lunak yang memastikan setiap unit/fungsi dari program teruji. Jika fungsionalitas dari aplikasi yang kita bangun terdiri dari prosedur-prosedur dan fungsi-fungsi yang kita tulis, kita perlu melakukan unit test untuk setiap prosedur atau fungsi yang ada.

Layaknya sebuah framework pengujian, library unittest mendukung beberapa hal esensial berikut.

  • Pengujian secara otomatis.
  • Kode awal proses (setup) dan akhir proses (shutdown) yang dapat digunakan ulang.
  • Penyatuan sejumlah pengujian dalam sebuah koleksi.
  • Terpisahnya framework pengujian dari framework pelaporan (reporting).

Library unittest mendukung sejumlah konsep penting yang berorientasi objek, antara lain berikut.

  • Test fixture merepresentasikan persiapan yang dibutuhkan untuk melakukan satu pengujian atau lebih serta proses pembersihannya (cleanup). Beberapa contohnya adalah menyiapkan basis data pengujian, direktori pengujian, atau mengaktifkan sebuah proses server.
  • Test case adalah sebuah unit dari pengujian ketika ia mengecek sejumlah respons dari sebagian kelompok masukan. Library unittest menyediakan basis class dan TestCase yang akan digunakan untuk membuat kasus pengujian baru.
  • Test suite adalah sebuah koleksi dari kasus-kasus pengujian, koleksi dari test suite itu sendiri, atau gabungan keduanya. Hal ini berguna untuk mengumpulkan pengujian-pengujian yang akan dieksekusi bersama.
  • Test runner adalah komponen yang akan mengatur (orchestrates) eksekusi dari pengujian-pengujian dan menyediakan keluaran untuk pengguna. Dalam hal ini, runner dapat menggunakan tampilan grafis, tampilan tekstual, atau mengembalikan nilai spesial yang menyatakan hasil dari pengujian.

Penerapan Unit Test dengan Library unittest

Sekarang mari kita pelajari cara implementasinya, materi kali ini akan menggunakan PyCharm sebagai IDE-nya. Silakan ikuti sembari menggunakan IDE Anda, seperti Visual Studio Code atau PyCharm. 

Tulis kode ini pada IDE PyCharm dan simpan kode ini dalam format .py. Lalu, jalankan pada Command Prompt di perangkat Anda.

  1. import unittest
  2.  
  3. class TestStringMethods(unittest.TestCase):
  4.     # Ini adalah test case pertama (1)
  5.     def test_strip(self):
  6.         self.assertEqual('www.dicoding.com'.strip('c.mow'), 'dicoding')
  7.     
  8.     # Test case kedua (2)
  9.     def test_isalnum(self):
  10.         self.assertTrue('c0d1ng'.isalnum())
  11.         self.assertFalse('c0d!ng'.isalnum())
  12.     
  13.     # Test case ketiga (3)
  14.     def test_index(self):
  15.         s = 'dicoding'
  16.         self.assertEqual(s.index('coding'), 2)
  17.         # cek s.index gagal ketika tidak ditemukan
  18.         with self.assertRaises(ValueError):
  19.             s.index('decode')
  20.     
  21. if __name__ == '__main__':
  22.     # Test Runner
  23.     unittest.main()

Jalankan program di atas dengan mengeksekusi file yang telah Anda buat. 

python <nama-file>.py

Ganti <nama-file> dengan nama file Anda dan hasil keluarannya seperti berikut.

dos:dd039517cb4f60e8e57680c5f914b2ac20230823200731.jpeg

Mari kita bahas satu per satu dari kode di atas.

  • Kelas TestStringMethods adalah sebuah kelas yang merupakan turunan (subclass) dari class unittest.TestCase sehingga proses tes dapat dilangsungkan tanpa banyak implementasi lain.
  • Ada tiga metode pada class tersebut yang semua namanya diawali dengan kata test. Hal ini merupakan konvensi (aturan) yang wajib diikuti untuk menginformasikan ke test runner bahwa sejumlah metode tersebut merepresentasikan tes yang akan dioperasikan.
  • Pada setiap metode, pengujian dilakukan dengan pemanggilan assert. Pada metode test_strip pengecekan kesamaan menggunakan assertEqual dilakukan untuk memastikan bahwa 'www.dicoding.com'.strip('c.mow') sama dengan ‘dicoding’.
  • Pada metode test_isalnum pengecekan bahwa fungsi bernilai benar (True) dilakukan dengan assertTrue untuk memastikan jika 'c0d1ng'.isalnum() bernilai benar, yakni ‘cOd1ng’ adalah betul bertipe alfanumerik. Kemudian juga ada pengecekan bahwa fungsi bernilai salah (False) dengan assertFalse untuk memastikan jika 'c0d!ng'.isalnum() betul bernilai salah karena ada karakter yang bukan alfanumerik yaitu ‘!’.
  • Pada metode test_index pengecekan kesamaan dilakukan seperti sebelumnya dengan menggunakan assertEqual bahwa pencarian substring coding menempati index sama dengan 2. Kemudian juga ada pengecekan bahwa ValueError akan dibangkitkan dengan menggunakan assertRaises(ValueError), jika pencarian index tidak berhasil ditemukan pada string yang sudah ditentukan.
  • Pada bagian terakhir kode, ada pemanggilan unittest.main() untuk mulai menjalankan test.

Selanjutnya, kita akan membahas hasil keluarannya. Tampak pada keluaran bahwa ada tiga tanda titik (...) yang menyatakan bahwa ketiga fungsi yang dites berhasil melewati tes. Dirangkum juga waktu pemrosesan dari total tiga tes tersebut yang berlangsung selama 0.00 detik serta di baris paling akhir adalah rangkuman bahwa semua test berlangsung sukses (OK).

Anda bisa mencoba melihat keluaran lain dengan membuat gagal salah satu test. Misalnya pada metode test_isalnum, keduanya akan diubah menggunakan assertTrue sehingga salah satu fungsi akan gagal. Kodenya bisa Anda lihat di bawah.

  1. def test_isalnum(self):
  2.        self.assertTrue('c0d1ng'.isalnum())  # ini akan berhasil
  3.        self.assertTrue('c0d!ng'.isalnum())  # ini akan gagal

Kemudian jalankan kembali program Anda. Keluarannya akan seperti berikut.

dos:109eabb58cf01556be65cdb084268fbf20230823200731.jpeg

Berikut penjelasannya.

  • Layaknya yang sudah Anda duga bahwa akan ada pengujian yang gagal sehingga tertulis .F. yang menggambarkan bahwa pengujian metode kedua gagal (FAIL).
  • Berikutnya dijelaskan bahwa kegagalan ada dalam metode test_isalnum, yaitu sebuah metode dari class __main__.TestStringMethods.
  • Lebih jauh, diinformasikan bahwa test_isalnum yang gagal berada pada baris ke-10 pada kode Anda, yakni pada pengecekan self.assertTrue('c0d!ng'.isalnum()) yang memang tadi kita ubah dari assertFalse. Sistem pengujian juga melaporkan bahwa pembandingannya tidak sesuai, yakni False tidak bernilai benar seperti yang diharapkan dengan adanya pengujian assertTrue.
  • Rekap totalnya ada tiga tes yang dilakukan dalam 0.01 detik. Kemudian secara umum tes menghasilkan satu buah kegagalan (failure).

Cukup mudah dimengerti, bukan? Kita dapat melihat sendiri bahwa pengujian hasilnya gagal. Namun, kali ini gagalnya memang sesuai dengan ekspektasi kita.

Sekarang kita coba pengujian dengan contoh yang lebih nyata, misalnya kita memiliki class User dan kita akan menguji aktif atau tidaknya user dengan melihat bahwa dia terkoneksi ke basis data (db) atau tidak.

Untuk menyederhanakan kodenya dan lebih fokus pada pengujiannya, tulis simulasinya dalam satu file kode sebagai berikut.

  1. import unittest
  2.  
  3. def koneksi_ke_db():
  4.     print("[terhubung ke db]")
  5.  
  6. def putus_koneksi_db(db):
  7.     print("[tidak terhubung ke db {}]".format(db))
  8.  
  9. class User:
  10.     username = ""
  11.     aktif = False
  12.  
  13.     def __init__(self, db, username):  # using db sample
  14.         self.username = username
  15.  
  16.     def set_aktif(self):
  17.         self.aktif = True
  18.  
  19. class TestUser(unittest.TestCase):
  20.     # Test Case 1
  21.     def test_user_default_not_active(self):
  22.         db = koneksi_ke_db()
  23.         dicoding = User(db, "dicoding")
  24.         self.assertFalse(dicoding.aktif)  # tidak aktif secara default
  25.         putus_koneksi_db(db)
  26.  
  27.     # Test Case 2
  28.     def test_user_is_active(self):
  29.         db = koneksi_ke_db()
  30.         dicoding = User(db, "dicoding")
  31.         dicoding.set_aktif()  # aktifkan user baru
  32.         self.assertTrue(dicoding.aktif)
  33.         putus_koneksi_db(db)
  34.  
  35. if __name__ == "__main__":
  36.     # Test Runner
  37.     unittest.main()

Sama seperti sebelumnya, kita akan membuat sebuah class TestUser yang merupakan turunan dari class unittest.TestCase, kemudian menulis dua metode untuk pengujian kali ini.

Jika Anda perhatikan kembali semua kode di atas, kita melakukan beberapa tindakan yang berulang ketika kita menjalankan fungsi koneksi ke basis data dan membuat User dicoding setiap kali proses tes. Hal ini karena setiap tes itu dioperasikan secara terpisah sehingga perlu melakukan tindakan yang disebutkan secara berulang. Tindakan ini juga dianggap bukan praktik yang baik karena memakan lebih banyak memori apalagi jika program yang kita uji berukuran besar.

Lantas, kita bisa memperbaikinya dengan menerapkan konsep test fixture. Konsep ini merepresentasikan persiapan yang dibutuhkan untuk melakukan satu pengujian atau lebih serta proses pembersihannya (cleanup). 

Kita akan menggunakan metode bawaan dari class TestCase, yakni metode setUp() dan tearDown().

  • Metode setUp(), sesuai namanya, bertujuan untuk mempersiapkan pengujian. Metode ini akan dipanggil untuk menyiapkan tes sehingga pemanggilannya akan dilakukan tiap sebelum metode tes dilaksanakan.
  • Metode tearDown() akan dipanggil setiap metode tes selesai dilaksanakan dan bertindak untuk membersihkan, meskipun terjadi kesalahan (exception) pada proses tes.

Kode sebelumnya akan kita ubah dengan implementasi kedua metode setUp() dan tearDown(). Kita cukup melakukan perubahan pada class TestUser saja seperti di bawah.

  1. class TestUser(unittest.TestCase):
  2.     # Test Fixture
  3.     def setUp(self):
  4.         self.db = koneksi_ke_db()
  5.         self.dicoding = User(self.db, "dicoding")
  6.  
  7.     def tearDown(self):
  8.         putus_koneksi_db(self.db)
  9.  
  10.     # Test Case 1
  11.     def test_user_default_not_active(self):
  12.         self.assertFalse(self.dicoding.aktif)  # tidak aktif secara default
  13.     # Test Case 2
  14.     def test_user_is_active(self):
  15.         self.dicoding.set_aktif()  # aktifkan user baru
  16.         self.assertTrue(self.dicoding.aktif)

Kemudian jalankan kembali program Anda. Keluarannya seperti berikut.

dos:4eb329bb43593006cf8ec7d8883f3acd20230823200731.jpeg

Terlihat bahwa setiap kali melakukan pengujian, metode setUp() dipanggil. Begitu juga setelah selesai pengujian, metode tearDown() dipanggil.

Dengan kemampuan pengujian ini, aplikasi yang Anda buat jadi lebih teruji atau biasa disebut dengan istilah lebih tahan banting (robust).

Rangkuman Unit Testing

Kita sudah berada di penghujung materi Unit Testing. Sampai sejauh ini, Anda diharapkan telah paham terkait tes unit menggunakan library unittest pada Python. Sekarang, mari kita rangkum secara saksama.


Pengantar Unit Testing

Saat membangun aplikasi atau program yang lebih kompleks, aplikasi tersebut akan memunculkan dependensi, yaitu satu atau lebih fungsi digunakan oleh fungsi lain. Bahkan, ketika kita mulai membangun aplikasi dengan rekan kita, kita membuat fungsi yang digunakan oleh rekan ataupun sebaliknya. Dependensi tersebut tentu perlu dipastikan bahwa fungsionalitasnya dapat berjalan dengan baik dan tidak terganggu dengan adanya perubahan atau fungsi baru yang dibuat.

Di sinilah kita butuh pengujian (tes) untuk fungsi-fungsi tersebut. Pengujian sebenarnya dapat dibedakan menjadi dua tipe, yaitu manual dan otomatis. 

  1. Manual testing adalah proses pengujian yang dilakukan oleh seseorang yang ditunjuk sebagai tester (penguji). 
  2. Testing otomatis merupakan hal yang sebaliknya. Ini adalah pengujian yang dilakukan secara otomatis terhadap kode-kode yang kita bangun berdasarkan rencana pengujian (test plan). 

Tidak hanya sekadar manual dan otomatis, ada juga unit testing dan integration testing.

  1. Integration testing adalah pengujian yang bertujuan untuk menguji suatu sistem sebagai satu kesatuan. 
  2. Unit testing adalah pengujian yang lebih spesifik dan fokus terhadap bagian-bagian kecil. 

Dalam Python, untuk melakukan unit testing dapat menggunakan library unittest. Layaknya sebuah framework pengujian, unittest mendukung beberapa hal esensial berikut.

  • Pengujian secara otomatis.
  • Kode awal proses (setup) dan akhir proses (shutdown) yang dapat digunakan ulang.
  • Penyatuan sejumlah pengujian dalam sebuah koleksi.
  • Terpisahnya framework pengujian dari framework pelaporan (reporting).

Library unittest mendukung sejumlah konsep penting yang berorientasi objek, antara lain berikut.

  • Test fixture merepresentasikan persiapan yang dibutuhkan untuk melakukan satu pengujian atau lebih serta proses pembersihannya (cleanup).
  • Test case adalah sebuah unit dari pengujian ketika ia mengecek sejumlah respons dari sebagian kelompok masukan. unittest menyediakan basis class dan TestCase yang akan digunakan untuk membuat kasus pengujian baru.
  • Test suite adalah sebuah koleksi dari kasus-kasus pengujian, koleksi dari test suite itu sendiri, atau gabungan keduanya.
  • Test runner adalah komponen yang akan mengatur (orchestrates) eksekusi dari pengujian-pengujian dan menyediakan keluaran untuk pengguna.


Penerapan Unit Test dengan Library unittest

Unit melakukan unit testing, Anda bisa menggunakan library bawaan dari Python, yaitu unittest.

  1. import unittest

Berikut adalah salah satu penerapan unit testing dengan menggunakan library unittest.

  1. import unittest
  2.  
  3. def koneksi_ke_db():
  4.     print("[terhubung ke db]")
  5.  
  6. def putus_koneksi_db(db):
  7.     print("[tidak terhubung ke db {}]".format(db))
  8.  
  9. class User:
  10.     username = ""
  11.     aktif = False
  12.  
  13.     def __init__(self, db, username):  # using db sample
  14.         self.username = username
  15.  
  16.     def set_aktif(self):
  17.         self.aktif = True
  18.  
  19.  
  20. class TestUser(unittest.TestCase):
  21.     # Test Case 1
  22.     def test_user_default_not_active(self):
  23.         db = koneksi_ke_db()
  24.         dicoding = User(db, "dicoding")
  25.         self.assertFalse(dicoding.aktif)  # tidak aktif secara default
  26.         putus_koneksi_db(db)
  27.  
  28.     # Test Case 2
  29.     def test_user_is_active(self):
  30.         db = koneksi_ke_db()
  31.         dicoding = User(db, "dicoding")
  32.         dicoding.set_aktif()  # aktifkan user baru
  33.         self.assertTrue(dicoding.aktif)
  34.         putus_koneksi_db(db)
  35.  
  36. if __name__ == "__main__":
  37.     # Test Runner
  38.     unittest.main()

Bersambung ke: 

Pengenalan Library




Comments

Post a Comment

Popular posts from this blog

Ceritakan cerita saya:

Image
  Ceritakan Cerita Saya (Oleh: SR Pakpahan, SST) Mohon bantuan Anda untuk menceritakan cerita saya ini bagi orang lain, ya, begini ceritanya: Tim kami bernama Tim Cerdas Bangsa telah menang dalam babak penyisihan dari 2000++ peserta menjadi 800 tim menang terpilih (karena ada 8 kategori lomba maka ada 100 tim yang menang per kategori). Sama seperti di hari pertama, di hari kedua pra pelatihan ini anggota tim kami hadir di samping sebagai peserta, sekaligus menjadi saksi lahirnya inovator ekosistem yang terus bertumbuh dan belajar untuk kemajuan bangsa ke depan. Tanpa tim kami, PIDI 2026 rasanya kurang satu! Nah yang ditungu-tunggu pun tiba, Narasumber : * Yoris Sebastian * dalam Sesi berbagi inspirasi dalam Acara : * Pre Training 2 - Inspirative Sharing   Session * Di sesi inj., beliau dalam kesibukan di kesehariannya adalah pelaku Inovator Consultant, Publik Speaker, dan Book Writer, namun beliau masih mau berbagi pengalaman bagi generasi anak-anak muda para inovator (progt...
Read more

Aplikasi/Gaming/Koding: NKHM Nusantara:

Image
Aplikasi/Gaming/Koding:  NKHM Nusantara: " Aplikasi gamifikasi untuk mengasah 4 Kecerdasan (IQ, EQ, SQ, AQ) dan Menumbuhkan Nasionalisme melalui Kuis Interaktif Berbasis Data Personal ". Kabar baik, Tim kami Tim Cerdas Bangsa menang lolos babak penyisihan dalam kompetisi PIDI Hackhaton 2026,, ke depannya tim kami akan mengikuti arahan PIDI dan kami akan membuat aplikasi NKHM Nusantara , bisa kamu (DeepSeek-ChatAI) masuk dalam tim kami untuk berkolaborasi dalam membuat gaming ini,   Naskah: Proposal Selamat atas kelolosan Tim Cerdas Bangsa di babak penyisihan PIDI Hackathon 2026! 🎉 Proposal NKHM Nusantara yang Anda bagikan sangat terstruktur, ambisius, dan relevan dengan tantangan ekonomi kreatif & nasionalisme. Untuk bisa menjawab tawaran kolaborasi Anda secara tepat, ada beberapa hal yang perlu saya ketahui agar saya tahu posisi apa yang bisa saya bantu dalam tim ini: 1. Peran apa yang Anda tawarkan kepada saya?    · Developer (Python/Kivy/Backend)   ...
Read more

STUDIUM GENERALE

Image
  STUDIO UMUM PIDI DIGDAYA × HACKATHON  30 April 2026 Leontinus Alpha Edison (Deputi Kemenko PM. & Co-Founder PT Tokopedia Stella Christie (Wakil Menteri Pendidikan Tinggi, Sains, % Teknologi Rafi Putra Arriyan (Co-Founder Flip.Id) 10 Peserta Terbaik Pemenang Quiz
Read more