Best Practices untuk Organisasi Direktori Proyek Go di Github / BitBucket / Assembla / etc

Saat sudah membuat proyek pengembangan software menggunakan Go dan akan dipublikasikan ke server penyedia repository Git (seperti github.com, bitbucket.org, atau assembla.com), kita harus menentukan struktur direktori yang baik dari proyek kita. Berdasarkan panduan dari How to Write Go Code (http://golang.org/doc/code.html), tiap proyek kita bagi menjadi beberapa direktori:

1. src: berisi source code
2. pkg: berisi paket object code yang telah dikompilasi (pustaka)
3. bin: binary executable

Jika untuk diri sendiri, barangkali ini sudah selesai. Jika proyek akan kita publikasikan ke git repo, struktur akan sangat berpengaruh. Initialisasi git seharusnya tidak dilakukan di $GOPATH, tetapi di src/. Perhatikan, pada contoh berikut ini $GOPATH adalah root directory dari proyek tempat file test.go berada:

Saya sudah mempunyai account github, dan root directory saya di github adalah http://github.com/bpdp, dengan demikian, saat membuat proyek, misalnya namanya adalah goarangodb, maka proyek tersebut akan berada di http://github.com/bpdp/goarangodb. Untuk kasus seperti ini, source code dari proyek kita sebaiknya diletakkan di $GOPATH/src/github.com/bpdp/goarangodb, sekaligus goarangodb menjadi nama paket. Inisialisasi git dilakukan di direktori $GOPATH/src/github.com/bpdp/goarangodb.

Mengapa harus demikian? Pada saat melakukan go get http://github.com/bpdp/goarangodb, artiffak dari proyek tersebut (source code, README, dll) akan diletakkan di direktori $GOPATH/src/github.com/bpdp/goarangodb. Dengan demikian, kita sebagai pengembang akan mempunyai situasi yang sama dengan deevloper yang meng - go get proyek kita.

Read More [...]

Posted in Git, GitHub, Go

Git dan Github: Petunjuk Awal

Mengambil dari repo

• git clone [lokasi]

Contoh:

• git clone https://github.com/bpdp/buku-cloud-nodejs.git (jika menggunakan https)
• git clone git://github.com/bpdp/buku-cloud-nodejs.git (jika menggunakan git)

Membuat repo baru di lokal

• Buat direktori baru
• Masuk ke direktori baru tersebut
• Menambahkan semua file:

• git add -A

• Commit:
• git commit -m "First commit - initializing empty repo"

Melihat status repo lokal

• git status

File baru di repo

• Menambahkan file
• git add [file]
• Commit:
• git commit -m "Menambahkan file untuk ..."
• push ke github

Mengedit file

• Edit file
• Commit:
• git commit -m "Pesan"
• push ke github

Push ke github

• Menetapkan repo:
• git remote add origin
• contoh: git remote add origin https://github.com/bpdp/buku-cloud-nodejs.git
• Push:
• git push origin master

Read More [...]

Posted in Git, GitHub