This repository contains work-in-progress code for framework functionality and is a candidate to be merged with the QueryMutator repo.
MutatorFX is currently available on NuGet, altough still in early beta. Feel free to experiment, give feedback and contribute!
All MutatorFX packages lets you write much less code for the same effect, with a lot less room for developer error.
MutatorFX contains the following for all .NET based projects compatible with .NET Standard 2.0:
MutatorFX.Core [NuGet, Documentation]
The lightweight Core package other packages depend upon. In itself, it contains useful extension methods for creating one-liners, using reflection, etc., so that you can use these if you fancy enormous one-liners! I have not yet found a problem that couldn't be solved in one expression with these!
Fluent extensions: for writing one-liners and shortening code.
Reflection extensions: commonly used framework functionality involving the Type object and other reflection goodies.
MutatorFX.FilterMutator.Core [NuGet, Documentation]
FilterMutator is an opinionated filtering framework in itself. It provides a composing mechanism to fully control how querying a data source works in your application. Compatible with all dependency injection frameworks. The main concepts you should get familiar with are Pagers, Sorters, Transformers, SourceAccessors, Filterers and QueryExecutors as composition of these components. The MutatorFX.FilterMutator.Core package provides features to set up a consistent filtering schema in your application.
MutatorFX.FilterMutator.Abstractions [NuGet, Documentation]
The abstractions package contains only the public facing interfaces of FilterMutator, so if you want to create a custom extension for FilterMutator for other frameworks or different use cases, you should only reference the abstractions package. If you create a package, don't hesitate to create an issue so that I can list your package here!
MutatorFX.FilterMutator.EFCore: [NuGet, Documentation]
Entity Framework Core specific extension package. Only contains two SourceAccessor types (DbSetSourceAccessor<TDbContext, TEntity> and DbSetSourceAccessor<TEntity>) which you can use with EF Core and dependency injection frameworks.
MutatorFX.QueryMutator.Core [NuGet, Documentation]
QueryMutator is a convention-based object mapper specifically built for Queryable projection. Easily create and customize mappings between objects, create mappings with runtime parameters or by using attributes. Mapping Queryables has never been easier!
On how to get started using the library, check out the getting started guide.
Documentation generated with the Vsxmd package, big thanks to Li Junle!
All contributions welcome! Happy hacking!