Cara Menulis Fungsi yang Mudah Dibaca (Biar Kode Kamu Gak Bikin Pusing)
Pernah nggak sih, kamu buka kode lama yang kamu tulis sendiri, tapi malah bingung bacanya? Apalagi kalau isinya fungsi-fungsi panjang yang kayak gulungan benang kusut. Tenang, kamu nggak sendirian. Banyak programmer, dari yang baru belajar sampai yang senior sekalipun, sering ketemu masalah ini.
Nah, biar kode kamu lebih ramah terhadap diri sendiri di masa depan, juga terhadap teman tim yang mungkin harus mantain kode kamu, yuk kita bahas gimana cara menulis fungsi yang mudah dibaca. Santai aja, tips ini sederhana kok.
1. Beri Nama Fungsi yang Deskriptif
Ini yang paling dasar tapi sering dilupakan. Nama fungsi harus bisa menjelaskan apa yang dilakukan, bukan bagaimana caranya. Misalnya:
❌ `prosesData(a, b)`
✅ `hitungTotalBelanja(hargaBarang, jumlahBarang)`
Nama yang jelas bikin siapa pun langsung paham tujuan fungsi tanpa harus baca isinya. Kalau kamu kesulitan kasih nama singkat, bisa jadi fungsi itu terlalu banyak tugas (lihat poin nomor 2).
2. Satu Fungsi, Satu Tanggung Jawab
Prinsip Single Responsibility bukan cuma untuk class, tapi juga fungsi. Fungsi yang baik cuma melakukan satu hal saja. Kalau ada lebih dari satu tugas, pisahkan.
Contoh fungsi yang terlalu banyak kerjaan:
“`python
def urusPesanan(pesanan):
# validasi stok
# hitung total harga
# kirim email konfirmasi
# update database
“`
Lebih baik dipecah:
“`python
def validasiStok(pesanan): …
def hitungTotal(pesanan): …
def kirimEmailKonfirmasi(email): …
def updateDatabase(pesanan): …
“`
Dengan begini, setiap fungsi pendek, fokus, dan gampang dites satu per satu.
3. Jaga Jumlah Parameter Tetap Sedikit
Fungsi dengan 5-6 parameter atau lebih biasanya sulit dipahami. Coba bayangkan harus ingat urutan parameter yang banyak. Kalau memang perlu banyak data, bungkus dalam satu objek atau dictionary.
❌ `buatLaporan(judul, penulis, tanggal, kategori, isi, footer, header, logo)`
✅ `buatLaporan(konfigurasiLaporan)` dengan `konfigurasiLaporan` berisi semua properti.
Kalau memang terpaksa banyak parameter, gunakan named arguments (di bahasa yang mendukung) atau buat parameter opsional dengan nilai default.
4. Hindari Efek Samping yang Tak Terduga
Fungsi yang mudah dibaca adalah fungsi yang transparan: kamu kasih input, dapat output, tanpa mengubah sesuatu di luar secara diam-diam. Misalnya, fungsi yang mengubah variabel global atau memodifikasi argumen asli tanpa sepengetahuan pemanggil.
Lebih baik fungsi hanya mengembalikan nilai baru, daripada mengubah data yang dikirim.
❌
“`python
def tambahDiskon(harga):
harga *= 0.9 # mengubah variabel asli
“`
✅
“`python
def hitungHargaSetelahDiskon(harga):
return harga * 0.9
“`
5. Gunakan Komentar yang Bijak, Bukan Berlebihan
Komentar itu membantu, tapi jangan sampai jadi karpet di lantai — malah bikin kotor. Komentar yang baik menjelaskan mengapa sesuatu dilakukan, bukan apa yang dilakukan (kode sudah menjelaskan itu).
❌
`// loop untuk menambah 1 ke i`
✅
`// tambah 1 karena index dimulai dari 0` (kalau ada alasan khusus)
Lebih penting lagi, pastikan komentar sinkron dengan kode. Kalau kode berubah, komentar wajib diupdate.
6. Buat Fungsi yang Pendek
Aturan praktis: fungsi idealnya muat di layar tanpa perlu scroll. Kalau fungsi sudah lebih dari 20-30 baris, kemungkinan besar bisa dipecah lagi. Fungsi pendek lebih mudah diingat, diuji, dan di-debug.
7. Gunakan Pola Early Return
Daripada nested if-else yang bersarang dalam-dalam, lebih baik gunakan early return (atau guard clause). Ini bikin alur fungsi jadi lebih linear.
Contoh:
“`python
def cekPendaftaran(umur, punyaKTP):
if umur = 17:
if punyaKTP:
return True
else:
return False
else:
return False
“`
8. Konsisten dengan Gaya Penulisan
Terakhir, pilih satu gaya (camelCase, snake_case, dll) dan konsisten. Konsistensi membuat kode lebih mudah dipindai.
—
Penutup
Menulis fungsi yang mudah dibaca nggak butuh bakat khusus, tapi butuh sedikit kesadaran dan latihan. Mulai saja dengan memperbaiki satu fungsi setiap hari — kasih nama yang lebih jelas, potong kalau terlalu panjang, atau tambah early return.
Percaya deh, kode yang mudah dibaca itu seperti tulisan tangan yang rapi. Kamu sendiri yang akan berterima kasih nanti ketika harus mantain-nya. Apalagi kalau proyekmu udah gede dan lupa sama kode yang ditulis 3 bulan lalu.
Selamat mencoba, dan selamat menulis kode yang lebih cantik! 🚀