rustbasic-webp 0.0.3

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 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:

[dependencies]
rustbasic-webp = "0.0.2"

2. Inisialisasi Otomatis (Magic Scaffolding)

Cukup jalankan build pada proyek Anda, dan rustbasic-webp akan secara otomatis membuat dan mendaftarkan helper yang diperlukan:

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:

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

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.