app/routers/random_number_generator.py

import random
from fastapi import APIRouter

# Create a new APIRouter instance
# We'll set a prefix so all paths in this router start with /random
router = APIRouter(
    prefix="/random",
    tags=["Random Numbers"] # Optional: helps organize documentation (Swagger UI)
)

@router.get("/integer")
def get_random_integer(min_val: int = 1, max_val: int = 100):
    """
    Generate a random integer between min_val (inclusive) and max_val (inclusive).
    
    Defaults to a number between 1 and 100.
    """
    if min_val > max_val:
        # Swap if min is greater than max to ensure the range is valid
        min_val, max_val = max_val, min_val
        
    random_int = random.randint(min_val, max_val)
    
    return {
        "min_value": min_val,
        "max_value": max_val,
        "random_number": random_int
    }

@router.get("/float")
def get_random_float():
    """
    Generate a random floating-point number between 0.0 (inclusive) and 1.0 (exclusive).
    """
    random_float = random.random()
    return {"random_float": random_float}