mjfreelancing / alloverit

A suite of libraries aimed at providing a simplified and consistent approach to cross-cutting and functional concerns.

Overview

AllOverIt began as a single nuget package of the same name in 2015. Since then, the library has broadened and deepened in functionality, resulting in a comprehensive set of dedicated nuget packages that encompass a number of different domains.

Refer to the Change Log for an overview of what has recently changed.

Refer to the online Documentation for comprehensive usage information.

A summary for each of the available packages is provided below.

AllOverIt

This general-purpose package contains a diverse range of classes and utility functions, intended to tackle a wide array of commonly encountered issues.

Key areas of concern include threading, tasks, generic caching, event (message) aggregation, expression and reflection utilities, plugin contexts, enriched enums, pipelines, value objects, specifications, and dozens of extensions.

---

AllOverIt.AspNetCore

This package provides useful ASP.NET Core utilities such as custom model binding for AllOverIt based enriched enum types, and arrays of values in a query string.

---

AllOverIt.Assertion

This package contains a useful collection of pre- and post-condition assertion extension methods, and a fluent-like approach to throwing exceptions based on a given condition or custom predicate.

---

AllOverIt.Aws.AppSync.Client

This package contains AWS AppSync GraphQL and Subscription clients with support for serialization using Newtonsoft or System.Text, including serialization of AllOverIt based enriched enums.

---

AllOverIt.Aws.Cdk.AppSync

This package greatly simplifies the generation of AWS Graphql schemas, including their associated mapping and resolver configuration, using a code-first approach.

---

AllOverIt.Cryptography

This package provides byte-array and stream-based interfaces for encryption algorithms such as AES, RSA and an RSA-AES hybrid. It also includes useful extension methods that greatly simplifies the encryption and decryption between byte-arrays, streams, plain text and base64 encoded versions of plain text and cipher text.

---

AllOverIt.Csv

Using CsvHelper to perform the actual writing of CSV content, this package provides a configuration based serializer that can export data using a model with fixed columns as well as dynamic columns derived from complex or array type properties.

---

AllOverIt.DependencyInjection

This package provides useful dependency injection related utilities such as registering and resolving 'named' services, auto service discovery and registration via a service registrar, and service decoration.

---

AllOverIt.EntityFrameworkCore

This package provides EntityFramework Core utilities such as a database migration helper and a value converter for AllOverIt based enriched enum types.

---

AllOverIt.EntityFrameworkCore.Diagrams

In conjunction with D2, this package will generate entity relationship diagrams for an EntityFramework Core DbContext.

---

AllOverIt.EntityFrameworkCore.Pagination

Using AllOverIt.Pagination as the basis for advanced keyset-based pagination, this package provides additional extensions for use with EntityFramework Core.

---

AllOverIt.Evaluator

This package contains a highly-extendable mathematical expression compiler and evaluator that includes constant, mutable, delegate, and lazily evaluated variables, offers implicit and explicit variable lookup, and supports custom arithmetic operators and operations.

---

AllOverIt.Filtering

This package adds comprehensive filtering support to any IQueryable with built-in provision for operations such as Contains, StartsWith, EndsWith, In, NotIn, EqualTo, NotEqualTo, GreaterThan, LessThan, GreaterThanOrEqual, and LessThanOrEqual.

It's also possible to create a custom predicate based on a Specification and there are options such as ignoring default (null) filter values and parameterizing query inputs that makes it ideal for use with EntityFramework Core.

---

AllOverIt.Fixture

This package contains a base fixture class with numerous helper methods to assist with scaffolding unit tests. Utilizes AutoFixture to do most of the hard work.

---

AllOverIt.Fixture.FakeItEasy

This package extends AllOverIt.Fixture to support FakeItEasy integration.

---

AllOverIt.GenericHost

This package contains generic host helpers and convenience methods for setting up console applications that support dependency injection.

---

AllOverIt.Logging

This package contains extension methods to provide additional logging functionality.

AllOverIt.Logging.Testing

This package contains helper methods that assist with asserting logger calls.

AllOverIt.Mapping

This package contains an object mapper that is mostly configuration free, but also capable of property exclusion, aliasing, null replacement, value conversion, and deep copying.

---

AllOverIt.Pagination

An advanced keyset-based pagination package that uses a fluent-style builder to create queries that cater for forward and backward navigation for any given deterministic base query.

Each page of results includes a 'continuation token' for the current, next, and previous page. These tokens can be used at a later time to navigate to the same location within the dataset, thereby somewhat overcoming the inability of random access traditionally associated with keyset-based navigation.

---

AllOverIt.Pipes

This package provides support for communication over anonymous pipes using StreamReader and StreamWriter, and strongly-typed message-based communication over named pipes using a binary serializer.

The named pipes can use the binary serializer from AllOverIt.Serialization.Binary or you can create your own.

---

AllOverIt.Reactive

This package contains utility extensions for use with System.Reactive.

---

AllOverIt.ReactiveUI

This package contains utility extensions for use with ReactiveUI.

---

AllOverIt.ReactiveUI.Wpf

This package contains utility extensions for use with ReactiveUI and WPF.

---

AllOverIt.Serialization.Binary

This package provides enhanced support for binary serialization. Complex object graphs, lists, dictionaries and nullable values can all be dynamically serialized using reflection-based readers and writers or, for greater performance, a custom serializer per object within the graph.

---

AllOverIt.Serialization.Json.Abstractions

This package contains JSON serialization abstractions.

---

AllOverIt.Serialization.Json.NewtonSoft

This package contains a wrapper for Newtonsoft JSON serialization based on AllOverIt.Serialization.Json.Abstractions.

---

AllOverIt.Serialization.Json.SystemText

This package contains a wrapper for System.Text JSON serialization based on AllOverIt.Serialization.Json.Abstractions.

---

AllOverIt.Serilog

This package contains general-purpose Serilog sinks and enrichers.

AllOverIt.Validation

This package contains additional validators and extensions for use with FluentValidation. It includes an invoker that will select, and invoke, a registered validator based on a provided model.

Synchronous and Asynchronous validation is supported, along with extensions that make it easier to pass context information into a validator to keep it stateless.

Also available is a validation registrar that makes it possible to auto-register all validators within the same assembly. Validators can also be filtered based on a predicate.

---

AllOverIt.Validation.Options

This package contains Microsoft.Extensions.Options validation using FluentValidation.

---

AllOverIt.Wpf

This package contains general purpose WPF utilities.

---

AllOverIt.Wpf.Controls

This package contains useful WPF controls.

---

alloverit's Issues

AllOverIt.EntityFrameworkCore.Diagrams Does Not Work With The .NET Options Pattern

Describe the bug
.NET uses the Options Pattern to provide configuration.

The D2ErdGenerator constructor requires an "ErdOptions" class. However, it does not accept an IOptions<ErdOptions> or similar. This means that it cannot be instantiated by dependency injection without hacks.

To Reproduce
Steps to reproduce the behavior:

• Add the AllOverIt.EntityFrameworkCore.Diagrams package.
• Use the default options: builder.Services.Configure<ErdOptions>(options => {});
• Register the service builder.Services.AddSingleton(D2ErdGenerator)();
• Add an endpoint app.MapGet("/DbDiagram", (D2ErdGenerator generator, MyDbContext dbContext) => generator.Generate(dbContext));

Expected behavior
The ERD string is generated.

** Actual behavior**
Crashes.

Additional context
This can be hacked around with the following: builder.Services.AddTransient( serviceProvider => serviceProvider.GetRequiredService<IOptions<ErdOptions>>().Value );

AllOverIt.Extensions.DoubleExtensions remove Epsilon

At current, the DoubleExtensions class has a defined constant const double Epsilon = 1E-07.
I propose removing it to use the build-in double.Epsilon, then adding overloads to allow for custom variance, which seems to be the more modern approach in many other libraries.

This old post on StackOverflow describes that:

The System.Double type can represent values accurate to up to 15 digits. So a simple first order estimate if a double value x is equal to some constant is to use an epsilon of constant * 1E-15

Another post on the same thread suggests their own implementation, should you wish to keep a default variance:

/// <summary>
/// smallest such that 1.0+EpsilonD != 1.0
/// </summary>
public const double EpsilonD = 2.2204460492503131e-016;