Módulo PySAG.exceptions

Módulo que contiene excepciones personalizadas para PySAG.

Este módulo define excepciones específicas para manejar errores en algoritmos genéticos.

exception PySAG.exceptions.CrossoverError(message, details=None)

Bases: GeneticAlgorithmError

Se produce cuando hay un error en el operador de cruce.

Parámetros:

• message (str)

• details (Dict[str, Any] | None)

exception PySAG.exceptions.FitnessEvaluationError(message, details=None)

Bases: GeneticAlgorithmError

Se produce cuando hay un error en la evaluación de la función de aptitud.

Parámetros:

• message (str)

• details (Dict[str, Any] | None)

exception PySAG.exceptions.GeneticAlgorithmError(message, details=None)

Bases: PySAGError

Excepción base para errores en el algoritmo genético.

Parámetros:

• message (str)

• details (Dict[str, Any] | None)

exception PySAG.exceptions.InitializationError(message, details=None)

Bases: GeneticAlgorithmError

Se produce cuando hay un error en la inicialización de la población.

Parámetros:

• message (str)

• details (Dict[str, Any] | None)

exception PySAG.exceptions.MutationError(message, details=None)

Bases: GeneticAlgorithmError

Se produce cuando hay un error en el operador de mutación.

Parámetros:

• message (str)

• details (Dict[str, Any] | None)

exception PySAG.exceptions.ParameterError(message, details=None)

Bases: PySAGError

Se produce cuando hay un error en los parámetros de entrada.

Parámetros:

• message (str)

• details (Dict[str, Any] | None)

exception PySAG.exceptions.PySAGError(message, details=None)

Bases: Exception

Clase base para todas las excepciones de PySAG.

Parámetros:

• message (str) – Mensaje descriptivo del error.

• details (Dict[str, Any] | None) – Información adicional sobre el error.

__init__(message, details=None)

Inicializa la excepción con un mensaje y detalles opcionales.

Parámetros:

• message (str)

• details (Dict[str, Any] | None)

__str__()

Representación en cadena de la excepción.

Tipo del valor devuelto:

str

exception PySAG.exceptions.RangeError(param_name, param_value, min_val=None, max_val=None, inclusive=True, details=None)

Bases: ValidationError

Se produce cuando un valor está fuera del rango permitido.

Parámetros:

• param_name (str)

• param_value (int | float)

• min_val (int | float | None)

• max_val (int | float | None)

• inclusive (bool)

• details (str | None)

Tipo del valor devuelto:

None

__init__(param_name, param_value, min_val=None, max_val=None, inclusive=True, details=None)

Inicializa la excepción.

Parámetros:

• param_name (str) – Nombre del parámetro que falló la validación.

• param_value (int | float) – Valor que falló la validación.

• min_val (int | float | None) – Valor mínimo permitido (inclusive).

• max_val (int | float | None) – Valor máximo permitido (inclusive).

• inclusive (bool) – Si True, el rango es inclusivo.

• details (str | None) – Información adicional sobre el error.

Tipo del valor devuelto:

None

exception PySAG.exceptions.SelectionError(message, details=None)

Bases: GeneticAlgorithmError

Se produce cuando hay un error en la selección de individuos.

Parámetros:

• message (str)

• details (Dict[str, Any] | None)

exception PySAG.exceptions.TypeValidationError(param_name, param_value, expected_type)

Bases: ValidationError

Se produce cuando un valor tiene un tipo incorrecto.

Parámetros:

• param_name (str)

• param_value (Any)

• expected_type (Type | List[Any] | Any)

Tipo del valor devuelto:

None

__init__(param_name, param_value, expected_type)

Inicializa la excepción.

Parámetros:

• param_name (str) – Nombre del parámetro que falló la validación.

• param_value (Any) – Valor que falló la validación.

• expected_type (Type | List[Any] | Any) – Tipo esperado o lista de tipos esperados.

Tipo del valor devuelto:

None

exception PySAG.exceptions.ValidationError(param_name, param_value, expected, **kwargs)

Bases: PySAGError

Se produce cuando falla la validación de un valor o parámetro.

Parámetros:

• param_name (str) – Nombre del parámetro que falló la validación.

• param_value (Any) – Valor que falló la validación.

• expected (str) – Descripción del valor esperado.

• kwargs (Any)

Tipo del valor devuelto:

None

__init__(param_name, param_value, expected, **kwargs)

Inicializa la excepción.

Parámetros:

• param_name (str) – Nombre del parámetro que falló la validación.

• param_value (Any) – Valor que falló la validación.

• expected (str) – Descripción del valor esperado.

• kwargs (Any)

Tipo del valor devuelto:

None

PySAG.exceptions.validate_parameter(value, name, expected_type, min_val=None, max_val=None, inclusive=True)

Función de validación de parámetros.

Parámetros:

• value (T) – Valor a validar.

• name (str) – Nombre del parámetro.

• expected_type (Type | List[Any] | Any) – Tipo esperado o lista de tipos esperados.

• min_val (int | float | None) – Valor mínimo permitido (inclusive).

• max_val (int | float | None) – Valor máximo permitido (inclusive).

• inclusive (bool) – Si True, el rango es inclusivo.

Devuelve:

El valor validado.

Muestra:

• TypeValidationError – Si el valor no cumple con el tipo esperado.

• RangeError – Si el valor está fuera del rango permitido.

Tipo del valor devuelto:

T