AR-Shipdesign/arshipdesign/utils/validation.py

"""
Utilidades de validación de datos de entrada.
"""

from __future__ import annotations


def is_positive(value: float, name: str = "valor") -> float:
    """Valida que un valor sea positivo. Lanza ValueError si no."""
    if value <= 0:
        raise ValueError(f"{name} debe ser positivo, se recibió {value}")
    return value


def is_in_range(value: float, low: float, high: float, name: str = "valor") -> float:
    """Valida que un valor esté en el rango [low, high]."""
    if not (low <= value <= high):
        raise ValueError(f"{name} debe estar entre {low} y {high}, se recibió {value}")
    return value