# 🖼️ rustbasic-webp
Package **WebP Image Processing & Optimization** yang sangat elegan, cepat, dan terintegrasi penuh untuk framework **RustBasic**, mendukung kompresi kualitas tinggi dan *dynamic resizing* otomatis.
Dirancang khusus untuk ekosistem **RustBasic** dan aplikasi modern berbasis **React + Inertia SPA** maupun **MiniJinja MPA**, package ini memungkinkan Anda mengoptimalkan ukuran gambar yang diunggah pengguna menjadi format WebP berkinerja tinggi secara instan sebelum disimpan ke media penyimpanan.
---
## ✨ Fitur Premium
- **High-Performance WebP Encoding**: Ditenagai oleh encoder libwebp native (via safe Rust interface) dengan kualitas kompresi luar biasa.
- **Dynamic Resize with Aspect Ratio**: Mengubah ukuran gambar (resize) secara otomatis dengan tetap mempertahankan rasio aspek menggunakan Lanczos3 filter beresolusi tajam.
- **Zero-Config Scaffolding**: Cukup tambahkan dependensi, dan pustaka akan otomatis merakit modul `src/app/helpers/webp.rs` pada proyek Anda.
- **Integration Ready**: Siap digunakan langsung di Controller untuk memproses file upload atau byte gambar secara asinkron.
---
## 🚀 Panduan Instalasi & Penggunaan Lengkap
### 1. Instalasi
Tambahkan `rustbasic-webp` ke dalam berkas `Cargo.toml` pada proyek aplikasi Anda:
```toml
[dependencies]
rustbasic-webp = "0.0"
```
---
### 2. Inisialisasi Otomatis (Magic Scaffolding)
Cukup jalankan build pada proyek Anda, dan `rustbasic-webp` akan secara otomatis membuat dan mendaftarkan helper yang diperlukan:
```bash
cargo build
```
Perintah ini akan secara otomatis membuat:
- 📂 **Helpers file**: `src/app/helpers/webp.rs` berisi fungsi wrapper konversi file & memori.
- 🔗 **Module Registry**: Mendaftarkan `pub mod helpers;` di `src/app/mod.rs` dan `pub mod webp;` di `src/app/helpers/mod.rs`.
---
### 3. Penggunaan di Controller (Contoh Handler RustBasic)
Di bawah ini adalah contoh bagaimana menerima unggahan berkas gambar (dikodekan dalam Base64 atau byte biner), mengonversinya menjadi WebP dengan kualitas 80% (sekaligus memperkecil dimensi maksimal ke 800px), lalu menyimpannya:
```rust
use crate::app::helpers::webp;
use rustbasic_core::{Request, IntoResponse, ResponseHelper};
use std::fs;
pub async fn upload_avatar(req: Request) -> impl IntoResponse {
// Ambil data Base64 gambar dari input request
if let Some(base64_str) = req.input_as_str("avatar") {
// Dekode data Base64 ke bytes biner
// Catatan: Anda bisa menggunakan pustaka dekode base64 bawaan atau standar
if let Ok(data) = rustbasic_core::base64::decode(base64_str) {
// Konversi gambar langsung ke WebP dengan kualitas 80% & lebar/tinggi maks 800px
match webp::to_webp_resized(&data, 800, 800, 80.0) {
Ok(webp_data) => {
// Simpan gambar WebP yang telah dioptimalkan
let file_name = format!("storage/app/public/avatar_{}.webp", chrono::Local::now().timestamp());
if fs::write(&file_name, webp_data).is_ok() {
return ResponseHelper::success(&format!("Avatar berhasil disimpan: {}", file_name));
}
return ResponseHelper::error("Gagal menulis file gambar ke penyimpanan");
}
Err(e) => return ResponseHelper::error(&format!("Gagal memproses gambar: {}", e)),
}
}
}
ResponseHelper::error("File avatar tidak valid")
}
```
---
### 4. Penggunaan Fungsi Memori & File Langsung
```rust
use crate::app::helpers::webp;
// Contoh 1: Konversi file lokal JPEG ke WebP
webp::convert_file_to_webp("raw_photo.jpg", "optimized_photo.webp", 85.0)?;
// Contoh 2: Konversi buffer gambar biner mentah
let original_bytes: Vec<u8> = load_image_bytes();
let webp_bytes = webp::to_webp(&original_bytes, 90.0)?;
```
---
## 📄 Lisensi
Package ini dirilis di bawah lisensi **MIT**. Anda bebas memodifikasi dan mendistribusikannya untuk kebutuhan komersial maupun sumber terbuka.