Snipster 1.0.4

Snipster

Snipster is a lightweight, open-source .NET utility library that provides a comprehensive collection of helper and extension methods for everyday development tasks — including validation, data formatting, parsing, security, and more. It also includes a generic repository interface with an optional EF Core-based implementation, as well as a flexible cache service for in-memory caching with configurable expiration and validation support.

Available on NuGet
License: MIT
Tags: .NET, utilities, helpers, validations, dotnet, repository, caching, uow, excel

NuGet Packages Used

Installation

dotnet add package Snipster

Available Utilities

Validation Extensions

Extension Methods

Helper Methods

IGenericRepository Interface Methods

IUnitOfWork Interface Methods

ICacheService Interface Methods

Example Usage for Extensions

String: Slugify & Case Conversion

using Snipster.Library.Extensions;

var title = "Hello World!";
var slug = title.Slugify();

// Output: "hello-world"

Collection: Chunk and Random Item

using Snipster.Library.Extensions;

var numbers = Enumerable.Range(1, 10);
var chunks = numbers.ChunkBy(3);

// Output: [[1,2,3],[4,5,6],[7,8,9],[10]]

JSON: Safe Serialization

using Snipster.Library.Extensions;

var json = new { Name = "Dev" }.ToJson();

// Output: {"Name":"Dev"}

var obj = "{"Name":"Dev"}".FromJson<Dictionary<string, string>>();
Console.WriteLine(obj["Name"]);

// Output: Dev

DateTime: Time Ago & Start of Day

using Snipster.Library.Extensions;

var ago = DateTime.UtcNow.AddMinutes(-10).ToTimeAgo();

// Output: "10 minutes ago"

Example Usage for Helpers

Security: Hash a password

using Snipster.Library.Helpers;

SecurityFx.PasswordHash("myPassword", out var hash, out var salt);
bool isValid = SecurityFx.VerifyPassword("myPassword", hash, salt);

// Output: true/false based on verification

File: Create a temporary file with the specified extension

using Snipster.Library.Helpers;

var tempFile = FileFx.CreateTempFile(".log");

// Verify if the file was created successfully
bool exists = File.Exists(tempFile);
Console.WriteLine($"File created: {exists} | Path: {tempFile}");

Excel: Create an Excel file with data, column definitions, and export options

using Snipster.Library.Helpers;
using Snipster.Library.Models;
using Snipster.Library.Enums;

// Your data list object
var data = new List<TestObject>
{
    new TestObject { Id = 1, Name = "John", Value = 1000, Age = 30, IsMember = true, JoinDate = new DateTime(2023, 01, 15), Salary = 5000.25, Commission = 0.075 },
    new TestObject { Id = 2, Name = "Anika", Value = 2500, Age = 27, IsMember = false, JoinDate = new DateTime(2024, 06, 05), Salary = 7250.50, Commission = 0.10 }
}

// Column definitions
var columns = new List<ExcelColumn>
{
    new ExcelColumn { Name = "Id", DataType = typeof(int), HeaderText = "ID", Format = ExcelFormats.Integer, Width = 25, Alignment = ExcelAlignment.Left, HeaderAlignment = ExcelAlignment.Left },
    new ExcelColumn { Name = "Name", DataType = typeof(string), HeaderText = "Full Name", Format = ExcelFormats.Text, Width = 25, Alignment = ExcelAlignment.Left, HeaderAlignment = ExcelAlignment.Left },
    new ExcelColumn { Name = "Value", DataType = typeof(int), HeaderText = "Value", Format = ExcelFormats.Integer, Width = 25, Alignment = ExcelAlignment.Left, HeaderAlignment = ExcelAlignment.Left },
    new ExcelColumn { Name = "Age", DataType = typeof(int), HeaderText = "Age", Format = ExcelFormats.Integer, Width = 25, Alignment = ExcelAlignment.Left, HeaderAlignment = ExcelAlignment.Left },
    new ExcelColumn { Name = "IsMember", DataType = typeof(bool), HeaderText = "Membership", TrueText = "Yes", FalseText = "No", Width = 25, Alignment = ExcelAlignment.Left, HeaderAlignment = ExcelAlignment.Left },
    new ExcelColumn { Name = "JoinDate", DataType = typeof(DateTime), HeaderText = "Join Date", Format = ExcelFormats.DateTime, Width = 25, Alignment = ExcelAlignment.Left, HeaderAlignment = ExcelAlignment.Left },
    new ExcelColumn { Name = "Salary", DataType = typeof(double), HeaderText = "Salary", Format = ExcelFormats.Currency, Width = 25, Alignment = ExcelAlignment.Left, HeaderAlignment = ExcelAlignment.Left },
    new ExcelColumn { Name = "Commission", DataType = typeof(double), HeaderText = "Commission", Format = ExcelFormats.Percent, Width = 25, Alignment = ExcelAlignment.Left, HeaderAlignment = ExcelAlignment.Left }
};

// Meta info
string sheetName = "TestSheet";
string tempFilePath = Path.GetTempPath();
string tempFileName = $"test-{Guid.NewGuid()}.xlsx";

// Write the file with export options
ExcelFx.WriteToExcel(data, columns, tempFilePath, tempFileName, opts =>
{
    opts.AutoFitColumns = false;
    opts.FreezeHeader = true;
    opts.AlternateRowColors = true;
    opts.HeaderBackground = XLColor.LightGray;
    opts.AlternateRowColor = XLColor.LightYellow;
    opts.SheetName = sheetName;
});

// Verify if the file was created successfully
string fullPath = Path.Combine(tempFilePath, tempFileName);
bool exists = File.Exists(fullPath);
Console.WriteLine($"File created: {exists} | Path: {fullPath}");

Repository & Unit of Work Patterns

Implement IGenericRepository

using Snipster.Library.Repository;

public class MyRepository<TEntity> : IGenericRepository<TEntity> where TEntity : class
{
    private readonly DbContext _context;
    private readonly DbSet<TEntity> _dbSet;

    public MyRepository(DbContext context)
    {
       _context = context;
       _dbSet = context.Set<TEntity>();
    }

    public async Task AddAsync(TEntity entity)
    {
       await _dbSet.AddAsync(entity);
    }

    ...
}

IGenericRepository with DI

// Register in DI
services.AddScoped(typeof(IGenericRepository<>), typeof(GenericRepository<>));

// Then use it in your services
using Snipster.Library.Repository;

public class UserService
{
    private readonly IGenericRepository<User> _userRepository;

    public UserService(IGenericRepository<User> userRepository)
    {
       _userRepository = userRepository;
    }

    public async Task PrintAllUsersAsync()
    {
       var users = await _userRepository.GetAllAsync();
       foreach(var user in users)
       {
           Console.WriteLine(user.Name);
       }
    }

    ...
}

IUnitOfWork with DI

// Register in DI
services.AddScoped<IUnitOfWork, UnitOfWork>();

// Then use it in your services
using Snipster.Library.UOW;

public class OrderService
{
    private readonly IUnitOfWork _uow;
    private readonly IGenericRepository<Order> _orderRepo;

    public OrderService(IUnitOfWork uow, IGenericRepository<Order> orderRepo)
    {
        _uow = uow;
        _orderRepo = orderRepo;
    }

    public async Task PlaceOrderAsync(Order order)
    {
        await _uow.BeginTransactionAsync();
        try
        {
            await _orderRepo.AddAsync(order);
            await _uow.SaveChangesAsync();

            // ... maybe add another entity

            await _uow.CommitAsync();
        }
        catch
        {
            await _uow.RollbackAsync();
            throw;
        }
    }

    ...
}

Cache Service

Implement ICacheService

using Snipster.Library.Cache;

public class MyCacheService : ICacheService
{
    private readonly IMemoryCache _cache;

    public MyCacheService(IMemoryCache cache)
    {
        _cache = cache;
    }

    public async Task<T?> SetCacheAsync<T>(string key, Func<Task<T>> create) where T : class
    {
        ...
    }

    ...
}

ICacheService with DI

// Register in DI
services.AddSingleton<ICacheService, CacheService>();

// Then use it in your services
using Snipster.Library.Cache;

public class MyService
{
    private readonly ICacheService _cacheService;

    public MyService(ICacheService cacheService)
    {
        _cacheService = cacheService;
    }

    public async Task<string?> GetDataAsync()
    {
        const string cacheKey = "my_data";

        return await _cacheService.SetCacheAsync(cacheKey, async () =>
        {
            // Simulate fetching data from a database or API
            await Task.Delay(100); 
            return "Hello from database!";
        });
    }

    ...
}

Contributions

Pull requests, suggestions, and feedback are welcome!
Feel free to fork and improve or extend the utility set for the .NET community.

Contributors

Thanks to these wonderful people for their contributions!
Contributors Graph

Maintainers

This project is maintained by:

• darwijesinghe

Support & Contact

Email : dar.dev.mail@gmail.com
LinkedIn: darwijesinghe
Website : Portfolio

License

This project is licensed under the MIT License.