🧳 booking_kit

A powerful and extensible booking toolkit for Rust — featuring core data structures, flexible status logic, and seamless integration into any reservation system.

booking_kit is a generic and extensible toolkit designed to handle the core logic for booking systems in Rust.
This crate provides structures, status management, and error handling that are essential for creating a reservation or booking system.

A modular and extensible toolkit for building custom booking logic.

Designed to be flexible and reusable across various applications—such as travel, hotels, events, or any system requiring reservations— without relying on specific external services.

🚀 Features

• 📦 Core Data Structures — Defines Booking, BookingItem, and BookingStatus for handling bookings and items.
• 🔄 Status Management — Offers predefined booking statuses such as Pending, Confirmed, Canceled, and more.
• ⚠️ Error Handling — Provides a set of errors like ItemUnavailable, QuantityExceeded, and InvalidStatus to handle common booking-related issues.
• 🛠️ Metadata Support — Customize your bookings with additional metadata for each item.

🧰 Core Components

• BookingManager — Handles your booking lifecycle—create, confirm, cancel, or expire your bookings.
• Booking — A flexible struct to hold booking details, like ID, status, and the item you're booking.
• BookingStatus — A friendly enum to manage all the possible states your booking can be in.
• Error Types — Robust error handling for any booking mishaps.

💡 Quick Start

use serde::{Deserialize, Serialize};
use booking_kit::manager::BookingManager;
use booking_kit::traits::Bookable;

#[derive(Debug, Deserialize, Serialize)]
struct Room { id: &'static str }
impl Bookable for Room {
    fn id(&self) -> &str { self.id }
    fn is_available(&self) -> bool { true }
}

#[derive(Debug, Deserialize, Serialize)]
struct HotelRoom { id: &'static str, occupied: bool }
impl Bookable for HotelRoom {
    fn id(&self) -> &str { self.id }
    fn is_available(&self) -> bool { !self.occupied }
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let available_room = Room { id: "R101" };
    let booking = BookingManager::create(
        "booking-001", None, available_room, "now", None, None::<()>
    );
    
    let json = serde_json::to_string_pretty(&booking)?;
    println!("Booking : \n{}\n", json);
    println!("Booking created for: {}", booking.item_id());

    let occupied_room = HotelRoom { id: "R404", occupied: true };
    match BookingManager::try_create(
        "booking-002", Some("user-456"), occupied_room, "now", None, None::<()>
    ) {
        Ok(bk) => println!("Booking successful.{:?}", bk),
        Err(e) => println!("Booking failed: {}", e),
    }
    
    Ok(())
}

📄 License

Licensed under the Apache-2.0 license

👨 Author

Jerry Maheswara jerrymaheswara@gmail.com

❤️ Built with Love in Rust

This project is built with ❤️ using Rust — a systems programming language that is safe, fast, and concurrent.
Rust is the perfect choice for building reliable and efficient applications.

🤝 Contributing

Pull requests, issues, and feedback are welcome!
If you find this crate useful, give it a ⭐ and share it with others in the Rustacean community.