Indocommit adalah Command-Line Interface (CLI) yang dirancang untuk menerjemahkan pesan commit berbahasa Indonesia ke dalam format standar English Conventional Commits secara instan.

Arsitektur dan Alur Kerja

Proyek ini dibangun secara kokoh menggunakan TypeScript dan Node.js. Struktur kode dirancang secara modular untuk memastikan kemudahan pemeliharaan dan skalabilitas pengembangan.

Modul Utama

• CLI Entry (index.ts): Menggunakan commander.js untuk mengurai argumen terminal, flag operasional, serta integrasi modul.
• Interactive (interactive.ts): Menggunakan @inquirer/prompts untuk wizard interaktif pembuatan commit message.
• Git Integration (git.ts): Penanganan integrasi Git hook (prepare-commit-msg) dan eksekusi langsung git commit.
• Clipboard (clipboard.ts): Penyalinan otomatis hasil konversi ke clipboard sistem.
• Config Loader (config.ts): Memuat konfigurasi kustom .indocommitrc.json dari direktori lokal.
• Detector (detector.ts): Memindai pesan input untuk mengidentifikasi tipe commit dan scope.
• Translator (translator.ts): Memproses penerjemahan kata demi kata ke bahasa Inggris.

Persyaratan Sistem

• Node.js (Versi 18 atau lebih baru)
• npm (Node Package Manager)

Panduan Instalasi

Setup Pengembangan Lokal

1. Kloning repositori ini ke dalam direktori lokal Anda:

   git clone https://github.com/fa33az/indocommit.git
   cd indocommit

2. Unduh dan instal seluruh dependensi yang dibutuhkan:

   npm install

3. Jalankan proses kompilasi (build) kode sumber TypeScript:

   npm run build

4. Tautkan modul secara global ke dalam environment sistem Anda:

   npm link

Instalasi Global NPM

npm install -g indocommit

Panduan Penggunaan & Fitur

1. Penggunaan Dasar

Berikan pesan commit Bahasa Indonesia sebagai argumen:

indocommit "benerin bug login"

Output: fix(auth): fix bug login

2. Mode Interaktif (-i / --interactive)

Jalankan indocommit tanpa argumen atau gunakan flag -i untuk wizard interaktif:

indocommit -i

3. Salin ke Clipboard (-c / --copy)

Otomatis menyalin hasil penerjemahan ke clipboard:

indocommit "tambah fitur api" -c

4. Eksekusi Git Commit Langsung (-g / --commit)

Otomatis menjalankan git commit -m "<hasil_terjemahan>":

indocommit "benerin bug database" -g

5. Integrasi Git Hook (--init-hook)

Pasang otomatis di repositori lokal Anda agar pesan commit Bahasa Indonesia dikonversi otomatis saat melakukan git commit:

indocommit --init-hook

6. Konfigurasi Kustom (.indocommitrc.json)

Buat berkas .indocommitrc.json pada root proyek Anda untuk menambahkan kata kunci kustom:

{
  "typeKeywords": {
    "perbaiki": "fix",
    "rilis": "release"
  },
  "scopeKeywords": {
    "pembayaran": "payment"
  },
  "wordTranslations": {
    "pembayaran": "payment",
    "gagal": "failed"
  }
}

Lisensi dan Penulis

• Penulis: fa33az
• Lisensi: Proyek sumber terbuka ini didistribusikan di bawah Lisensi MIT. Silakan tinjau berkas LICENSE untuk informasi lebih detail.