EasyExtensions.EntityFrameworkCore 3.0.65

EasyExtensions

EasyExtensions is a modular set of .NET packages for application code that tends to repeat across projects: core BCL extensions, ASP.NET Core helpers, PostgreSQL/EF Core setup, Quartz job registration, WebDAV clients, ImageSharp utilities, embedded fonts, streaming AES-GCM encryption, and a lightweight mediator.

The repository is intentionally split into small NuGet packages. Install only the package you need, keep your application dependencies narrow, and use the XML documentation in your IDE or FuGet when you need a full API reference.

Contents

• Packages
• Installation
• Quick Examples
• Configuration Notes
• Build and Test
• Releases
• Contributing
• License

Packages

Installation

Install packages individually:

dotnet add package EasyExtensions
dotnet add package EasyExtensions.AspNetCore
dotnet add package EasyExtensions.Crypto
dotnet add package EasyExtensions.EntityFrameworkCore.Npgsql

For an opinionated ASP.NET Core setup, start with:

dotnet add package EasyExtensions.AspNetCore.Stack

Quick Examples

Core Helpers

using EasyExtensions.Extensions;
using EasyExtensions.Helpers;
using System.Net;

string digest = "hello".Sha512();
IPAddress network = IPAddress.Parse("192.168.10.25").GetNetwork(24);
string maskedEmail = StringHelpers.HideEmail("vadim@example.com");

ASP.NET Core

using EasyExtensions.AspNetCore.Extensions;

builder.Logging.AddSimpleConsoleLogging();

builder.Services
    .AddDefaultHealthChecks()
    .AddDefaultCorsWithOrigins("https://app.example.com")
    .AddExceptionHandler()
    .AddPbkdf2PasswordHashService();

JWT Authorization

using EasyExtensions.AspNetCore.Authorization.Extensions;

builder.Services.AddJwt(useCookies: true);

{
  "JwtSettings": {
    "Key": "0123456789abcdef0123456789abcdef",
    "Issuer": "my-api",
    "Audience": "my-clients",
    "LifetimeMinutes": 60
  }
}

EasyStack

using EasyExtensions.AspNetCore.Stack.Extensions;

builder.AddEasyStack(stack => stack
    .WithPostgres<AppDbContext>(useLazyLoadingProxies: false)
    .AddAuthorization()
    .UseSecrets(useSecrets: true));

PostgreSQL and EF Core

using EasyExtensions.EntityFrameworkCore.Npgsql.Extensions;

builder.Services.AddPostgresDbContext<AppDbContext>(postgres =>
{
    postgres.ConfigurationSection = "DatabaseSettings";
    postgres.UseLazyLoadingProxies = false;
});

{
  "DatabaseSettings": {
    "Host": "localhost",
    "Port": "5432",
    "Username": "postgres",
    "Password": "postgres",
    "Database": "app"
  }
}

Quartz Jobs

using EasyExtensions.Quartz.Attributes;
using EasyExtensions.Quartz.Extensions;
using Quartz;

[JobTrigger(minutes: 5, startNow: true)]
public sealed class CleanupJob : IJob
{
    public Task Execute(IJobExecutionContext context)
    {
        return Task.CompletedTask;
    }
}

builder.Services.AddQuartzJobs();

Streaming Encryption

using EasyExtensions.Crypto;
using System.Security.Cryptography;

byte[] masterKey = RandomNumberGenerator.GetBytes(AesGcmStreamCipher.KeySize);
using var cipher = new AesGcmStreamCipher(masterKey, memoryLimitBytes: 256L * 1024 * 1024);

await using var input = File.OpenRead("plain.bin");
await using var encrypted = File.Create("plain.bin.eegcm");
await cipher.EncryptAsync(input, encrypted);

await using var cipherText = File.OpenRead("plain.bin.eegcm");
await using var plainText = File.Create("plain-restored.bin");
await cipher.DecryptAsync(cipherText, plainText);

WebDAV and Nextcloud

using EasyExtensions.WebDav;

using var client = WebDavCloudClient.CreateNextcloudClient(
    "https://cloud.example.com",
    username: "user",
    password: "app-password");

await client.CreateFolderAsync("backups");
using var backup = File.OpenRead("backup.zip");
await client.UploadFileAsync(backup, "backups/backup.zip");

Configuration Notes

• The full solution currently uses the .NET 10 SDK. Some packages still target netstandard2.1; see the package table before choosing a package for older applications.
• EasyExtensions.AspNetCore.Authorization accepts either a JwtSettings section or flat JwtKey, JwtIssuer, JwtAudience, and JwtLifetimeMinutes keys. Configure a persistent signing key in production.
• EasyExtensions.AspNetCore.Stack allows all CORS origins when CorsOrigins is missing. Set CorsOrigins explicitly for production services.
• EasyExtensions.AspNetCore.Sentry enables SendDefaultPii when Sentry is active. Review this against your data handling policy.
• EasyExtensions.Crypto expects you to own key storage and rotation. Do not hard-code master keys in source control.
• EasyExtensions.WebDav currently changes ServicePointManager.ServerCertificateValidationCallback; review this before production use.

Build and Test

git clone https://github.com/bvdcode/EasyExtensions.git
cd EasyExtensions/Sources
dotnet restore
dotnet build --configuration Release
dotnet test --configuration Release

The test projects use NUnit and target net10.0.

Releases

Releases are produced by GitHub Actions from main when files under Sources/ change. The workflow builds the solution, packs NuGet packages, publishes artifacts, pushes packages to GitHub Packages and NuGet.org, and creates a GitHub release. Versioning is driven by GitVersion; the current next-version is configured in GitVersion.yml.

Contributing

Contributions are welcome. For a clean pull request:

1. Fork the repository.
2. Create a focused feature branch.
3. Add or update tests for behavior changes.
4. Run dotnet test from Sources/.
5. Update this README when package scope, setup, or public examples change.
6. Open a pull request with a clear description of the change.

Issues and feature requests are also welcome. Small, well-scoped proposals are easiest to review.

License

Most packages are distributed under the MIT License. See LICENSE.md.

EasyExtensions.Mediator is based on MediatR v12.5.0 and uses Apache-2.0 package licensing. See Sources/EasyExtensions.Mediator/LICENSE.md.

Contact

Created and maintained by Vadim Belov.