blog: terjemahkan "Introducing gofix"

Blog ini berisi sejarah dan pengenalan terhadap perkakas gofix.

2 files changed, 127 insertions, 0 deletions

diff --git a/_content/blog/index.adoc b/_content/blog/index.adoc
index 44336c6..7ee1a5c 100644
--- a/_content/blog/index.adoc
+++ b/_content/blog/index.adoc
@@ -124,6 +124,9 @@
    interface pada Go^],
    25 Mei 2011.  Rob Pike.
 
+*  link:/blog/introducing-gofix/[Memperkenalkan gofix^],
+   15 April 2011.  Russ Cox.
+
 *  link:/blog/godoc/[godoc: Mendokumentasikan kode Go^],
    31 Maret 2011.  Andrew Gerrand.
 
diff --git a/_content/blog/introducing-gofix/index.adoc b/_content/blog/introducing-gofix/index.adoc
new file mode 100644
index 0000000..74ad9cd
--- /dev/null
+++ b/_content/blog/introducing-gofix/index.adoc
@@ -0,0 +1,124 @@
+= Memperkenalkan gofix
+Russ Cox
+15 April 2011
+
+Rilis Go berikutnya akan mengikutkan perubahan API yang signifikan pada
+beberapa paket Go yang fundamental.
+Kode yang mengimplementasikan
+https://codereview.appspot.com/4239076[penanganan server HTTP^],
+https://codereview.appspot.com/4244055[pemanggilan `net.Dial`^],
+atau
+https://codereview.appspot.com/4281055[penggunaan paket "reflect"^]
+tidak akan bisa dibangun kecuali diperbarui menggunakan API yang baru.
+Semenjak rilis kita
+https://blog.golang.org/2011/03/go-becomes-more-stable.html[lebih stabil dan jarang^],
+situasi seperti ini akan lebih sering terjadi.
+Setiap perubahan API ini terjadi pada _snapshot_ Go di minggu yang berbeda;
+bersamaan, mereka merepresentasikan sejumlah perubahan manual yang signifikan
+untuk memperbarui kode yang sudah ada.
+
+link:/cmd/fix/[Gofix^] adalah sebuah perkakas baru yang mengurangi jumlah
+pekerjaan untuk memperbarui kode.
+Ia membaca berkas sumber kode, mencari penggunaan API yang lama, menulis ulang
+sumber kode tersebut supaya menggunakan API yang baru.
+Tidak semua perubahan API menjaga fungsionalitas dari API yang lama, jadi
+gofix tidak selalu bekerja dengan sempurna.
+Saat gofix tidak dapat menulis ulang API yang lama, ia akan melaporkan
+peringatan tersebut dengan mencetak nama berkas dan nomor baris pada kode
+lama, supaya pengembang dapat memeriksa dan menulis ulang kode secara manual.
+Gofix mengerjakan perubahan yang gampang, repetitif, dan memakan waktu,
+sehingga pengembang dapat fokus pada perubahan yang membutuhkan perhatian
+saja.
+
+Setiap kali kita membuat perubahan API yang signifikan kita akan memperbarui
+kode pada gofix untuk melakukan konversi, sebanyak mungkin.
+Saat Anda memperbarui Go ke rilis yang baru and kode Anda tidak lagi bisa
+dibangun, cukup jalankan gofix pada direktori sumber kode Anda.
+
+Anda dapat mengembangkan gofix untuk mendukung perubahan pada API Anda
+sendiri.
+Program gofix adalah sebuah pustaka sederhana yang membungkus _plugin_ bernama
+"fixes" yang menangani perubahan API tertentu.
+Saat ini, menulis sebuah perbaikan yang baru membutuhkan pemindaian dan
+penulisan sintaksis "go/ast", biasanya sebanding dengan seberapa kompleks
+perubahan API yang terjadi.
+Jika Anda ingin mengeksplorasi,
+https://go.googlesource.com/go/+/go1/src/cmd/fix/netdial.go[netdialFix^],
+https://go.googlesource.com/go/+/go1/src/cmd/fix/osopen.go[osopenFix^],
+https://go.googlesource.com/go/+/go1/src/cmd/fix/httpserver.go[httpserverFix^],
+dan
+https://go.googlesource.com/go/+/go1/src/cmd/fix/reflect.go[reflectFix^]
+memberikan contoh-contoh yang berguna.
+
+Tentu saja, kami menulis kode Go juga, dan kode kami dipengaruhi oleh
+perubahan API tersebut seperti halnya Anda.
+Biasanya, kami menulis dukungan gofix bersamaan dengan perubahan API dan
+kemudian menggunakan gofix untuk menulis ulang kode dalam sumber kode utama.
+Kami menggunakan gofix untuk memperbarui basis kode Go lain dan proyek-proyek
+pribadi.
+Kami bahkan menggunakan gofix untuk memperbarui sumber kode internal pada
+Google saat waktunya membangun dengan rilis Go yang baru.
+
+Sebagai contohnya, gofix dapat menulis ulang kode seperti
+http://codereview.appspot.com/4353043/diff/10001/src/pkg/fmt/print.go#newcode657[potongan
+kode dari "fmt/print.go"^]:
+
+----
+switch f := value.(type) {
+case *reflect.BoolValue:
+	p.fmtBool(f.Get(), verb, field)
+case *reflect.IntValue:
+	p.fmtInt64(f.Get(), verb, field)
+	// ...
+case reflect.ArrayOrSliceValue:
+	// Byte slices are special.
+	if f.Type().(reflect.ArrayOrSliceType).Elem().Kind() == reflect.Uint8 {
+		// ...
+	}
+	// ...
+}
+----
+
+untuk mengadopsi API "reflect" yang baru:
+
+----
+switch f := value; f.Kind() {
+case reflect.Bool:
+	p.fmtBool(f.Bool(), verb, field)
+case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64:
+	p.fmtInt64(f.Int(), verb, field)
+	// ...
+case reflect.Array, reflect.Slice:
+	// Byte slices are special.
+	if f.Type().Elem().Kind() == reflect.Uint8 {
+		// ...
+	}
+	// ...
+}
+----
+
+Hampir semua baris di atas berubah dengan cara yang berbeda.
+Perubahan yang baru sangat banyak namun hampir semuanya bersifat mekanis,
+bentuk perubahan yang sangat baik ditangani oleh komputer.
+
+Gofix memungkinkan karena Go memiliki pustaka standar untuk
+https://golang.org/pkg/go/parser[mengurai berkas sumber Go menjadi pohon
+sintaksis^]
+dan juga untuk
+https://golang.org/pkg/go/printer[menulis pohon sintaksis tersebut kembali
+menjadi sumber kode Go^].
+Yang paling penting, pustaka penulisan Go menulis kode dalam format resmi
+(yang biasanya dilakukan perkakas gofmt), membolehkan gofix untuk membuat
+perubahan bersifat mekanis terhadap Go program tanpa menyebabkan perubahan
+format yang beragam.
+Faktanya, salah satu motivasi dari membuat perkakas gofmt -- selain
+menghindari debat tentang posisi kurung buka -- yaitu untuk menyederhanakan
+pembuatan perkakas yang menulis program Go, seperti yang gofix lakukan.
+
+Gofix menjadi tidak tergantikan.
+Khususnya, perubahan terbaru pada "reflect" akan sangat tidak menyenangkan
+bila tidak ada konversi otomatis.
+Gofix memberikan kami kemampuan untuk memperbaiki kesalahan atau sepenuhnya
+menulis ulang kembali API pada paket tanpa perlu khawatir dengan biaya (waktu
+dan tenaga) mengonversi kode yang sudah ada.
+Kami berharap gofix berguna dan cocok bagi Anda.