🚀 RustBasic Core

📝 Kata Pengantar

Selamat datang di RustBasic Core. Crate ini adalah mesin inti (core engine) berkinerja tinggi yang menggerakkan seluruh ekosistem RustBasic Framework. Dirancang dengan arsitektur modular yang tangguh, rustbasic-core menyatukan kekuatan web server Hyper, SQL asinkron kustom, mesin template terintegrasi, serta layanan keamanan terintegrasi seperti proteksi CSRF otomatis, sesi terenkripsi, tracing logger harian, dan pengiriman email SMTP. Core engine ini memberikan fondasi yang sangat stabil, efisien, dan aman untuk membangun aplikasi web modern berskala besar.

⚡ Sistem Fitur Opsional (Compile-Time Features)

rustbasic-core menggunakan sistem Cargo features untuk menjaga jumlah dependensi seminimal mungkin. Hanya fitur yang benar-benar dibutuhkan yang akan dikompilasi.

Tabel Fitur

Catatan: Secara default, hanya sqlite yang aktif (~63 crates total). Ini membuat waktu kompilasi jauh lebih singkat dibanding mengaktifkan semua fitur sekaligus (>297 crates).

Cara Mengaktifkan Fitur

# Cargo.toml project Anda

# Hanya SQLite (default - paling ringan)
rustbasic-core = { version = "0.1" }

# SQLite + MySQL
rustbasic-core = { version = "0.1", features = ["mysql"] }

# SQLite + MySQL + Email
rustbasic-core = { version = "0.1", features = ["mysql", "mail"] }

# SQLite + MySQL + Email + HTTP Client
rustbasic-core = { version = "0.1", features = ["mysql", "mail", "http-client"] }

# SQLite bundled (tanpa instalasi libsqlite3 di sistem)
rustbasic-core = { version = "0.1", features = ["sqlite-bundled"] }

⚠️ Jika DB_CONNECTION=mysql di file .env, wajib aktifkan feature mysql, atau server akan panic saat startup.

🛠️ Contoh Penggunaan

A. Penambahan Dependensi ke Proyek Rust (Cargo.toml)

[dependencies]
# Pilih sesuai kebutuhan database Anda:

# Untuk SQLite:
rustbasic-core = "0.1"

# Untuk MySQL:
rustbasic-core = { version = "0.1", features = ["mysql"] }

B. Memuat Konfigurasi & Menjalankan Server Utama (src/main.rs)

use rustbasic_core::{Config, server, database, Router};

#[tokio::main]
async fn main() {
    // 1. Memuat konfigurasi environment (.env)
    let cfg = Config::load();

    // 2. Membuka koneksi database relasional asinkron
    let db = database::connect(&cfg).await;

    // 3. Mendefinisikan router web aplikasi
    let app_router = Router::new();

    // 4. Menjalankan server web RustBasic (mendengarkan port konfigurasi)
    server::start_server(cfg, session_store, static_files, db, app_router).await;
}

C. Proteksi CSRF Otomatis & Sesi dalam Handler

use rustbasic_core::{Request, Response, IntoResponse, serde_json::json};

pub async fn handler_transaksi(req: Request) -> impl IntoResponse {
    // Mengambil user ID yang tersimpan dengan aman di session terenkripsi backend
    let user_id: Option<i32> = req.session.get("user_id");
    
    match user_id {
        Some(id) => format!("Memproses transaksi untuk user ID: {}", id),
        None => "Akses Ditolak: Sesi Tidak Valid".to_string()
    }
}

D. Menggunakan HTTP Client (fitur opsional)

# Aktifkan dulu di Cargo.toml:
rustbasic-core = { version = "0.1", features = ["http-client"] }

use rustbasic_core::Http;

// Hanya tersedia jika feature "http-client" diaktifkan
let response = Http::get("https://api.example.com/data")
    .send()
    .await?;

E. Mengirim Email (fitur opsional)

# Aktifkan dulu di Cargo.toml:
rustbasic-core = { version = "0.1", features = ["mail"] }

use rustbasic_core::MailService;

// Hanya tersedia jika feature "mail" diaktifkan
MailService::send()
    .to("user@example.com")
    .subject("Selamat Datang!")
    .body("<h1>Terima kasih telah mendaftar.</h1>")
    .send()
    .await?;

🔄 Perbandingan Pemakaian (Standard Rust vs RustBasic Core)

📊 Tabel Ringkasan Fitur Inti RustBasic Core

🏁 Penutup

Dengan menyediakan pustaka utilitas yang terintegrasi erat dan sistem compile-time features yang fleksibel, RustBasic Core menyederhanakan kompleksitas pengembangan aplikasi web di Rust tanpa mengorbankan performa kecepatan dan keamanan. Pengembang dapat dengan mudah membangun aplikasi berskala produksi yang kokoh dengan waktu kompilasi yang sangat singkat.