TurboMapper is a lightweight, high-performance object mapper for .NET that provides both shallow and deep mapping capabilities. It serves as a free alternative to AutoMapper with a simple, intuitive API.
Install the latest version of TurboMapper nuget package with command below.
NuGet\Install-Package TurboMapper
using TurboMapper;
using Microsoft.Extensions.DependencyInjection;
// Setup
var services = new ServiceCollection();
services.AddTurboMapper();
var serviceProvider = services.BuildServiceProvider();
var mapper = serviceProvider.GetService<IMapper>();
// Define models
public class Source
{
public string Name { get; set; }
public int Age { get; set; }
}
public class Target
{
public string Name { get; set; }
public int Age { get; set; }
}
// Map single object
var source = new Source { Name = "John Doe", Age = 30 };
var target = mapper.Map<Source, Target>(source);
// Map collections
var sources = new List<Source>
{
new Source { Name = "Alice", Age = 25 },
new Source { Name = "Bob", Age = 32 }
};
// Map to IEnumerable<T>
IEnumerable<Target> targets = mapper.Map<Source, Target>(sources);This comprehensive guide provides detailed information on TurboMapper, covering everything from basic concepts to advanced implementations and troubleshooting guidelines.
Please click on Developer Guide for complete details.
This section provides the summary of planned releases with key details about each release.
| Release Version | Release Date | Key Features | Backward Compatibility | Primary Focus |
|---|---|---|---|---|
| 1.2.0 | October 2025 | Performance improvements (2x+ speed), enhanced collection mapping API, custom type converters, conditional mapping, transformation functions, configuration validation, improved error messages | ✅ Fully backward compatible | Core improvements, mapping features, custom conversions |
| 1.4.0 | Jan 2026 | Complex nested mapping, circular reference handling, performance diagnostics, generic collection interfaces, interface-to-concrete mapping, dictionary mapping, .NET Standard compatibility | ✅ Fully backward compatible | Advanced mapping, type features, enhanced conversions |
| 2.1.0 | Mid 2026 | Pre-compiled mappings, reverse mapping, async transformations, async collection processing, LINQ expressions, projection support, detailed tracing | ❌ Contains breaking changes (new async methods in IMapper) | Next-gen features, async operations, data access integration |
Please see Release Roadmap for more details.
We welcome contributions! Please see our Contributing Guide for details.
- 🐛 Bug Reports - If you are having problems, please let me know by raising a new issue.
- 💡 Feature Requests - Start a discussion
- 📝 Documentation - Help improve our docs
- 💻 Code - Submit pull requests
This project is licensed with the MIT license.
Thank you for reading. Please fork, explore, contribute and report. Happy Coding !! :)