diff options
Diffstat (limited to '_content')
| -rw-r--r-- | _content/doc/index.adoc | 9 | ||||
| -rw-r--r-- | _content/doc/tutorial/workspaces/index.adoc | 333 |
2 files changed, 342 insertions, 0 deletions
diff --git a/_content/doc/index.adoc b/_content/doc/index.adoc index 8064bc6..86e68cd 100644 --- a/_content/doc/index.adoc +++ b/_content/doc/index.adoc @@ -1,4 +1,6 @@ = Dokumentasi +:toc: +:sectanchors: Bahasa pemrograman Go adalah proyek _open source_ untuk menjadikan pemrograman lebih produktif. @@ -32,6 +34,13 @@ Mempelajari secara singkat tentang kode, perkakas, paket, dan modul pada Go. Sebuah tutorial tentang topik-topik singkat yang memperkenalkan fungsi, penanganan eror, array, map, unit tes, dan mengompilasi. +[#workspaces] +=== link:/doc/tutorial/workspaces/[Tutorial: Bekerja dengan banyak modul^] + +Pengenalan tentang konsep dasar membuat dan menggunakan ruang kerja +(_workspace_) dengan banyak modul. +_Workspace_ berguna untuk melakukan perubahan di antara beberapa modul. + [#writing-web-applications] === link:/doc/articles/wiki[Menulis aplikasi web^] diff --git a/_content/doc/tutorial/workspaces/index.adoc b/_content/doc/tutorial/workspaces/index.adoc new file mode 100644 index 0000000..ce6bed4 --- /dev/null +++ b/_content/doc/tutorial/workspaces/index.adoc @@ -0,0 +1,333 @@ += Tutorial: Bekerja dengan banyak modul +:toc: +:sectanchors: + +Tutorial ini memperkenalkan konsep dasar _workspace_. +Dengan _workspace_, kita dapat memberitahu perintah Go bahwa kita sedang +menulis kode untuk beberapa modul secara bersamaan dan dengan mudah membangun +dan menjalankan kode dalam modul-modul tersebut. + +Dalam tutorial ini kita akan membuat dua buah modul dalam sebuah _workspace_, +melakukan perubahan pada satu modul, dan menggunakan perubahan tersebut dalam +modul lainnya. + +NOTE: Untuk tutorial lainnya, lihat +link:/doc/tutorial/index.html[Daftar tutorial^]. + + +== Kebutuhan awal + +* Go 1.18 (atau terbaru) yang telah terpasang. + Untuk mendapatkan versi Go yang terbaru silakan unduh di + https://go.dev/dl[go.dev/dl^]. +* Sebuah alat untuk menyunting kode. +* Sebuah terminal. + Go bekerja dengan baik di terminal mana pun di Linux dan Mac, bahkan + PowerShell atau cmd pada Windows. + + +[#create_folder] +== Buat sebuah modul untuk kode Anda + +Untuk memulai, buatlah sebuah modul untuk kode yang akan kita tulis nanti. + +. Bukalah terminal dan pindah ke direktori pengguna Anda, ++ +-- +Pada Linux or Mac: + +---- +$ cd +---- + +Pada Windows: + +---- +C:\> cd %HOMEPATH% +---- + +Perintah selanjutnya pada tutorial ini akan menggunakan `$` sebagai tanda +eksekusi pada terminal. +Perintah yang anda eksekusi juga akan berjalan di Windows. +-- + +. Dari terminal, buatlah sebuah direktori untuk kode Anda bernama workspace, ++ +-- +---- +$ mkdir workspace +$ cd workspace +---- +-- + +. Inisiasi modul ++ +-- +Dalam contoh ini kita buat sebuah modul baru `hello` yang bergantung pada +modul golang.org/x/example. + +Buatlah modul hello: + +---- +$ mkdir hello +$ cd hello +$ go mod init example.com/hello +go: creating new go.mod: module example.com/hello +---- + +Tambahkan dependensi golang.org/x/example dengan menggunakan `go get`, + +---- +$ go get golang.org/x/example +---- + +Buat hello.go dalam direktori hello dengan isi sebagai berikut: + +---- +package main + +import ( + "fmt" + + "golang.org/x/example/stringutil" +) + +func main() { + fmt.Println(stringutil.Reverse("Hello")) +} +---- + +Kemudian jalankan program `hello`: + +---- +$ go run example.com/hello +olleH +---- +-- + +[#create-the-workspace] +== Buat _workspace_ + +Pada langkan ini, kita akan membuat berkas `go.work` untuk menentukan ruang +kerja untuk modul. + +[#initialize-the-workspace] +=== Inisiasi _workspace_ + +Dalam direktori `workspace`, jalankan: + +---- +$ go work init ./hello +---- + +Perintah `go work init` memberitahu `go` untuk membuat berkas `go.work` untuk +ruang kerja yang berisi modul `hello`. + +Bentuk isi dari berkas `go.work` sebagai berikut: + +---- +go 1.18 + +use ./hello +---- + +Berkas `go.work` memiliki sintaks yang mirip dengan `go.mod`. + +Baris direktif `go` memberitahu perkakas go versi yang akan digunakan oleh +_workspace_. +Mirip dengan direktif `go` pada berkas `go.mod`. + +Direktif `use` memberitahu perkakas Go bahwa modul pada direktori `hello` +adalah modul utama saat melakukan pembangunan. + +Jadi, setiap sub-direktori dalam `workspace`, akan dianggap sebagai modul yang +aktif. + +=== Jalankan program dari direktori _workspace_ + +Dalam direktori `workspace`, jalankan: + +---- +$ go run example.com/hello +olleH +---- + +Perintah `go run` mengikutkan semua modul dalam _workspace_ sebagai modul +utama. +Hal ini membolehkan kita mengacu paket dalam modul, bahkan di luar modul. +Menjalankan perintah `go run`, di luar modul atau _workspace_ akan +mengakibatkan eror karena perintah `go` tidak tahu modul mana yang akan +digunakan. + +Selanjutnya, kita akan menambahkan salinan dari modul `golang.org/x/example` +ke dalam _workspace_. +Kemudian kita akan tambahkan fungsi baru ke dalam paket `stringutil` yang +dapat kita gunakan selain `Reverse`. + + +[#download-and-modify-the-golangorgxexample-module] +== Unduh dan ubah modul `golang.org/x/example` + +Pada langkah ini, kita akan mengunduh salinan dari modul +`golang.org/x/example`, menambahkan-nya ke dalam _workspace_, dan kemudian +menambahkan fungsi baru yang digunakan oleh program hello nantinya. + + +. Salin repositori ++ +-- +Dari dalam direktori _workspace_, jalankan perintah `git` untuk menyalin +repositori: + +---- +$ git clone https://go.googlesource.com/example +Cloning into 'example'... +remote: Total 165 (delta 27), reused 165 (delta 27) +Receiving objects: 100% (165/165), 434.18 KiB | 1022.00 KiB/s, done. +Resolving deltas: 100% (27/27), done. +---- +-- + +. Tambahkan modul tersebut ke _workspace_ ++ +-- +---- +$ go work use ./example +---- + +Perintah `go work use` menambahkan modul baru ke dalam berkas go.work. +Berkas tersebut akan berisi, + +---- +go 1.18 + +use ( + ./hello + ./example +) +---- + +Ruang kerja (_workspace_) sekarang berisi modul `example.com/hello` dan modul +`golang.org/x/example`. + +Hal ini membolehkan kita menambahkan atau mengubah kode dalam modul +`golang.org/x/example` bukan lagi menggunakan versi yang di simpan dalam +tembolok yang kita unduh lewat perintah `go get`. +-- + +. Tambahkan fungsi baru. ++ +-- +Dalam langkah ini kita akan menambahkan fungsi baru ke dalam paket +`golang.org/x/example/stringutil`. + +Buat sebuah berkas baru `toupper.go` dalam direktori +`workspace/example/stringutil` yang berisi sebagai berikut: + +---- +package stringutil + +import "unicode" + +// ToUpper uppercases all the runes in its argument string. +func ToUpper(s string) string { + r := []rune(s) + for i := range r { + r[i] = unicode.ToUpper(r[i]) + } + return string(r) +} +---- +-- + +. Ubah program hello supaya menggunakan fungsi tersebut. ++ +-- +Ubah isi dari `workspace/hello/hello.go` supaya berisi sebagai berikut: + +---- +package main + +import ( + "fmt" + + "golang.org/x/example/stringutil" +) + +func main() { + fmt.Println(stringutil.ToUpper("Hello")) +} +---- +-- + +=== Jalankan kembali kode dalam _workspace_ + +Dari dalam direktori _workspace_, jalankan, + +---- +$ go run example.com/hello +HELLO +---- + +Perintah Go menemukan modul `example.com/hello` di dalam direktori `hello` +yang ditentukan oleh berkas `go.work`, dan dengan cara yang sama menemukan +impor `golang.org/x/example` lewat berkas `go.work`. + +Berkas `go.work` dapat digunakan sebagai pengganti direktif +link:/ref/mod#go-mod-file-replace[`replace`^] +untuk bekerja dengan banyak modul. + +Secara dua modul tersebut berada dalam ruang kerja yang sama, akan mudah untuk +membuat perubahan pada satu modul dan menggunakan-nya di modul yang lain. + +=== Langkah selanjutnya + +Sekarang, untuk merilis modul `hello` kita harus merilis module +`golang.org/x/example` terlebih dahulu, misalnya `v0.1.0`. +Hal ini biasanya dilakukan dengan membuat tag pada komit tertentu pada +modul repositori. +Lihat +link:/doc/modules/release-workflow/[dokumentasi alur kerja rilis modul^]. +Saat modul telah dirilis, kita dapat meningkatkan versi yang dibutuhkan pada +dalam `hello/go.mod`: + +---- +cd hello +go get golang.org/x/example@v0.1.0 +---- + +Dengan cara ini, perintah `go` dapat menggunakan versi terbaru, yang telah +diubah, dari `golang.org/x/example` di luar _workspace_. + + +[#learn-more-about-workspaces] +== Pelajari lebih lanjut tentang _workspace_ + +Perintah `go` memiliki beberapa sub-perintah untuk _workspace_ selain `go work +init`: + +* `go work use [-r] [dir]`. ++ +-- +Tambahkan direktif `use` ke dalam berkas `go.work` untuk direktori `dir` jika +ia ada, atau hapus direktif `use` jika direktori tersebut tidak ada. +Opsi `-r` memeriksa sub-direktori dari `dir` secara rekursif. +-- + +* `go work edit` ++ +-- +Sunting berkas `go.work`, mirip dengan `go mod edit`. +-- + +* `go work sync` ++ +-- +Sinkronisasi dependensi dari daftar modul dalam _workspace_ ke dalam setiap +modul dalam _workspace_. +-- + +Lihat +link:/ref/mod#workspaces[Workspace^] +dalam Referensi Go Modul untuk lebih rinci tentang ruang kerja dan berkas +`go.work`. |