Komentar #

# Ini adalah komentar satu baris
print("Hello, World!")

x = 10          # komentar inline — di akhir baris kode
y = x * 2       # hasil: 20

# ANTI-PATTERN: komentar inline terlalu mepet
x=10 #nilai awal

# BENAR: dua spasi sebelum #, satu spasi setelah #
x = 10  # nilai awal

# Fungsi ini menghitung nilai akhir mahasiswa
# berdasarkan rata-rata ujian tengah semester (UTS),
# ujian akhir semester (UAS), dan nilai tugas harian.
# Bobot: UTS 30%, UAS 40%, Tugas 30%
def hitung_nilai_akhir(uts, uas, tugas):
    return (uts * 0.30) + (uas * 0.40) + (tugas * 0.30)

# ANTI-PATTERN: triple-quote sebagai komentar di tengah fungsi
def proses_data(data):
    """
    Langkah-langkah pemrosesan:
    1. Validasi input
    2. Normalisasi
    3. Simpan ke database
    """      # ← ini bukan komentar, ini string yang dibuang
    validasi(data)
    normalisasi(data)
    simpan(data)

# BENAR: gunakan # untuk komentar non-docstring
def proses_data(data):
    # Langkah-langkah pemrosesan:
    # 1. Validasi input
    # 2. Normalisasi
    # 3. Simpan ke database
    validasi(data)
    normalisasi(data)
    simpan(data)

def tambah(a, b):
    """Mengembalikan jumlah dari dua bilangan."""
    return a + b

# Akses docstring secara programatik
print(tambah.__doc__)   # → Mengembalikan jumlah dari dua bilangan.
help(tambah)            # → menampilkan dokumentasi lengkap di terminal

def kuadrat(x):
    """Mengembalikan nilai x pangkat dua."""
    return x ** 2

def adalah_genap(n):
    """Mengembalikan True jika n adalah bilangan genap."""
    return n % 2 == 0

def bagi(a, b):
    """
    Membagi dua bilangan dengan penanganan pembagian nol.

    Fungsi ini berbeda dari operator / biasa karena mengembalikan
    None alih-alih melempar ZeroDivisionError ketika pembagi adalah 0.

    Args:
        a (float): Bilangan yang dibagi (dividend).
        b (float): Bilangan pembagi (divisor).

    Returns:
        float | None: Hasil pembagian, atau None jika b adalah 0.

    Examples:
        >>> bagi(10, 2)
        5.0
        >>> bagi(10, 0)
        None
    """
    if b == 0:
        return None
    return a / b

def transfer_saldo(dari_akun, ke_akun, jumlah):
    """
    Memindahkan saldo antar dua akun bank.

    Fungsi ini bersifat atomic — jika salah satu operasi gagal,
    seluruh transfer dibatalkan dan saldo dikembalikan ke kondisi semula.

    Args:
        dari_akun (str): ID akun pengirim.
        ke_akun (str): ID akun penerima.
        jumlah (float): Jumlah saldo yang dipindahkan. Harus positif.

    Returns:
        bool: True jika transfer berhasil, False jika gagal.

    Raises:
        ValueError: Jika jumlah tidak positif.
        AccountNotFoundError: Jika salah satu akun tidak ditemukan.

    Examples:
        >>> transfer_saldo("ACC001", "ACC002", 500000)
        True
    """
    if jumlah <= 0:
        raise ValueError(f"Jumlah transfer harus positif, bukan {jumlah}")
    # implementasi ...

def hitung_statistik(data):
    """
    Menghitung statistik deskriptif dari sekumpulan data numerik.

    Parameters
    ----------
    data : list of float
        Sekumpulan nilai numerik. Tidak boleh kosong.

    Returns
    -------
    dict
        Dictionary berisi kunci 'mean', 'median', 'std', 'min', 'max'.

    Raises
    ------
    ValueError
        Jika data adalah list kosong.

    Examples
    --------
    >>> hitung_statistik([1, 2, 3, 4, 5])
    {'mean': 3.0, 'median': 3.0, 'std': 1.58, 'min': 1, 'max': 5}
    """
    if not data:
        raise ValueError("Data tidak boleh kosong")
    # implementasi ...

class KeranjangBelanja:
    """
    Merepresentasikan keranjang belanja dalam sistem e-commerce.

    Keranjang menyimpan daftar item beserta jumlahnya dan
    menyediakan metode untuk menghitung total harga dengan
    memperhitungkan diskon dan pajak.

    Attributes:
        item (list): Daftar item dalam keranjang.
        diskon (float): Persentase diskon (0.0 hingga 1.0).
        pajak (float): Persentase pajak yang diterapkan.

    Examples:
        >>> keranjang = KeranjangBelanja()
        >>> keranjang.tambah_item("Buku Python", 75000, jumlah=2)
        >>> keranjang.total()
        150000
    """

    def __init__(self, diskon=0.0, pajak=0.11):
        """
        Inisialisasi keranjang belanja baru.

        Args:
            diskon (float): Persentase diskon. Default 0.0 (tidak ada diskon).
            pajak (float): Persentase pajak. Default 0.11 (PPN 11%).
        """
        self.item = []
        self.diskon = diskon
        self.pajak = pajak

"""
Modul utilitas untuk pemrosesan dan validasi data pengguna.

Modul ini menyediakan fungsi-fungsi untuk:
- Validasi format email, nomor telepon, dan NIK
- Normalisasi nama dan alamat
- Parsing data dari berbagai format input

Contoh penggunaan::

    from utils.user_validator import validasi_email, normalisasi_nama

    email = validasi_email("[email protected]")
    nama = normalisasi_nama("  john doe  ")

Dependencies:
    - re (stdlib)
    - phonenumbers >= 8.0

Author: Unis Badri
Created: 2024-01
"""

import re
import phonenumbers

# ANTI-PATTERN: komentar yang hanya mengulang apa yang sudah jelas dari kode
x = x + 1  # tambahkan 1 ke x
nama = nama.strip()  # hapus whitespace dari nama
result = []  # buat list kosong

# BENAR: komentar yang menjelaskan MENGAPA, bukan APA
x = x + 1  # offset karena indeks API dimulai dari 1, bukan 0
nama = nama.strip()  # input dari form HTML kadang mengandung spasi tak terlihat
result = []  # list ini akan diisi secara lazy, hanya jika kondisi X terpenuhi

# ANTI-PATTERN: komentar yang berbohong (lebih buruk dari tidak ada komentar)
# Menghitung rata-rata nilai
def hitung_total(nilai_list):      # ← nama fungsi tidak sesuai komentar
    return sum(nilai_list)

# BENAR: komentar dan kode harus selalu sinkron
# Menjumlahkan semua nilai dalam list
def hitung_total(nilai_list):
    return sum(nilai_list)

# ANTI-PATTERN: kode yang di-comment out dan dibiarkan
def proses_pembayaran(order):
    # validasi_lama(order)        # ← kenapa ini dicomment? masih dipakai?
    # kirim_notif_v1(order)       # ← apakah ini masih relevan?
    validasi_baru(order)
    kirim_notif_v2(order)

# BENAR: hapus kode mati. Gunakan git untuk melihat history jika perlu.
def proses_pembayaran(order):
    validasi_baru(order)
    kirim_notif_v2(order)

# TODO: tambahkan validasi untuk input berupa None
def hitung_diskon(harga, persen):
    return harga * (1 - persen / 100)

# FIXME: fungsi ini crash jika list kosong — belum sempat diperbaiki
def ambil_pertama(data):
    return data[0]

# NOTE: API endpoint ini akan deprecated di v3.0, gunakan /v3/users
def get_user_v2(user_id):
    return requests.get(f"/v2/users/{user_id}")

# HACK: solusi sementara untuk bug di library X versi 2.1.3
# Hapus ini setelah library diupgrade ke >= 2.2.0
hasil = hasil + 0.000001