Acontplus.Utilities 1.0.13

Acontplus.Utilities

A comprehensive .NET 9+ utility library providing common functionality for enterprise applications. Modern async, extension methods, minimal API support, and more.

🚀 Features

• Encryption - Data encryption/decryption utilities
• External Validations - Third-party validation integrations
• Barcode Generation - Barcode creation and processing
• Custom Logging - Enhanced logging capabilities
• Enum Extensions - Enhanced enum functionality
• Picture Helper - Image processing utilities
• Text Handlers - Text manipulation and processing
• API Response Extensions - Convert results to IActionResult or IResult for MVC/Minimal APIs
• Pagination & Metadata - Helpers for API metadata, pagination, and diagnostics

📦 Installation

NuGet Package Manager

Install-Package Acontplus.Utilities

.NET CLI

dotnet add package Acontplus.Utilities

PackageReference

<ItemGroup>
  <PackageReference Include="Acontplus.Utilities" Version="1.0.12" />
</ItemGroup>

🎯 Quick Start

1. API Response Extensions (Minimal API)

using Acontplus.Utilities.Extensions;

app.MapGet("/example", () =>
{
    var response = new ApiResponse<string>("Hello World");
    return response.ToMinimalApiResult();
});

2. API Response Extensions (Controller)

using Acontplus.Utilities.Extensions;

public IActionResult Get()
{
    var response = new ApiResponse<string>("Hello World");
    return response.ToActionResult();
}

3. Encryption Example

var encryptionService = new SensitiveDataEncryptionService();
byte[] encrypted = await encryptionService.EncryptToBytesAsync("password", "data");
string decrypted = await encryptionService.DecryptFromBytesAsync("password", encrypted);

4. Pagination Metadata Example

var metadata = new Dictionary<string, object>()
    .WithPagination(page: 1, pageSize: 10, totalItems: 100);

🔧 Advanced Usage

File Name Sanitization

string safeName = FileExtensions.SanitizeFileName("my*illegal:file?.txt");

Base64 Conversion

string base64 = FileExtensions.GetBase64FromByte(myBytes);

Compression Utilities

byte[] compressed = CompressionUtils.CompressGZip(data);
byte[] decompressed = CompressionUtils.DecompressGZip(compressed);

📚 API Documentation

• SensitiveDataEncryptionService - AES encryption/decryption helpers
• FileExtensions - File name and byte array utilities
• CompressionUtils - GZip/Deflate compression helpers
• TextHandlers - String formatting and splitting
• ApiResponseExtensions - API response helpers for MVC/Minimal APIs
• DirectoryHelper / EnvironmentHelper - Runtime and environment utilities

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

git clone https://github.com/Acontplus-S-A-S/acontplus-dotnet-libs.git
cd acontplus-dotnet-libs
dotnet restore
dotnet build

📄 License

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

🆘 Support

• 📧 Email: proyectos@acontplus.com
• 🐛 Issues: GitHub Issues
• 📖 Documentation: Wiki

👨‍💻 Author

Ivan Paz - @iferpaz7

🏢 Company

Acontplus S.A.S. - Enterprise software solutions

Built with ❤️ for the .NET community