Pitasoft.Parse 6.0.2

Pitasoft.Parse

English | Castellano

English

A high-performance .NET library providing extension methods for object property copying and byte/hex conversions.

Tags: Array, String, Byte, Hex, Copy, Property, Mapper, Performance, Span, Reflection

Features

• Efficient Property Copying: Copy matching properties between objects using compiled delegates (Expression Trees) for near-native performance.
  • Alias Support: Use the [Alias("Name")] attribute to map properties with different names.
  • C# Record Support: Compatible with record types, including those with init-only properties.
• Optimized Byte Conversions:
  • ToStringBytes / ToArrayBytes: Convert byte collections to/from comma-separated hex strings.
  • ToHexString / FromHexString: Convert byte collections to/from continuous hex strings (padded to 2 chars).
  • Try Pattern: Safe TryToArrayBytes to avoid exceptions.
• Low Memory Footprint: Leverages Span<T>, string.Create, and caching to minimize allocations and Garbage Collector pressure.
• Cross-Platform: Supports .NET 8.0, 9.0, and 10.0.

Installation

dotnet add package Pitasoft.Parse

Usage

Property Copying

You can copy all matching properties from one object to another (or to a new instance). It supports class and record types.

Classes and Aliases

using Pitasoft.Parse;

public class User {
    public int Id { get; set; }
    public string Name { get; set; }
}

public class UserDto {
    [Alias("Id")]
    public int Identifier { get; set; } // Matches User.Id because of the alias
    public string Name { get; set; }
}

var source = new User { Id = 1, Name = "John Doe" };

// Create a new instance and copy matching properties (including aliases)
var target = source.CopyAllProperties<User, UserDto>();

C# Records

The library works with record types. For methods that create a new instance, the record must have a parameterless constructor (required by the new() constraint).

public record UserRecord
{
    public string Name { get; init; } = string.Empty;
    public int Age { get; init; }
    
    public UserRecord() { } // Required for methods that instantiate the record
}

var source = new User { Name = "Jane Doe", Age = 30 };
var record = source.CopyAllProperties<User, UserRecord>();

Byte and Hex Conversions

using Pitasoft.Parse;

byte[] data = { 0xDE, 0xAD, 0xBE, 0xEF };

// To comma-separated hex: "de,ad,be,ef"
string csvHex = data.ToStringBytes();

// To continuous hex: "deadbeef"
string continuousHex = data.ToHexString();

// Back to byte array
byte[] recovered1 = csvHex.ToArrayBytes();
byte[] recovered2 = continuousHex.FromHexString();

// Safe conversion
if (csvHex.TryToArrayBytes(out byte[]? result)) {
    // use result
}

Performance

The library is designed for high-throughput scenarios:

• Property Copying: ~13ns per operation (73% faster than traditional reflection).
• Byte Conversions: Optimized with Span and pre-calculated buffers.

Castellano

Una librería de alto rendimiento para .NET que proporciona métodos de extensión para la copia de propiedades de objetos y conversiones de bytes/hexadecimal.

Etiquetas: Array, String, Byte, Hex, Copy, Property, Mapper, Performance, Span, Reflection

Características

• Copia Eficiente de Propiedades: Copia propiedades coincidentes entre objetos utilizando delegados compilados (Expression Trees) para un rendimiento cercano al nativo.
  • Soporte de Alias: Utilice el atributo [Alias("Nombre")] para mapear propiedades con nombres diferentes.
  • Soporte para Records de C#: Compatible con tipos record, incluyendo aquellos con propiedades init-only.
• Conversiones de Bytes Optimizadas:
  • ToStringBytes / ToArrayBytes: Convierte colecciones de bytes a/desde cadenas hexadecimales separadas por comas.
  • ToHexString / FromHexString: Convierte colecciones de bytes a/desde cadenas hexadecimales continuas (rellenadas a 2 caracteres).
  • Patrón Try: TryToArrayBytes para conversiones seguras sin excepciones.
• Bajo Consumo de Memoria: Aprovecha Span<T>, string.Create y el almacenamiento en caché para minimizar las asignaciones y la presión sobre el Garbage Collector.
• Multiplataforma: Soporta .NET 8.0, 9.0 y 10.0.

Instalación

dotnet add package Pitasoft.Parse

Uso

Copia de Propiedades

Puede copiar todas las propiedades coincidentes de un objeto a otro (o a una nueva instancia). Soporta tanto tipos class como record.

Clases y Alias

using Pitasoft.Parse;

public class Usuario {
    public int Id { get; set; }
    public string Nombre { get; set; }
}

public class UsuarioDto {
    [Alias("Id")]
    public int Identificador { get; set; } // Coincide con Usuario.Id por el alias
    public string Nombre { get; set; }
}

var fuente = new Usuario { Id = 1, Nombre = "Juan Pérez" };

// Crear una nueva instancia y copiar las propiedades coincidentes (incluyendo alias)
var destino = fuente.CopyAllProperties<Usuario, UsuarioDto>();

Records de C#

La librería funciona con tipos record. Para los métodos que crean una nueva instancia, el record debe tener un constructor sin parámetros (requerido por la restricción new()).

public record UsuarioRecord
{
    public string Nombre { get; init; } = string.Empty;
    public int Edad { get; init; }
    
    public UsuarioRecord() { } // Requerido para métodos que instancian el record
}

var fuente = new Usuario { Nombre = "Juana Pérez", Edad = 30 };
var record = fuente.CopyAllProperties<Usuario, UsuarioRecord>();

Conversiones de Bytes y Hexadecimal

using Pitasoft.Parse;

byte[] data = { 0xDE, 0xAD, 0xBE, 0xEF };

// A hex separado por comas: "de,ad,be,ef"
string csvHex = data.ToStringBytes();

// A hex continuo: "deadbeef"
string continuousHex = data.ToHexString();

// De vuelta a array de bytes
byte[] recuperado1 = csvHex.ToArrayBytes();
byte[] recuperado2 = continuousHex.FromHexString();

// Conversión segura
if (csvHex.TryToArrayBytes(out byte[]? resultado)) {
    // usar resultado
}

Rendimiento

La librería está diseñada para escenarios de alto rendimiento:

• Copia de Propiedades: ~13ns por operación (un 73% más rápido que la reflexión tradicional).
• Conversiones de Bytes: Optimizado con Span y buffers precalculados.

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

Copyright © 2020-2026 Pitasoft, S.L. All rights reserved.