Fase 7 · Modul & Proyek Akhir

PEP 8 — Gaya Menulis Kode

Kode dibaca jauh lebih sering daripada ditulis. PEP 8 adalah kesepakatan agar semua kode Python di dunia terlihat serupa.

Sumber asli peps.python.org Resmi Rangkuman ~4 menit baca

Intisari

Indentasi 4 spasi, tidak pernah Tab.
Nama variabel dan fungsi: huruf_kecil_pakai_garis_bawah. Konstanta: HURUF_BESAR.
Spasi di kiri-kanan operator: x = a + b, bukan x=a+b.
Baris maksimal sekitar 79–88 karakter. Dua baris kosong antar fungsi.
Jangan menghafal semuanya — pasang formatter dan biarkan ia yang merapikan.

Kenapa gaya itu penting

# Sah menurut Python, menyakitkan bagi manusia
def hitungGaji( pokok,lembur ):
  TOTAL=pokok+lembur*25000
  return TOTAL

# Sesuai PEP 8
def hitung_gaji(pokok, lembur):
    total = pokok + lembur * 25000
    return total

Keduanya berjalan sama persis. Bedanya, yang kedua terlihat seperti kode Python semua orang — sehingga siapa pun (termasuk kamu bulan depan) bisa langsung membacanya tanpa penyesuaian.

Penamaan

Jenis	Gaya	Contoh
Variabel & fungsi	huruf kecil, garis bawah	`jumlah_siswa`, `hitung_gaji()`
Konstanta	HURUF BESAR	`PAJAK_PERSEN = 11`
Class	Huruf besar tiap kata	`DaftarTugas`
Nama sementara	garis bawah	`for _ in range(3):`

Nama yang jelas mengalahkan nama yang pendek. jumlah_siswa_lulus lebih baik daripada jsl. Yang harus dihindari cuma nama yang tidak berarti apa-apa — data, info, temp, x.

Spasi

# Benar
x = a + b
def f(a, b=1):
    ...
daftar = [1, 2, 3]
print(daftar[0])

# Salah
x=a+b
def f( a,b = 1 ):
    ...
daftar = [ 1,2,3 ]
print (daftar [0])

Baris dan blok

import json
from pathlib import Path        # ← semua import di paling atas


PAJAK = 11                      # ← konstanta setelahnya


def hitung_pajak(harga):        # ← dua baris kosong antar fungsi
    return harga * PAJAK / 100


def total(harga):
    return harga + hitung_pajak(harga)


if __name__ == "__main__":
    print(total(100_000))

Panjang baris dibatasi sekitar 79 karakter menurut PEP 8; banyak proyek modern melonggarkannya ke 88. Yang penting: satu baris harus muat dilihat tanpa menggeser layar ke samping.

Komentar

# Buruk — mengulang yang sudah terbaca
total = harga * 1.11    # kalikan harga dengan 1.11

# Baik — menjelaskan yang tidak terlihat
total = harga * 1.11    # PPN 11% per Permenkeu 2022

Jangan menghafal — otomatiskan

Semua aturan di atas bisa diserahkan ke alat. Di VS Code, pasang extension Ruff, lalu:

pip install ruff

ruff format .        # rapikan seluruh gaya penulisan
ruff check .         # cari masalah gaya dan kode yang mencurigakan
ruff check --fix .   # perbaiki yang bisa diperbaiki otomatis

Nyalakan juga Format On Save di VS Code. Setelah itu kamu tidak perlu memikirkan spasi dan baris kosong sama sekali — cukup tekan simpan.

Satu aturan PEP 8 yang layak diingat di atas segalanya: konsistensi di dalam satu proyek lebih penting daripada mengikuti aturan secara harfiah. Kalau kamu bergabung ke kode yang gayanya berbeda, ikuti gaya yang sudah ada di sana.

Setelah roadmap ini

Kamu sudah menguasai dasar Python: variabel, percabangan, perulangan, struktur data, fungsi, file, error, dan modul. Itu fondasi yang sama untuk ke mana pun kamu melanjutkan — web, otomasi, analisis data, atau AI.

Langkah paling berguna berikutnya bukan menambah materi, tapi membangun sesuatu yang kamu pakai sendiri. Proyek kecil yang benar-benar berguna mengajarkan lebih banyak daripada sepuluh tutorial.

Latihan terakhir: buka semua kode latihan yang kamu tulis sejak Fase 0. Jalankan ruff format dan ruff check pada semuanya, perbaiki yang dikeluhkan, dan beri docstring pada tiap fungsi. Itu kode pertamamu yang layak ditunjukkan ke orang lain.

Rangkuman ini sengaja dipangkas ke bagian yang dipakai di roadmap. Buka sumber aslinya saat kamu butuh detail lengkap atau referensi parameter.