DatStoreUtil 1.0.0

DatStoreUtil

Biblioteca .NET 8 sin dependencias externas para guardar objetos en archivos .dat.

• Serialización tipada mediante System.Text.Json.
• Escritura atómica con archivo temporal.
• Copia .bak automática al reemplazar datos.
• Integridad SHA-256 para detectar modificaciones o daños.
• Cifrado opcional AES-256-GCM con PBKDF2-SHA256.
• Metadatos y errores tipados.

Un .dat no tiene un formato universal. Esta biblioteca abre los archivos .dat creados por ella; para un .dat de otro programa se necesita conocer su formato.

Instalación

dotnet add package DatStoreUtil --version 1.0.0

Uso básico

using DatStoreUtil;

var settings = new AppSettings("Mi equipo", true);
await DatFile.SaveAsync("configuracion.dat", settings);

AppSettings? loaded = await DatFile.LoadAsync<AppSettings>("configuracion.dat");

public sealed record AppSettings(string TeamName, bool NotificationsEnabled);

Al guardar por segunda vez, el valor anterior queda en configuracion.dat.bak y puede abrirse así:

AppSettings? previous = await DatFile.LoadBackupAsync<AppSettings>("configuracion.dat");

Cifrado

var secureOptions = new DatFileOptions
{
    Password = Environment.GetEnvironmentVariable("MI_DAT_PASSWORD")
        ?? throw new InvalidOperationException("Falta MI_DAT_PASSWORD")
};

await DatFile.SaveAsync("secretos.dat", settings, secureOptions);
AppSettings? secureData = await DatFile.LoadAsync<AppSettings>("secretos.dat", secureOptions);

No guardes contraseñas en el código ni en el repositorio. La contraseña debe tener al menos 12 caracteres al crear el archivo.

Abrir sin excepciones esperadas

DatFileReadResult<AppSettings> result =
    await DatFile.TryLoadAsync<AppSettings>("configuracion.dat");

if (result.IsSuccess)
{
    Console.WriteLine(result.Value?.TeamName);
}
else
{
    Console.WriteLine($"{result.ErrorCode}: {result.ErrorMessage}");
}

Utilidad incluida para abrir archivos DAT

El repositorio contiene samples/data/datos.dat. Para abrirlo:

dotnet run --project tools/DatStoreUtil.Cli -- samples/data/datos.dat

Compilar, probar y empaquetar

.\scripts\pack.ps1

El script deja el .nupkg y el paquete de símbolos .snupkg en artifacts/packages.

Antes de publicar una nueva versión, cambia <Version> en src/DatStoreUtil/DatStoreUtil.csproj. Para subirla a NuGet.org:

.\scripts\publish.ps1 -ApiKey $env:NUGET_API_KEY

El PackageId debe ser único en NuGet.org y la publicación requiere una cuenta con una API key.

Compatibilidad y límites

• Requiere .NET 8 o posterior.
• Formato actual: versión 1 (CDAT).
• Tamaño máximo predeterminado: 64 MiB, configurable con MaxFileSizeBytes.
• La escritura atómica y el bloqueo cubren procesos que usan correctamente esta biblioteca; no convierten el archivo en una base de datos multiusuario.

Licencia

MIT.