🖼️ 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.rspada 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:
2. Inisialisasi Otomatis (Magic Scaffolding)
Cukup jalankan build pada proyek Anda, dan rustbasic-webp akan secara otomatis membuat dan mendaftarkan helper yang diperlukan:
Perintah ini akan secara otomatis membuat:
- 📂 Helpers file:
src/app/helpers/webp.rsberisi fungsi wrapper konversi file & memori. - 🔗 Module Registry: Mendaftarkan
pub mod helpers;disrc/app/mod.rsdanpub mod webp;disrc/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:
use cratewebp;
use Multipart;
use fs;
pub async
4. Penggunaan Fungsi Memori & File Langsung
use cratewebp;
// Contoh 1: Konversi file lokal JPEG ke WebP
convert_file_to_webp?;
// Contoh 2: Konversi buffer gambar biner mentah
let original_bytes: = load_image_bytes;
let webp_bytes = to_webp?;
📄 Lisensi
Package ini dirilis di bawah lisensi MIT. Anda bebas memodifikasi dan mendistribusikannya untuk kebutuhan komersial maupun sumber terbuka.