Penulisan Komentar Python: Curhat Programmer ke Python

 

 

Komentar itu penting banget dalam sebuah program. Ibarat caption di foto Instagram, komentar membantu orang (termasuk kamu di masa depan) paham maksud kode yang ditulis. Nah, di Python, komentar itu simpel, fleksibel, dan tentunya bisa dibuat lucu. Yuk, kita bahas caranya!

1. Komentar Satu Baris: Curhat Singkat

Kalau mau kasih catatan pendek, cukup pakai tanda pagar #:

# Ini adalah komentar satu baris
print("Halo, Dunia!")  # Ini juga komentar

Python nggak bakal baca apapun setelah tanda pagar. Jadi, bebas mau curhat apa aja, asal nggak terlalu drama.

2. Komentar Multi-Baris: Curhat Panjang

Kalau satu baris nggak cukup, pakai komentar multi-baris. Ada dua cara:

Cara 1: Pakai Banyak Tanda Pagar

# Ini adalah komentar multi-baris
# yang ditulis dengan banyak tanda pagar.
# Cocok buat curhat panjang lebar.
print("Halo lagi!")

Ini kayak nulis novel di kode, tapi ingat, jangan sampai bikin orang bosan baca!

Cara 2: Pakai String Tiga Tanda Kutip

Cara ini sebenarnya untuk docstring (penjelasan fungsi), tapi bisa juga buat komentar:

"""
Ini komentar multi-baris
dengan tanda kutip tiga.
Python nggak akan menjalankan ini.
"""
print("Python itu seru!")

Tapi hati-hati, ini nggak sepenuhnya komentar, jadi jangan terlalu bergantung.

3. Tips Menulis Komentar yang Baik

• Jelas dan Singkat: Komentar itu buat membantu, bukan membingungkan.

  # Hitung luas lingkaran
  luas = 3.14 * jari_jari ** 2
  

• Hindari Curhat Berlebihan:

  # Aku nulis ini sambil nangis karena bug kemarin belum kelar.
  print("Coba lagi!")
  

  Python nggak butuh tahu drama hidupmu.

• Gunakan Bahasa yang Dipahami Semua Orang: Kalau kode untuk tim, jangan pakai bahasa alien:

  # Esto calcula el área del círculo (unless your team speaks Spanish)
  luas = 3.14 * jari_jari ** 2
  

4. Komentar Lucu, Bikin Coding Santai

Kalau suasana coding tegang, tambahin komentar yang bikin senyum:

# Ini adalah solusi sementara. Kalau jalan, berarti bukan sementara lagi.
print("Kode jalan!")

# TODO: Perbaiki cara ini sebelum bos tahu.

5. Docstring: Penjelasan Formal

Selain komentar biasa, Python juga punya docstring, penjelasan resmi untuk fungsi atau kelas. Ini cocok buat kode yang profesional:

def sapa(nama):
    """
    Fungsi untuk menyapa seseorang.
    Argumen:
        nama (str): Nama orang yang akan disapa.
    """
    print(f"Halo, {nama}!")

Docstring itu kayak brosur resmi programmu, biar orang lain langsung ngerti.

Penutup

Komentar itu kayak jembatan komunikasi antara programmer dan kode. Jadi, pastikan komentarmu berguna, lucu (kalau perlu), dan nggak bikin Python bingung. Selamat menulis komentar, dan ingat: kode boleh ribet, tapi komentar harus tetap jelas!