rustbasic-webp 0.0.1

High-performance WebP image conversion and optimization package for the RustBasic Framework.
Documentation
# 🖼️ 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 **Axum** 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.
- **Axum Integration Ready**: Siap digunakan langsung di Controller untuk memproses file upload multi-part secara asinkron.

---

## 🚀 Panduan Instalasi & Penggunaan Lengkap

### 1. Instalasi
Tambahkan `rustbasic-webp` ke dalam berkas `Cargo.toml` pada proyek aplikasi Anda:

```toml
cargo add rustbasic-webp
```

---

### 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 Unggah Gambar)

Di bawah ini adalah contoh bagaimana menerima unggahan berkas JPEG/PNG dari klien, mengonversinya menjadi WebP dengan kualitas 80% (sekaligus memperkecil lebar maksimal ke 1200px), lalu menyimpannya:

```rust
use crate::app::helpers::webp;
use rustbasic_core::axum::extract::Multipart;
use std::fs;

pub async fn upload_avatar(mut multipart: Multipart) -> Result<String, String> {
    while let Some(field) = multipart.next_field().await.map_err(|e| e.to_string())? {
        let name = field.name().unwrap_or("").to_string();
        
        if name == "avatar" {
            let data = field.bytes().await.map_err(|e| e.to_string())?;
            
            // Konversi gambar langsung ke WebP dengan kualitas 80% & lebar maks 800px
            let webp_data = webp::to_webp_resized(&data, 800, 800, 80.0)
                .map_err(|e| format!("Gagal memproses gambar: {}", e))?;
            
            // Simpan gambar WebP yang telah dioptimalkan
            let file_name = format!("public/uploads/avatar_{}.webp", chrono::Local::now().timestamp());
            fs::write(&file_name, webp_data).map_err(|e| e.to_string())?;
            
            return Ok(format!("Avatar berhasil disimpan sebagai WebP: {}", file_name));
        }
    }
    Err("File tidak ditemukan".to_string())
}
```

---

### 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.