Mapito 0.1.0-alpha
See the version list below for details.
dotnet add package Mapito --version 0.1.0-alpha
NuGet\Install-Package Mapito -Version 0.1.0-alpha
<PackageReference Include="Mapito" Version="0.1.0-alpha" />
paket add Mapito --version 0.1.0-alpha
#r "nuget: Mapito, 0.1.0-alpha"
// Install Mapito as a Cake Addin #addin nuget:?package=Mapito&version=0.1.0-alpha&prerelease // Install Mapito as a Cake Tool #tool nuget:?package=Mapito&version=0.1.0-alpha&prerelease
Mapito - Simple Type-to-Type Mapping Library
Mapito is a C# library designed to facilitate simple type-to-type mapping in your projects. It provides an easy-to-use interface and DI (Dependency Injection) integration for mapping objects from one type to another.
Note: Parts of this readme file was written with the help of ChatGPT, an AI language model developed by OpenAI.
Features
- Type Mapping: Map entities of type
TSource
to typeTDest
. - Asynchronous Mapping: Asynchronous mapping methods for better performance and scalability.
- Dependency Injection: Use Mapito seamlessly with Dependency Injection by using the provided extension method.
Installation
You can install Mapito via NuGet Package Manager or by using the .NET CLI.
Package Manager Console
Install-Package Mapito
.NET CLI
dotnet add package Mapito
Getting Started
First, install the Mapito library in your project using the installation steps mentioned above.
Define your classes or models for which you want to perform the mapping.
Create a class that implements the
IMapper<TSource, TDest>
interface to handle the mapping logic for specific types. For example:
public class MyModelToDtoMapper : IMapper<MyModel, MyDto>
{
public async Task<MyDto> Map(MyModel source)
{
// Mapping logic here
// e.g., return new MyDto { ... };
}
}
- Register your mapper classes with the DI container using the
AddMapito
extension method:
public void ConfigureServices(IServiceCollection services)
{
// Other service registrations
// Register Mapito with mappers
services.AddMapito(config =>
{
config.AddMapper<MyModel, MyDto, MyModelToDtoMapper>();
// Add other mappers as needed
});
}
- Inject the
IMapitoService
into your classes where you need to perform the mapping:
public class MyClass
{
private readonly IMapitoService _mapitoService;
public MyClass(IMapitoService mapitoService)
{
_mapitoService = mapitoService;
}
public async Task<MyDto> PerformMapping(MyModel source)
{
MyDto result = await _mapitoService.Map<MyModel, MyDto>(source);
return result;
}
}
- Enjoy the benefits of seamless type-to-type mapping with Mapito in your projects!
API Documentation
IMapitoService
Task<TDest> Map<TSource, TDest>(TSource source);
Maps an entity of type TSource
to type TDest
.
TSource
: The source type to map from.TDest
: The destination type to map to.source
: Source entity to map from.- Returns: The source entity mapped to the destination type.
Task<IList<TDest>> Map<TSource, TDest>(IEnumerable<TSource> source);
Maps entities of type TSource
to type TDest
.
TSource
: The source type to map from.TDest
: The destination type to map to.source
: Source entities to map from.- Returns: A list of source entities mapped to the destination type.
Contribution
Contributions to Mapito are welcome! If you encounter any issues or have ideas for improvements, feel free to open an issue or submit a pull request.
License
Mapito is released under the MIT License.
Thank you for choosing Mapito for your type-to-type mapping needs! If you have any questions or need further assistance, feel free to reach out. Happy coding!
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net7.0
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.2.0-alpha | 75 | 7/27/2023 |
1.1.0-alpha | 87 | 7/20/2023 |
0.1.0-alpha | 84 | 7/19/2023 |