hotelutils 0.1.0__py3-none-any.whl

hotelutils/__init__.py

@@ -0,0 +1,17 @@
+from .utils import (
+    generate_booking_reference,
+    calculate_dynamic_price,
+    calculate_loyalty_points,
+    calculate_cleaning_duration,
+    estimate_room_availability,
+    generate_invoice_number,
+)
+
+__all__ = [
+    "generate_booking_reference",
+    "calculate_dynamic_price",
+    "calculate_loyalty_points",
+    "calculate_cleaning_duration",
+    "estimate_room_availability",
+    "generate_invoice_number",
+]

hotelutils/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+class HotelUtilsConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'hotelutils'

hotelutils/utils.py

@@ -0,0 +1,111 @@
+import random
+import string
+from datetime import datetime, date
+
+def generate_booking_reference(guest_name: str, room_type: str) -> str:
+    """
+    Generates a unique booking reference.
+    Example: SH-SMI-DEL-8FA2
+    """
+    clean_name = "".join(c for c in guest_name if c.isalnum()).upper()
+    name_part = clean_name[:3] if len(clean_name) >= 3 else (clean_name + "XXX")[:3]
+    
+    clean_room = "".join(c for c in room_type if c.isalnum()).upper()
+    room_part = clean_room[:3] if len(clean_room) >= 3 else (clean_room + "XXX")[:3]
+    
+    rand_part = "".join(random.choices(string.ascii_uppercase + string.digits, k=4))
+    
+    return f"SH-{name_part}-{room_part}-{rand_part}"
+
+def calculate_dynamic_price(base_price: float, demand_factor: float, days_ahead: int) -> float:
+    """
+    Calculates dynamic price based on base price, demand factor (occupancy index 0.0 - 2.0),
+    and days ahead of check-in.
+    - Higher demand_factor increases price.
+    - Booking last-minute (days_ahead <= 3) increases price by up to 20% if demand is high.
+    - Booking far in advance (days_ahead > 30) offers up to a 10% discount.
+    """
+    # Clamp demand factor between 0.5 and 2.0
+    demand_factor = max(0.5, min(2.0, demand_factor))
+    
+    # Calculate days-ahead modifier
+    if days_ahead <= 3:
+        time_modifier = 1.2  # 20% premium for last-minute
+    elif days_ahead > 30:
+        time_modifier = 0.9  # 10% advance discount
+    else:
+        time_modifier = 1.0
+        
+    final_price = base_price * demand_factor * time_modifier
+    return round(final_price, 2)
+
+def calculate_loyalty_points(booking_total_usd: float, user_tier: str) -> int:
+    """
+    Calculates loyalty points based on booking cost and member tier.
+    Tiers: regular (1x), bronze (1.2x), silver (1.5x), gold (2.0x)
+    """
+    tier_multipliers = {
+        "regular": 1.0,
+        "bronze": 1.2,
+        "silver": 1.5,
+        "gold": 2.0
+    }
+    multiplier = tier_multipliers.get(user_tier.lower(), 1.0)
+    points = float(booking_total_usd) * multiplier
+    return int(points)
+
+def calculate_cleaning_duration(room_type: str, status: str) -> int:
+    """
+    Estimates cleaning duration in minutes.
+    Room types: suite (60 mins), deluxe (45 mins), standard (30 mins)
+    Multiplier based on dirty vs light cleaning status.
+    """
+    base_durations = {
+        "suite": 60,
+        "deluxe": 45,
+        "standard": 30
+    }
+    base = base_durations.get(room_type.lower(), 30)
+    
+    status_modifiers = {
+        "dirty": 1.2,     # Needs thorough clean
+        "cleaning": 1.0,
+        "ready": 0.5      # Just touch-up/inspection
+    }
+    modifier = status_modifiers.get(status.lower(), 1.0)
+    return int(base * modifier)
+
+def estimate_room_availability(target_range: tuple, existing_bookings: list) -> bool:
+    """
+    Checks if a target date range (start_date, end_date) overlaps with any existing booking ranges.
+    target_range: (date/datetime, date/datetime)
+    existing_bookings: list of (start, end) tuples
+    Returns True if available (no overlap), False otherwise.
+    """
+    target_start, target_end = target_range
+    # Normalize to date objects if they are datetime
+    if isinstance(target_start, datetime):
+        target_start = target_start.date()
+    if isinstance(target_end, datetime):
+        target_end = target_end.date()
+        
+    for start, end in existing_bookings:
+        if isinstance(start, datetime):
+            start = start.date()
+        if isinstance(end, datetime):
+            end = end.date()
+            
+        # Overlap condition: startA < endB and startB < endA
+        if target_start < end and start < target_end:
+            return False
+            
+    return True
+
+def generate_invoice_number(booking_id: int) -> str:
+    """
+    Generates a unique invoice number.
+    Format: INV-YYYYMMDD-ID-RANDOM
+    """
+    today_str = datetime.now().strftime("%Y%m%d")
+    rand_suffix = "".join(random.choices(string.ascii_uppercase + string.digits, k=3))
+    return f"INV-{today_str}-{booking_id}-{rand_suffix}"

hotelutils-0.1.0.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: hotelutils
+Version: 0.1.0
+Summary: Custom utility package for Smart Hospitality Management System
+Author: Meenakshi
+Author-email: admin@smarthospitality.com
+Requires-Python: >=3.9
+Dynamic: author
+Dynamic: author-email
+Dynamic: requires-python
+Dynamic: summary

hotelutils-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+hotelutils/__init__.py,sha256=HAJ_2YpHdwga_gl50kBSIVsztsfBCGemhSv0hR1EiMU,420
+hotelutils/apps.py,sha256=mby04dBg7py4F_Jyk-5qLBbeKPw36PqYaWtt-EhxSv8,151
+hotelutils/utils.py,sha256=YhxQkgkFFuuLWfsifO5a2Isvqi5CZ4kWbZ1TS1AgCLI,4063
+hotelutils-0.1.0.dist-info/METADATA,sha256=k5HqiRFnOweGFXwZ2Huqd8ac4LWXc0v_0HAIx0OMUTI,288
+hotelutils-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+hotelutils-0.1.0.dist-info/top_level.txt,sha256=TC_gs-6uJZnzwb8KE0NiZuntGrPo6NzX24SwQ7cpMhU,11
+hotelutils-0.1.0.dist-info/RECORD,,

hotelutils-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hotelutils-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+hotelutils