SingularFrameworkCore.Repository.FileSystem.BinaryFile 0.2.0-beta

SingularFrameworkCore.Repository.FileSystem.BinaryFile

A C# library that provides binary file storage implementation for the SingularFrameworkCore repository interface. This library offers both synchronous and asynchronous implementations for storing byte[] data in binary files.

Features

• Binary File Storage: Simple implementation for storing byte[] data in binary files
• Dual Implementation: Both synchronous (BinaryFileRepository) and asynchronous (BinaryFileRepositoryAsync) versions
• CRUD Operations: Full support for Create, Read, Update, and Delete operations
• Path Management: Secure file path handling
• Exception Handling: Custom exceptions for common scenarios

Installation

The package is available on NuGet. To install it, use the following command:

Install-Package SingularFrameworkCore.Repository.FileSystem.BinaryFile

Or using the .NET CLI:

dotnet add package SingularFrameworkCore.Repository.FileSystem.BinaryFile

Usage

Synchronous Implementation

using SingularFrameworkCore.Repository.FileSystem.BinaryFile;

// Create an instance with a file path
var repository = new BinaryFileRepository("path/to/your/file.bin");

// Create
repository.Create(Encoding.UTF8.GetBytes("Hello, World!"));

// Read
byte[] content = repository.Read();

// Update
repository.Update(Encoding.UTF8.GetBytes("Updated content"));

// Delete
repository.Delete();

Asynchronous Implementation

using SingularFrameworkCore.Repository.FileSystem.BinaryFile;

// Create an instance with a file path
var repository = new BinaryFileRepositoryAsync("path/to/your/file.bin");

// Create
await repository.Create(Encoding.UTF8.GetBytes("Hello, World!"));

// Read
byte[] content = await repository.Read();

// Update
await repository.Update(Encoding.UTF8.GetBytes("Updated content"));

// Delete
await repository.Delete();

Integration with SingularFrameworkCore

This library implements the ISingularCrudRepository<byte[]> and ISingularCrudAsyncRepository<byte[]> interfaces from SingularFrameworkCore, making it perfect for use with the Singular pipeline:

var singular = new Singular<MyClass, byte[]>(
    new BinaryFileRepository("data.bin"), // or BinaryFileRepositoryAsync
    serializer,
    preProcessors,
    postProcessors
);

Exception Handling

The library includes a custom exception:

• BinaryFileRepositoryFileAlreadyExistsException: Thrown when attempting to create a file that already exists

try 
{
    repository.Create(Encoding.UTF8.GetBytes("content"));
}
catch (BinaryFileRepositoryFileAlreadyExistsException ex)
{
    // Handle the case where the file already exists
}

Requirements

• .NET Standard 8.0+
• SingularFrameworkCore

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Author

Made by Mohammad Ayaad

Original Project

• SingularFrameworkCore - The core framework this implementation is built for