Pitasoft.Error 5.0.1

Pitasoft.Error

English | Español

<a name="english"></a>

English

Pitasoft.Error is a class library designed to facilitate the handling and management of error collections in .NET applications. It allows grouping errors by property, handling change notifications, and serializing/deserializing error collections to/from JSON.

Key Features

• ErrorCollection: A robust collection for storing errors associated with property names.
• Notifications: Support for events when the error collection changes.
• JSON Serialization: Built-in extensions to convert error collections to JSON and vice versa.
• Multi-target Support: Compatible with .NET 8.0, .NET 9.0, and .NET 10.0.

Installation

You can install this package via NuGet:

dotnet add package Pitasoft.Error

Basic Usage

Creating an Error Collection and Adding Errors

using Pitasoft.Error;

var errors = new ErrorCollection();
errors.Add("Name", "The name is required.");
errors.Add("Email", "The email format is invalid.");

if (errors.AnyError())
{
    // Handle errors
}

Using Static Creation Methods

var errors = ErrorCollection.Create("General", "An unexpected error has occurred.");

JSON Serialization

using Pitasoft.Error.Extensions;

string json = errors.ToJson();

Deserialization from JSON

string json = "{\"name\":[\"Error 1\"]}";
var errors = json.ToErrorCollection();

Event Notifications

You can subscribe to changes in the error collection:

var errors = new ErrorCollection();
errors.ErrorsChanged += (sender, e) => 
{
    Console.WriteLine($"Property '{e.PropertyName}' was updated. Action: {e.Action}");
};

errors.Add("Username", "Already exists.");

Exception Handling

Easily convert exceptions into error collections:

try 
{
    // Some code that throws
}
catch (Exception ex)
{
    var errors = ErrorCollection.Create(ex, deep: true);
    // All inner exceptions are now captured in the collection
}

License

This project is licensed under the terms specified in the License.txt file.

Author

Sebastián Martínez Pérez - Pitasoft, S.L.

<a name="español"></a>

Español

Pitasoft.Error es una biblioteca de clases diseñada para facilitar el manejo y la gestión de colecciones de errores en aplicaciones .NET. Permite agrupar errores por propiedad, manejar notificaciones de cambios y serializar/deserializar colecciones de errores a JSON.

Características principales

• ErrorCollection: Una colección robusta para almacenar errores asociados a nombres de propiedades.
• Notificaciones: Soporte para eventos cuando la colección de errores cambia.
• Serialización JSON: Extensiones integradas para convertir colecciones de errores a JSON y viceversa.
• Soporte Multi-target: Compatible con .NET 8.0, .NET 9.0 y .NET 10.0.

Instalación

Puedes instalar este paquete a través de NuGet:

dotnet add package Pitasoft.Error

Uso básico

Crear una colección de errores y añadir errores

using Pitasoft.Error;

var errors = new ErrorCollection();
errors.Add("Nombre", "El nombre es obligatorio.");
errors.Add("Email", "El formato del email no es válido.");

if (errors.AnyError())
{
    // Manejar errores
}

Uso de métodos estáticos de creación

var errors = ErrorCollection.Create("General", "Ha ocurrido un error inesperado.");

Serialización a JSON

using Pitasoft.Error.Extensions;

string json = errors.ToJson();

Deserialización desde JSON

string json = "{\"nombre\":[\"Error 1\"]}";
var errors = json.ToErrorCollection();

Notificaciones de Eventos

Puedes suscribirte a los cambios en la colección de errores:

var errors = new ErrorCollection();
errors.ErrorsChanged += (sender, e) => 
{
    Console.WriteLine($"La propiedad '{e.PropertyName}' ha sido actualizada. Acción: {e.Action}");
};

errors.Add("Usuario", "Ya existe.");

Manejo de Excepciones

Convierte fácilmente excepciones en colecciones de errores:

try 
{
    // Código que lanza una excepción
}
catch (Exception ex)
{
    var errors = ErrorCollection.Create(ex, deep: true);
    // Todas las excepciones internas se capturan ahora en la colección
}

Licencia

Este proyecto está bajo la licencia especificada en el archivo License.txt.

Autor

Sebastián Martínez Pérez - Pitasoft, S.L.