Skip to content

🔮 Modul 20 — Pakem Tinker (Interactive CLI REPL Shell) ​

"Look like Laravel, Run at Rust Speed. Menghadirkan konsol interaktif paling intuitif untuk berinteraksi langsung dengan aplikasi, database, dan service Pakem tanpa membuat route pengujian sementara."

Selamat datang di Modul 20 Dokumentasi Resmi Pakem Framework! Pada modul ini, kita akan mempelajari serba-serbi Pakem Tinker, alat bantu produktivitas berbasis REPL (Read-Eval-Print Loop) yang terinspirasi oleh php artisan tinker Laravel, namun dibangun dengan kekuatan native Rust.


🌟 1. Mengapa Pakem Tinker? ​

Dalam siklus pengembangan backend, developer sering kali perlu:

  • Memeriksa record di database secara cepat.
  • Menguji kalkulasi bisnis atau enkripsi password.
  • Menghasilkan slug URL atau UUID.
  • Menguji query Eloquent sebelum menuliskannya di Controller.

Alih-alih membuat route sementara di routes/web.rs lalu membuka browser, Anda cukup membuka terminal dan mengetik:

bash
canting tinker

🚀 2. Memulai Sesi Pakem Tinker ​

Pastikan file konfigurasi .env proyek Anda telah memiliki variabel DATABASE_URL aktif, lalu jalankan:

bash
canting tinker

Anda akan disambut oleh banner interaktif:

text
=========================================================
   ⚡ Pakem Framework — Interactive Tinker Shell (REPL)   
=========================================================
📦 [Database] Terhubung ke basis data: PostgreSQL
Ketik 'help' untuk daftar perintah, 'exit' atau Ctrl+D untuk keluar.

pakem >

🗄️ 3. Query Model Eloquent ​

Pakem Tinker memahami sintaksis model Pakem secara otomatis:

A. Mengambil Semua Record (Model::all()) ​

rust
pakem > User::all()

Menghasilkan tabel ANSI Box-Drawing yang rapi:

text
┌────┬──────────────┬──────────────────┬────────┐
│ id │ name         │ email            │ role   │
├────┼──────────────┼──────────────────┼────────┤
│  1 │ Budi Santoso │ budi@example.com │ admin  │
│  2 │ Siti Rahma   │ siti@example.com │ user   │
└────┴──────────────┴──────────────────┴────────┘
⚡ Executed in 0.42ms (2 rows)

B. Mencari Record Berdasarkan ID (Model::find(id)) ​

rust
pakem > User::find(1)

C. Menghitung Total Record (Model::count()) ​

rust
pakem > Article::count()
=> 42
⚡ Executed in 0.28ms (1 row)

⚡ 4. Fluent Query Builder (DB::table) ​

Selain model, Anda dapat menggunakan Query Builder dinamis:

rust
// Ambil seluruh data tabel
pakem > DB::table("orders").get()

// Batasi jumlah baris
pakem > DB::table("audit_logs").limit(5).get()

// Hitung baris tabel tertentu
pakem > DB::table("contacts").count()

🛠️ 5. Menjalankan Raw SQL Langsung ​

Jika Anda ingin menjalankan query analitik kompleks atau DDL, Anda bisa mengetik SQL secara langsung:

sql
pakem > SELECT role, count(*) as total FROM users GROUP BY role;
┌───────┬───────┐
│ role  │ total │
├───────┼───────┤
│ admin │ 2     │
│ user  │ 18    │
└───────┴───────┘
⚡ Executed in 0.35ms (2 rows)

Perintah INSERT, UPDATE, atau DELETE juga didukung dengan pelaporan baris terpengaruh (rows affected):

sql
pakem > UPDATE users SET role = 'editor' WHERE id = 2;
=> Query OK, 1 row affected
⚡ Executed in 0.62ms

🔐 6. Helper & Security Facades ​

Pakem Tinker menyertakan shortcut evaluator untuk fungsi-fungsi utilitas:

A. Bcrypt Password Hashing (Hash::make & Hash::check) ​

rust
pakem > Hash::make("secret123")
=> "$2b$10$wKk3j4N...qA"
⚡ Executed in 72.10ms

pakem > Hash::check("secret123", "$2b$10$wKk3j4N...qA")
=> true
⚡ Executed in 71.85ms

B. SEO AutoSlug Generator (AutoSlug::slugify) ​

rust
pakem > AutoSlug::slugify("Tutorial Rust: Keren & Cepat Tahun 2026!")
=> "tutorial-rust-keren-cepat-tahun-2026"
⚡ Executed in 0.05ms

C. UUID Generator (Uuid::new()) ​

rust
pakem > Uuid::new()
=> "550e8400-e29b-41d4-a716-446655440000"
⚡ Executed in 0.02ms

🔍 7. Framework Introspection Shortcuts ​

PerintahDeskripsi
tables / modelsMenampilkan seluruh tabel di database beserta model yang terinferensi.
envMenampilkan variabel lingkungan .env dengan masking sensor pada password/key.
helpMenampilkan ringkasan seluruh perintah bawaan Tinker.
clearMembersihkan layar terminal.
exit / quit / Ctrl+DKeluar dari sesi Pakem Tinker.

💡 8. Produktivitas Terminal ​

  • Riwayat Perintah (Persistent History): Tekan panah Atas/Bawah (↑/↓) untuk memanggil kembali perintah-perintah sebelumnya. Riwayat disimpan secara otomatis di file .pakem_tinker_history.
  • Zero Configuration: Bekerja otomatis dengan SQLite, PostgreSQL, MySQL, dan SQL Server.

Dirilis di bawah Lisensi MIT. Look like Laravel, Run at Rust Speed.