Alur kerja sederhananya:

3. Membuat Module Pertama

Module adalah unit versi dan distribusi yang berisi satu atau lebih package. Buat proyek di direktori kosong:

Perintah terakhir membuat go.mod:

Direktif go mengikuti versi bahasa yang dipilih toolchain Anda dan dapat berbeda dari contoh. Untuk proyek yang diterbitkan, path module biasanya sama dengan lokasi repositori. Untuk latihan lokal, path contoh tetap valid.

Buat main.go:

Jalankan dan bangun:

package main dan fungsi main menandai program yang dapat dieksekusi. import "fmt" memakai package pustaka standar. Nama package berlaku per direktori: file .go biasa dalam satu direktori harus memakai nama package yang sama.

4. Module, Package, dan Import

Struktur kecil yang wajar:

Isi salam/salam.go:

Huruf awal kapital mengekspor Pesan agar dapat dipakai package lain. Ubah main.go:

Import menggunakan path module ditambah subdirektori package, bukan path filesystem absolut.

5. Dependensi dan Reproduksibilitas

Ketika kode mengimpor module eksternal, perintah Go dapat mengunduh versinya dan mencatatnya di go.mod; checksum konten tersimpan di go.sum. Jalankan:

Commit go.mod dan go.sum untuk aplikasi. Jangan mengedit go.sum manual. Cache dependensi bukan bagian proyek dan tidak perlu disalin.

Kesalahan Umum

• Menjalankan satu file dengan go run main.go pada proyek multifile. Gunakan go run . agar seluruh package dipertimbangkan.
• Menaruh beberapa package biasa dalam satu direktori. Pisahkan package ke direktori berbeda.
• Menganggap GOPATH sebagai lokasi wajib proyek. Module modern dapat berada di direktori mana pun.
• Path import tidak cocok dengan module di go.mod. Gunakan path module sebagai awalan.
• Tidak memformat kode. Jalankan go fmt ./...; format standar adalah bagian dari budaya Go.
• Mengabaikan hasil go test atau go vet. Keduanya menangkap masalah sebelum biner didistribusikan.

Latihan

1. Buat module example.com/profil yang mencetak nama dan pekerjaan Anda.
2. Tambahkan package teks dengan fungsi publik Judul(s string) string, lalu panggil dari main.
3. Jalankan go fmt ./..., go test ./..., go vet ./..., dan go build .. Catat fungsi setiap perintah.
4. Ubah nama package pada salah satu file menjadi nama berbeda, amati galat kompilasi, lalu perbaiki.
5. Gunakan go doc strings.ToUpper untuk membaca kontrak fungsi tanpa peramban.

Rangkuman

Go menyediakan toolchain terpadu untuk format, kompilasi, pengujian, dokumentasi, dan dependensi. go.mod menetapkan identitas module; direktori membentuk package; dan package main menghasilkan program. Siklus aman untuk proyek pemula adalah format, test, vet, lalu build.

Variabel tanpa initializer memperoleh zero value: 0 untuk angka, false untuk boolean, "" untuk string, dan nil untuk pointer, slice, map, channel, fungsi, serta interface.

:= adalah deklarasi singkat dan hanya berlaku di dalam fungsi. Gunakan var untuk variabel tingkat package atau ketika tipe/nilai nol perlu ditonjolkan.

Deklarasi singkat multivariabel boleh mendeklarasikan sebagian nama baru:

Baris kedua sah karena z baru; x hanya diberi nilai baru.

2. Konstanta dan Tipe Dasar

Konstanta ditentukan saat kompilasi dan tidak dapat diubah. Konstanta dapat tidak bertipe sampai konteks menuntut tipe tertentu.

Tipe dasar penting:

• bool;
• string;
• integer bertanda int, int8, int16, int32, int64;
• integer tanpa tanda uint, uint8, uint16, uint32, uint64;
• pecahan float32, float64;
• kompleks complex64, complex128;
• alias byte untuk uint8 dan rune untuk int32.

Gunakan int untuk hitungan umum dan indeks. Gunakan ukuran eksplisit untuk format data/protokol. Pilih float64 sebagai default pecahan, tetapi jangan memakainya untuk uang jika pembulatan desimal harus eksak; simpan satuan terkecil sebagai integer.

3. Konversi Eksplisit

Go tidak melakukan konversi numerik implisit.

Konversi dapat kehilangan informasi: int(3.9) menjadi 3, dan konversi ke integer sempit dapat meluap sesuai representasi. Validasi rentang di batas input sebelum mengonversi.

4. String, Byte, Rune, dan UTF-8

string adalah urutan byte yang immutable. Teks Go lazimnya UTF-8, tetapi sebuah string secara teknis dapat memuat byte apa pun. len(s) menghitung byte, bukan karakter pengguna.

Contoh yang memperlihatkan perbedaannya:

語 memerlukan tiga byte UTF-8. range mendekode rune dan memberikan indeks byte awal setiap rune. Rune mewakili code point Unicode, bukan selalu satu karakter yang terlihat; grafem seperti emoji keluarga dapat terdiri dari beberapa rune.

Indeks langsung menghasilkan byte:

Konversi []byte(s) cocok untuk data mentah/UTF-8; []rune(s) cocok ketika operasi memang berbasis code point. Keduanya mengalokasikan salinan yang dapat diubah.

String literal berinterpretasi memakai tanda petik dan escape seperti \n. Raw string memakai backtick dan mempertahankan baris serta backslash:

Kesalahan Umum

• Memakai := di tingkat package. Gunakan var atau const.
• Mencampur tipe angka tanpa konversi. Konversikan secara eksplisit dan periksa potensi kehilangan data.
• Menganggap len(string) menghitung huruf. len menghitung byte.
• Mengambil s[i] dan berharap rune. Hasilnya byte; gunakan range atau []rune bila perlu.
• Menganggap rune sama dengan grafem visual. Rune adalah code point, bukan seluruh karakter gabungan.
• Membuat variabel yang tidak digunakan. Go menolak variabel lokal dan import yang tidak dipakai.
• Melakukan shadowing tanpa sadar. x := dalam blok dalam dapat membuat variabel baru, bukan memperbarui variabel luar.

Latihan

1. Deklarasikan profil pengguna memakai string, int, dan bool; cetak zero value sebelum pemberian nilai.
2. Hitung luas lingkaran dengan konstanta tak bertipe dan float64.
3. Untuk string "Indonesia 🇮🇩", tampilkan jumlah byte, jumlah rune, indeks byte, dan setiap rune.
4. Buat program yang menerima jumlah detik sebagai int dan menghitung jam, menit, serta detik.
5. Tunjukkan satu konversi numerik yang kehilangan pecahan, lalu jelaskan hasilnya.

Rangkuman

Deklarasi Go menyeimbangkan kejelasan var dengan ringkasnya :=. Konstanta dapat tetap tidak bertipe hingga digunakan, sedangkan konversi antarangka selalu eksplisit. String menyimpan byte; rune merepresentasikan code point Unicode. Pilih operasi byte, rune, atau grafem sesuai kebutuhan, jangan berdasarkan asumsi bahwa semuanya setara dengan “karakter”.

Karena cabang pertama sudah return, else sebenarnya dapat dihilangkan untuk mengurangi indentasi.

if dapat memiliki pernyataan pendek yang scopenya terbatas pada seluruh rantai if:

2. switch

switch Go berhenti otomatis setelah satu kasus cocok; tidak memerlukan break. Beberapa nilai dapat berada dalam satu case.

Switch tanpa ekspresi setara dengan switch true dan berguna untuk kondisi berurutan:

Urutan kasus penting: kasus pertama yang benar dipilih. fallthrough ada, tetapi jarang dibutuhkan karena mengeksekusi kasus berikutnya tanpa memeriksa kondisinya.

3. Satu Kata Kunci Perulangan: for

Go memakai for untuk seluruh bentuk perulangan.

Perulangan tanpa kondisi berjalan sampai dihentikan:

Aliran keputusan loop:

4. Iterasi dengan range

range menghasilkan pasangan indeks/nilai untuk slice dan array, serta key/value untuk map.

Gunakan blank identifier untuk hasil yang tidak dibutuhkan:

Urutan iterasi map sengaja tidak ditentukan. Jangan mengandalkannya untuk output stabil; kumpulkan dan urutkan key terlebih dahulu jika urutan diperlukan.

Pada string, range menghasilkan indeks byte dan rune yang didekode. Pada slice nilai struct, variabel nilai adalah salinan; ubah elemen melalui indeks bila mutasi diperlukan:

5. break, continue, dan Label

continue melanjutkan iterasi berikutnya; break keluar dari loop atau switch terdekat.

Label berguna untuk keluar dari loop bersarang, tetapi sering kali fungsi kecil dan return lebih mudah dibaca:

Kesalahan Umum

• Menulis kondisi non-boolean. Gunakan perbandingan eksplisit, misalnya n != 0.
• Menambah break rutin pada setiap case. Switch Go tidak jatuh ke kasus berikutnya secara default.
• Loop tak berujung karena lupa memperbarui kondisi. Pastikan setiap jalur memajukan state atau berhenti.
• Mengandalkan urutan map. Urutkan key jika hasil harus deterministik.
• Memodifikasi salinan dari range. Gunakan indeks untuk mengubah elemen slice.
• Off-by-one. Untuk panjang len(data), indeks valid adalah 0 sampai len(data)-1; kondisi lazim adalah i < len(data).
• Scope variabel terlalu sempit. Nilai dari short statement if tidak tersedia setelah rantai tersebut.

Latihan

1. Cetak angka 1–100; ganti kelipatan 3 dengan Fizz, 5 dengan Buzz, dan keduanya dengan FizzBuzz.
2. Buat fungsi yang mengklasifikasikan usia menggunakan switch tanpa ekspresi.
3. Hitung nilai minimum, maksimum, dan rata-rata sebuah slice tanpa package tambahan.
4. Iterasi string beraksara multibyte dan tampilkan indeks byte serta rune.
5. Buat pencarian pada matriks yang berhenti ketika target ditemukan; implementasikan sekali dengan label dan sekali dengan fungsi yang mengembalikan hasil.

Rangkuman

if menangani keputusan boolean, sedangkan switch menyederhanakan banyak cabang dan berhenti otomatis. Semua perulangan memakai for; range memberi iterasi idiomatis atas koleksi dan string. Gunakan break, continue, dan label hanya ketika membuat alur lebih jelas, serta perhatikan scope, batas indeks, salinan nilai, dan urutan map yang tidak dijamin.

Beberapa hasil umum dipakai untuk nilai beserta status atau error. Named result tersedia, tetapi hasil eksplisit biasanya lebih jelas pada fungsi pendek. Fungsi variadik menerima nol atau lebih argumen:

Fungsi adalah nilai dan dapat disimpan atau dikirim sebagai argumen:

2. Pointer dan Semantik Nilai

Argumen selalu diteruskan by value. Jika argumennya pointer, nilai alamat itulah yang disalin, sehingga fungsi dapat mengubah objek tujuan.

&nilai mengambil alamat; *n membaca atau menulis nilai yang ditunjuk. Go tidak mendukung aritmetika pointer. Pointer memiliki zero value nil; dereference pointer nil menyebabkan panic.

Gunakan pointer ketika fungsi perlu memutasi nilai pemanggil, ketika penyalinan struct besar memang mahal, atau ketika nil bermakna. Jangan memakai pointer hanya agar kode terlihat efisien. Slice dan map sudah memiliki descriptor/header yang merujuk data internal; fungsi biasanya tidak memerlukan pointer ke slice atau map untuk mengubah elemennya.

3. Error sebagai Nilai

error adalah interface standar:

Fungsi yang dapat gagal lazimnya mengembalikan error terakhir. Pemeriksaan dilakukan segera.

Tambahkan konteks tanpa menghilangkan identitas error memakai %w:

Periksa rantai error dengan errors.Is, bukan membandingkan teks. Gunakan errors.As untuk mengambil tipe error tertentu.

Alur penanganannya:

4. Cleanup dengan defer

defer menjadwalkan pemanggilan sampai fungsi di sekitarnya selesai, baik melalui return normal maupun panic. Argumen deferred call dievaluasi saat defer dijalankan. Banyak defer dieksekusi LIFO.

Pola cleanup file:

Import yang diperlukan adalah errors, fmt, io, dan os. Untuk operasi tulis, error dari Close dapat penting; jangan selalu mengabaikannya. Hindari defer di loop panjang jika resource harus dilepas pada setiap iterasi; pindahkan satu iterasi ke fungsi kecil.

Kesalahan Umum

• Mengabaikan error dengan _. Abaikan hanya bila kegagalan benar-benar tidak relevan dan kontraknya dipahami.
• Membandingkan err.Error() sebagai teks. Gunakan errors.Is atau errors.As.
• Membungkus tanpa %w. %v memutus kemampuan pemeriksaan rantai.
• Dereference pointer nil. Validasi nil bila termasuk input yang mungkin.
• Menggunakan pointer tanpa kebutuhan. Nilai kecil lebih sederhana dan aman disalin.
• Menaruh defer sebelum memastikan resource berhasil dibuka. Jadwalkan cleanup setelah pemeriksaan error.
• Salah memahami argumen defer. Nilai argumen ditangkap saat pernyataan defer, bukan saat eksekusi akhir.

Latihan

1. Buat fungsi variadik yang mengembalikan minimum dan error jika tidak ada argumen.
2. Buat fungsi tukar(a, b *int) dan uji perubahan pada pemanggil.
3. Definisikan sentinel error untuk saldo tidak cukup; bungkus dengan konteks dan periksa memakai errors.Is.
4. Prediksi keluaran tiga defer, lalu jalankan untuk memverifikasi urutan LIFO.
5. Buat fungsi pembaca file yang selalu menutup file dan menambahkan nama file pada error.

Rangkuman

Fungsi Go mendukung beberapa hasil, nilai fungsi, dan parameter variadik. Semua argumen disalin; pointer memungkinkan mutasi terhadap nilai tujuan, tetapi harus digunakan dengan alasan jelas. Error adalah nilai yang diperiksa, diberi konteks dengan %w, dan dikenali melalui errors.Is/errors.As. defer menempatkan cleanup dekat akuisisi resource dan berjalan dalam urutan LIFO.

Assignment dan parameter array menyalin seluruh array. Array berguna untuk ukuran intrinsik dan tetap, misalnya hash 32 byte. Untuk koleksi umum, slice lebih fleksibel.

2. Slice: Tampilan ke Backing Array

Slice bukan array. Slice adalah descriptor yang mereferensikan segmen backing array, dengan panjang (len) dan kapasitas (cap).

Batas a[low:high] mencakup low dan tidak mencakup high. Kapasitas dihitung dari awal slice sampai akhir backing array yang tersedia.

Buat slice dengan make ketika panjang atau kapasitas diketahui:

make([]int, 3) menghasilkan tiga elemen yang sudah dapat diindeks. make([]int, 0, 8) belum memiliki elemen, sehingga b[0] panic; kapasitas bukan panjang.

3. append, Kapasitas, dan Alias

append mengembalikan slice baru dan hasilnya harus disimpan. Jika kapasitas cukup, backing array lama dapat dipakai; jika tidak, runtime mengalokasikan array baru.

Karena dua slice dapat berbagi backing array, perubahan atau append kadang terlihat melalui slice lain dan kadang tidak setelah realokasi. Jangan bergantung pada detail pertumbuhan kapasitas.

Gunakan full slice expression untuk membatasi kapasitas saat perlu mencegah append menimpa bagian lain:

Kapasitas kiri dibatasi dua, sehingga append memerlukan backing array baru.

4. Menyalin Slice

Assignment slice menyalin header, bukan elemen. Untuk salinan independen, gunakan copy atau append ke slice baru.

copy(dst, src) mengembalikan jumlah elemen yang disalin, yaitu minimum panjang keduanya.

5. Slice Nil dan Kosong

Ketiganya memiliki panjang nol dan aman untuk range serta append. Hanya nilSlice == nil yang benar. Perbedaan dapat tampak pada serialisasi atau API eksternal (null versus []), sehingga ikuti kontrak boundary. Slice tidak dapat dibandingkan dengan slice lain; hanya dapat dibandingkan dengan nil.

6. Map dan comma-ok

Map menyimpan pasangan key-value. Key harus comparable; slice, map, dan function tidak dapat menjadi key.

Lookup key yang tidak ada menghasilkan zero value. Karena zero value mungkin nilai valid, gunakan bentuk nilai, ada := m[key] untuk membedakannya.

Map nil dapat dibaca dan menghasilkan zero value, tetapi penulisan menyebabkan panic:

Map adalah reference-like descriptor. Assignment atau pengiriman ke fungsi membuat descriptor baru yang mengacu data map sama. Map tidak aman untuk read/write bersamaan tanpa sinkronisasi. Urutan iterasinya tidak ditentukan.

Pola penghitung:

Zero value int membuat increment langsung bekerja tanpa pemeriksaan keberadaan.

Kesalahan Umum

• Menganggap kapasitas sebagai elemen yang dapat diindeks. Indeks harus selalu kurang dari len.
• Mengabaikan hasil append. Tulis s = append(s, x).
• Mengira assignment slice menyalin data. Gunakan copy untuk independensi.
• Tidak menyadari alias backing array. Salin atau batasi kapasitas ketika isolasi diperlukan.
• Menulis ke map nil. Inisialisasi dengan literal atau make.
• Mengandalkan zero value lookup untuk membuktikan key ada. Gunakan comma-ok.
• Mengandalkan urutan iterasi map. Urutkan key untuk keluaran stabil.
• Membandingkan dua slice atau map. Keduanya hanya dapat dibandingkan dengan nil.

Latihan

1. Buat array tujuh suhu harian, lalu hitung rata-ratanya melalui slice.
2. Buat slice dengan kapasitas awal lima, tambahkan sepuluh elemen, dan cetak len/cap setelah setiap append.
3. Demonstrasikan dua slice yang berbagi backing array, lalu buat versi independen dengan copy.
4. Hitung frekuensi setiap kata dalam kalimat memakai map[string]int.
5. Buat fungsi lookup kontak yang mengembalikan nomor dan bool, termasuk kasus nomor kosong sebagai nilai valid.
6. Bandingkan perilaku slice nil dan kosong saat len, range, append, dan pemeriksaan == nil.

Rangkuman

Array memiliki ukuran tetap yang menjadi bagian tipe. Slice menyediakan tampilan fleksibel ke backing array melalui pointer, panjang, dan kapasitas; append dapat mempertahankan atau mengganti storage, sedangkan copy membuat elemen independen. Map memberi lookup efisien tetapi tidak menjamin urutan. Pahami nilai nil, aliasing, batas indeks, dan pola comma-ok agar pengelolaan koleksi tetap benar.

Utamakan literal bernama seperti Task{ID: 1, Title: "..."}. Bentuk ini tetap jelas ketika urutan field berubah.

2. Method dan Receiver

Method adalah fungsi yang terikat pada tipe. Receiver nilai menerima salinan; receiver pointer dapat mengubah nilai asal.

Gunakan receiver pointer ketika method memodifikasi objek atau struct cukup besar. Gunakan receiver nilai untuk operasi baca pada nilai kecil. Jangan mencampur keduanya tanpa alasan yang jelas.

3. Interface: Kontrak Perilaku

Implementasi interface di Go bersifat implisit. Sebuah tipe memenuhi interface jika memiliki seluruh method yang diminta.

Definisikan interface di sisi pemakai, bukan otomatis di sisi implementasi. Terima interface jika fungsi benar-benar membutuhkan variasi perilaku; kembalikan tipe konkret agar API tetap mudah digunakan.

Method Set dan Pointer

Jika method didefinisikan pada *Task, biasanya hanya *Task yang memenuhi interface terkait. Method dengan receiver nilai tersedia bagi Task dan *Task.

Pernyataan di atas merupakan pemeriksaan saat kompilasi bahwa Task memenuhi fmt.Stringer.

4. Komposisi dan Embedding

Go tidak memiliki pewarisan kelas. Bangun tipe kompleks dengan menyusun tipe yang lebih kecil.

Embedding mempromosikan field dan method, tetapi nilai embedded tetap merupakan bagian objek, bukan hubungan “adalah”.

Gunakan field bernama ketika embedding membuat API ambigu. Komposisi eksplisit sering lebih mudah dibaca:

5. Contoh: Service dengan Store

All mengembalikan salinan slice agar pemanggil tidak dapat mengubah penyimpanan secara tidak sengaja.

Kesalahan Umum

1. Semua hal dijadikan interface. Mulailah dengan tipe konkret; ekstrak interface saat ada kebutuhan substitusi atau pengujian.
2. Receiver nilai untuk mutasi. Perubahan hanya terjadi pada salinan.
3. Interface terlalu besar. Pecah berdasarkan kebutuhan pemakai; satu sampai tiga method sering cukup.
4. Menganggap embedding sebagai inheritance. Embedded type tidak membentuk hierarki subtype.
5. Mengekspor seluruh field. Ekspor hanya bagian API yang memang diperlukan.
6. Menyalin struct yang mengandung mutex. Gunakan pointer dan jangan menyalin nilai sinkronisasi.
7. Nil pointer di dalam interface. Interface dapat tidak nil meskipun nilai konkret di dalamnya berupa pointer nil.

Latihan

1. Tambahkan Priority int pada Task dan method Validate() error dengan rentang 1–5.
2. Buat interface TaskReader yang hanya memiliki All() []Task.
3. Implementasikan FindByID(int) (Task, bool) pada MemoryStore.
4. Buat Logger kecil dengan method Printf(string, ...any) dan injeksikan ke Service.
5. Jelaskan kapan field bernama lebih baik daripada embedding pada contoh Metadata.

Ringkasan

• struct memodelkan data; method menempatkan perilaku dekat dengan data.
• Receiver pointer diperlukan untuk mutasi, sedangkan receiver nilai cocok untuk operasi baca pada nilai kecil.
• Interface Go dipenuhi secara implisit dan sebaiknya kecil serta berpusat pada kebutuhan pemakai.
• Komposisi menggantikan pewarisan dan menjaga hubungan antarkomponen tetap eksplisit.

Import dikelompokkan oleh gofmt: pustaka standar, baris kosong, lalu package module atau pihak ketiga. Hindari dot import karena asal identifier menjadi tidak jelas.

3. Struktur Proyek yang Proporsional

Untuk aplikasi kecil, satu main.go dapat cukup. Pecah direktori setelah ada tanggung jawab nyata yang berbeda.

Direktori cmd/taskcli berisi entry point. internal/task menyimpan kode aplikasi yang tidak boleh diimpor module lain. Go menegakkan batas internal saat kompilasi.

Jangan menyalin struktur proyek besar tanpa kebutuhan. Folder generik seperti utils, common, atau helpers sering menyembunyikan tanggung jawab yang tidak jelas.

4. Siklus Import

Go melarang import cycle. Jika package task mengimpor storage, maka storage tidak boleh kembali mengimpor task.

Solusi yang lazim:

• pindahkan tipe domain ke package yang paling memilikinya;
• definisikan interface kecil di package pemakai;
• gabungkan package jika pemisahannya tidak memberi manfaat;
• pindahkan kode bersama ke package ketiga hanya jika konsepnya benar-benar mandiri.

5. Mengelola Dependensi

go.mod mencatat path module, versi Go, dan kebutuhan module lain. go.sum mencatat checksum untuk verifikasi unduhan.

go mod tidy menambah dependensi yang diperlukan dan menghapus yang tidak dipakai. Jalankan setelah perubahan import.

Jika memang memerlukan package eksternal:

Gunakan versi eksplisit bila proyek menuntut reproduksibilitas. Evaluasi lisensi, pemeliharaan, keamanan, dan ukuran transitive dependency sebelum menambah library. Pustaka standar sering sudah cukup.

Untuk memperbarui dependensi langsung dan tidak langsung sesuai batas kompatibilitas:

Tinjau perubahan go.mod dan go.sum; jangan memperbarui tanpa menjalankan pengujian.

6. Package Documentation dan API

Dokumentasi identifier yang diekspor dimulai dengan namanya.

API package yang baik memiliki permukaan kecil, nama jelas, dan aturan error yang konsisten. Hindari mengekspos representasi internal jika pengguna hanya memerlukan operasi tingkat tinggi.

7. Contoh Proyek Minimal yang Dapat Dikompilasi

Kesalahan Umum

1. Terlalu dini membuat banyak package. Mulai sederhana dan pisahkan saat tanggung jawab jelas.
2. Nama package mengulang nama tipe. task.Task lebih baik daripada taskmodel.TaskModel.
3. Mengedit go.sum secara manual. Biarkan tool Go mengelolanya.
4. Mengabaikan go mod tidy. Module dapat menyimpan kebutuhan usang atau kehilangan dependensi.
5. Memakai replace lokal lalu lupa menghapusnya. Build pengguna lain akan gagal.
6. Menciptakan import cycle. Evaluasi kembali arah dependensi atau batas package.
7. Menambah library untuk fungsi kecil. Periksa pustaka standar terlebih dahulu.

Latihan

1. Buat module example.com/library dengan package book dan program di cmd/catalog.
2. Pindahkan package book ke internal/book, lalu coba impor dari module lain dan amati error.
3. Jalankan go list ./..., go mod tidy, dan go mod verify; jelaskan fungsi tiap perintah.
4. Temukan package bernama utils pada proyek latihan dan ubah menjadi package dengan tanggung jawab spesifik.
5. Tambahkan satu dependency kecil hanya untuk eksperimen, periksa go mod graph, lalu hapus import dan jalankan go mod tidy.

Ringkasan

• Package mengelompokkan kode berdasarkan tanggung jawab; module memberi identitas dan versi pada kumpulan package.
• Struktur proyek harus tumbuh mengikuti kebutuhan, bukan template yang berlebihan.
• internal menyediakan batas akses yang ditegakkan toolchain.
• go mod tidy, verify, dan pengujian menjaga dependensi tetap konsisten dan dapat direproduksi.

Mode 0o600 memberi akses baca-tulis kepada pemilik. Permission aktual dapat dipersempit oleh umask. Untuk data pengguna yang mungkin sensitif, jangan memakai mode yang dapat dibaca semua pengguna.

Untuk data besar atau streaming, gunakan os.Open, bufio.Scanner, bufio.Reader, atau io.Copy. File yang dibuka harus ditutup.

Pada file output, error Close dapat penting karena flush terakhir bisa gagal. Tangani secara eksplisit jika kehilangan data berisiko.

2. JSON dan Struct Tags

Package encoding/json memetakan field struct yang diekspor. Tag mengatur nama key.

Untuk membaca JSON yang tidak dipercaya, decoder dapat menolak field asing:

Marshal hanya gagal untuk nilai yang tidak didukung, seperti channel, function, atau siklus pointer. Tetap tangani error.

3. Memuat Data dengan Semantik yang Jelas

File belum ada dapat berarti aplikasi baru, bukan kegagalan.

Jangan memperlakukan permission denied atau kerusakan disk sebagai “data kosong”; tindakan tersebut menyembunyikan masalah dan berpotensi menimpa data.

4. Penulisan Atomik

os.WriteFile langsung ke file tujuan dapat meninggalkan file terpotong bila proses berhenti. Pola yang lebih aman adalah menulis file sementara pada direktori yang sama, menyinkronkan, menutup, lalu mengganti nama.

Program lengkap berikut menyediakan penyimpanan JSON sederhana:

Rename atomik secara umum jika sumber dan tujuan berada pada filesystem yang sama; karena itu file sementara dibuat di direktori tujuan. Jaminan detail tetap bergantung pada sistem operasi dan filesystem. Untuk ketahanan terhadap kehilangan daya yang lebih ketat, sinkronisasi direktori setelah rename dapat diperlukan.

5. Menentukan Lokasi Data CLI

Hindari menulis data tetap di current working directory karena direktori tersebut berubah sesuai cara program dijalankan. Gunakan direktori konfigurasi pengguna:

Izinkan flag seperti -file agar pengujian dan otomasi dapat memilih lokasi lain. Jangan membangun path dengan penggabungan string; gunakan filepath.Join.

6. Batas Persistensi JSON

JSON sesuai untuk CLI pengguna tunggal dengan data kecil. Ia bukan solusi ideal untuk banyak proses yang menulis bersamaan, query kompleks, atau dataset besar. Penulisan atomik mencegah file setengah jadi, tetapi tidak mencegah lost update antara dua proses. Pada kebutuhan tersebut, tambahkan locking yang sesuai platform atau beralih ke database transaksional.

Kesalahan Umum

1. Mengabaikan error I/O atau JSON. Selalu beri konteks dengan %w.
2. Menimpa file ketika decode gagal. Hentikan operasi dan laporkan kerusakan data.
3. Membuat temp file di filesystem lain. Rename dapat gagal dan kehilangan sifat atomik.
4. Permission terlalu longgar. Gunakan 0o600 untuk file data pribadi dan 0o700 untuk direktori.
5. Lupa menutup file. Gunakan defer untuk input; tangani error close pada output penting.
6. Mengandalkan current working directory. Gunakan direktori pengguna atau flag eksplisit.
7. Menganggap JSON sebagai database multiwriter. Tambahkan koordinasi atau gunakan penyimpanan transaksional.

Latihan

1. Tambahkan field CreatedAt time.Time dan amati representasi JSON-nya.
2. Gunakan json.Decoder dengan DisallowUnknownFields untuk memuat file.
3. Tulis fungsi Backup(path string) yang menyalin data lama sebelum perubahan.
4. Uji Load untuk file tidak ada, kosong, JSON rusak, dan JSON valid.
5. Tambahkan flag -file ke CLI kecil dan gunakan t.TempDir() dalam pengujian.

Ringkasan

• Pilih API file sesuai ukuran dan pola akses data.
• Struct tag mengontrol format JSON; semua kegagalan encode/decode harus ditangani.
• Bedakan file tidak ada dari error I/O lain.
• Temp-file, Sync, Close, dan Rename mengurangi risiko korupsi saat menyimpan.
• JSON cocok untuk persistensi sederhana, bukan konkurensi penulis tanpa koordinasi.

Gunakan Fatalf jika test tidak dapat dilanjutkan; gunakan Errorf jika pemeriksaan lain masih bermakna. Pesan kegagalan sebaiknya memuat nilai aktual dan nilai yang diharapkan.

2. Table-Driven Tests

Table-driven test mengumpulkan beberapa skenario dalam satu struktur data. Setiap kasus dijalankan sebagai subtest dengan t.Run.

Nama kasus harus menjelaskan perilaku, bukan nomor urut. Jangan memakai table-driven test jika hanya ada satu skenario sederhana dan tabel justru mengaburkan maksud.

3. Helper dan Cleanup

t.Helper() membuat lokasi kegagalan menunjuk ke pemanggil helper. t.Cleanup() memastikan pembersihan dijalankan setelah test.

Untuk file, gunakan t.TempDir(). Direktori unik tersebut dibersihkan otomatis dan tidak menyentuh data pengguna.

4. Determinisme dan Isolasi

Test yang baik memberikan hasil sama pada setiap eksekusi. Hindari ketergantungan pada:

• waktu nyata tanpa cara mengendalikannya;
• urutan iterasi map;
• jaringan eksternal;
• direktori kerja atau file pengguna;
• state global yang dibagi antartest.

Jika logika membutuhkan waktu, injeksikan fungsi atau nilai waktu. Jika keluaran berasal dari map, urutkan key sebelum membandingkan. Jalankan t.Parallel() hanya setelah memastikan tidak ada state bersama yang berubah.

5. Membandingkan Error

Jangan membandingkan teks error jika kode menyediakan sentinel error atau tipe khusus.

Gunakan errors.As untuk memeriksa tipe error. Pemeriksaan string rapuh karena perubahan redaksi dapat merusak test tanpa mengubah perilaku.

6. Coverage

Coverage menunjukkan bagian statement yang dieksekusi, bukan kualitas pengujian.

Coverage tinggi tetap dapat melewatkan assertion penting, error path, race, atau kebutuhan bisnis. Gunakan laporan untuk menemukan area yang belum diuji, bukan sebagai satu-satunya target kualitas.

7. Race Detector

Data race terjadi ketika goroutine mengakses lokasi memori yang sama secara bersamaan, setidaknya satu akses adalah penulisan, dan tidak ada sinkronisasi yang benar.

Race detector hanya menemukan race pada jalur yang benar-benar dijalankan. Ia menambah waktu dan memori, tetapi sangat bernilai pada CI atau sebelum rilis. Race detector bukan pengganti desain sinkronisasi dan tidak mendeteksi semua logical race.

8. Perintah Verifikasi Praktis

-shuffle=on membantu menemukan ketergantungan urutan. -count=10 membantu mengungkap test yang sesekali gagal, tetapi bukan bukti mutlak bahwa test bebas flakiness.

Kesalahan Umum

1. Hanya menguji happy path. Sertakan input batas, error, dan data rusak.
2. Assertion tanpa pesan diagnostik. Tampilkan aktual, harapan, dan input relevan.
3. Test memakai file pengguna. Gunakan t.TempDir().
4. Mengejar 100% coverage tanpa nilai. Prioritaskan risiko dan perilaku penting.
5. Memakai t.Parallel() pada state bersama. Isolasi atau sinkronkan terlebih dahulu.
6. Mengabaikan hasil -race. Race adalah bug; perbaiki, jangan sekadar menonaktifkan pemeriksaan.
7. Sleep untuk sinkronisasi. Gunakan channel, WaitGroup, atau primitive sinkronisasi lain.

Latihan

1. Tambahkan kasus batas pada TestNewTable, termasuk whitespace Unicode.
2. Tulis test Load untuk file valid, tidak ada, kosong, dan JSON rusak menggunakan t.TempDir().
3. Buat helper fixture dengan t.Helper().
4. Sengaja hapus mutex dari Counter, jalankan go test -race, lalu perbaiki kembali.
5. Buat laporan coverage dan identifikasi satu error path yang belum diuji.

Ringkasan

• Package testing menyediakan unit test tanpa framework tambahan.
• Table-driven tests efektif untuk banyak variasi perilaku yang sama.
• Helper, t.TempDir, dan input terkendali menjaga test diagnostik serta deterministik.
• Coverage mengukur eksekusi statement, bukan kebenaran.
• Race detector menemukan akses memori tidak tersinkronisasi pada jalur yang diuji.

main menangani argumen, output, dan exit code. Package task memiliki aturan aplikasi. JSONStore menangani file. Interface didefinisikan di sisi pemakai agar kontraknya kecil.

3. Struktur File

Buat module:

4. Model Domain

Sentinel error memungkinkan pemanggil menggunakan errors.Is. Batas byte sederhana dan deterministik. Jika kebutuhan berubah menjadi batas karakter pengguna, gunakan perhitungan rune dan tetapkan aturan Unicode dengan jelas.

5. Logika Aplikasi

Aplikasi melakukan load-modify-save. Desain ini cukup untuk satu proses dan data kecil. Dua proses yang menulis bersamaan dapat mengalami lost update; tambahkan file locking atau database ketika multiwriter menjadi kebutuhan nyata.

6. JSON Store dengan Penulisan Atomik

File sementara berada pada direktori yang sama agar Rename tidak melintasi filesystem. Deferred cleanup menghapus temp file pada jalur error.

7. Entry Point dan Parsing CLI

Logika run dapat diuji tanpa menjalankan subprocess karena menerima argumen dan writer. main tetap kecil dan menjadi satu-satunya tempat yang memanggil os.Exit.

8. Pengujian Table-Driven

Tambahkan test untuk save error, load error, ID maksimum, delete, file tidak ada, dan argumen CLI. Test run dapat memakai bytes.Buffer sebagai stdout dan stderr.

9. Validasi dan Penanganan Error

Validasi dilakukan pada dua batas:

1. CLI: jumlah argumen, nama perintah, dan format ID.
2. Domain: judul kosong/panjang dan keberadaan tugas.

Error I/O dibungkus memakai %w agar konteks terbaca tanpa kehilangan penyebab. Jangan mencetak error pada setiap lapisan; kembalikan error sampai main, lalu cetak sekali ke stderr. Output normal masuk stdout agar dapat dipipe.

Exit code versi ini:

• 0: operasi berhasil;
• 1: input, domain, atau operasi gagal.

Jika otomasi nantinya perlu membedakan kesalahan penggunaan dari kegagalan penyimpanan, petakan error ke exit code khusus di main. Jangan menambahkan klasifikasi sebelum ada konsumen nyata.

10. Build dan Penggunaan

Flag global harus muncul sebelum subcommand karena flag.FlagSet berhenti memproses flag pada argumen non-flag pertama.

11. Perintah Verifikasi

Jalankan seluruh pemeriksaan dari root module:

Verifikasi perilaku kegagalan:

Perintah di atas harus gagal tanpa mengganti file JSON rusak. Periksa stdout, stderr, dan exit status:

12. Kriteria Selesai

• semua contoh dikompilasi dengan versi Go pada go.mod;
• data bertahan setelah proses berhenti;
• file tidak ada dianggap daftar kosong, tetapi JSON rusak dilaporkan;
• write memakai temp file pada direktori tujuan dan rename;
• input tidak valid menghasilkan pesan jelas di stderr dan status nonzero;
• test tidak membaca atau menulis data pengguna;
• go vet, go test, dan go test -race berhasil;
• binary dapat dibangun tanpa dependency eksternal.

Kesalahan Umum

1. Menaruh seluruh logika di main. Pisahkan parsing dari domain dan penyimpanan.
2. Mengabaikan save error setelah mutasi. Laporkan kegagalan; jangan mengumumkan keberhasilan.
3. Menimpa JSON rusak dengan daftar kosong. Bedakan os.ErrNotExist dari decode error.
4. Menghasilkan ID dari panjang slice. Penghapusan dapat menyebabkan ID dipakai ulang; cari ID maksimum.
5. Mencetak error di banyak lapisan. Error menjadi duplikat; cetak sekali di batas proses.
6. Menggunakan file produksi dalam test. Selalu gunakan t.TempDir() atau fake store.
7. Menganggap atomic write menyelesaikan multiwriter. Ia mencegah file parsial, bukan lost update.
8. Menambahkan framework CLI terlalu dini. Pustaka standar cukup untuk empat subcommand sederhana.

Latihan dan Pengembangan

1. Tambahkan perintah edit <id> <judul> beserta table-driven tests.
2. Tambahkan filter list --done dan list --pending; tentukan posisi flag secara konsisten.
3. Uji fungsi run menggunakan bytes.Buffer untuk stdout dan stderr.
4. Tambahkan field waktu dengan clock yang dapat diinjeksi agar test deterministik.
5. Tambahkan validasi duplikasi ID ketika membaca data.
6. Jika benar-benar membutuhkan dua proses penulis, evaluasi locking lintas platform atau database transaksional dan dokumentasikan trade-off.
7. Tambahkan sinkronisasi direktori setelah rename untuk kebutuhan durability yang lebih ketat pada platform yang mendukungnya.

Ringkasan

• Proyek memisahkan antarmuka CLI, aturan aplikasi, dan persistensi tanpa abstraksi berlebihan.
• Validasi ditempatkan pada batas input dan domain; error dibungkus lalu dicetak sekali.
• JSON store memakai permission terbatas dan pola temp-write-sync-close-rename.
• Table-driven tests, fake store, dan t.TempDir() menjaga pengujian cepat serta terisolasi.
• Format, vet, test, race detector, coverage, dan build membentuk verifikasi sebelum rilis.