Snipster 1.0.3

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

NuGet Packages Used

Installation

dotnet add package Snipster

Available Utilities

Validation Extensions

Extension Methods

Helper Methods

IGenericRepository Interface Methods

ICacheService Interface Methods

ITableLogger Interface Methods

Example Usage

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"

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

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);
       }
    }

    ...
}

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!";
        });
    }

    ...
}

Implement ITableLogger

using Snipster.Library.Logger;

public class TableLogger<TLog> : ITableLogger<TLog> where TLog : class
{
    private readonly IDbContextFactory<MyDbContext> _dbContextFactory;

    public TableLogger(IDbContextFactory<MyDbContext> dbContextFactory)
    {
        _dbContextFactory = dbContextFactory ?? throw new ArgumentNullException(nameof(dbContextFactory));
    }

    public async Task LogToTableAsync(TLog log, CancellationToken cancellationToken = default)
    {
        if (log == null)
            throw new ArgumentNullException(nameof(log));
        ...
    }

    ...
}

ITableLogger with DI

using Snipster.Library.Logger;

// Register DbContext
services.AddDbContext<MyLogDbContext>(options =>
    options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection"))
);

// Register ITableLogger
services.AddScoped<ITableLogger<MyErrorLog>>(sp =>
    new TableLogger<MyErrorLog>(() => sp.GetRequiredService<MyLogDbContext>()));

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

public class MyService
{
    private readonly ITableLogger<MyErrorLog> _logger;

    public MyService(ITableLogger<MyErrorLog> logger)
    {
        _logger = logger;
    }

    public async Task DoSomething()
    {
        try
        {
            ...
        }
        catch (Exception ex)
        {
            // Log object
            var logEntry = new TestLog
            {
                Message = "Test log message.",
                StackTrace = ex.StackTrace,
                Source = "Test source."
            }

            await _logger.LogToTableAsync(logEntry);
        }
    }
}

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
GitHub : darwijesinghe
Website : Portfolio

License

This project is licensed under the MIT License.