KonverterMap 1.1.1

KonverterMap

KonverterMap is a lightweight, convention-based object-to-object mapper for .NET.
It was built as a free and open-source alternative to AutoMapper — offering flexibility, simplicity, and performance for mapping between models and DTOs.

🔗 Full documentation: KonverterMap Docs (English)

✨ Features

• ✅ Simple object-to-object mapping
• 🛠️ Custom property mapping with .ForMember(...)
• 🚫 Ignore properties with .Ignore(...)
• 📌 Conditional mapping with .When(...)
• 🔁 Reversible maps with .ReverseMap()
• 🔄 Lifecycle hooks: .BeforeMap(...) and .AfterMap(...)
• 🔃 Recursive mapping support via MapFrom(...)
• ⚡ Supports implicit mapping (no config required)
• 🧪 .NET 8 & .NET Framework compatible
• 🧱 No dependencies. 100% native C#

⚡ Quick Example

Konverter.Instance.CreateMap<User, UserDto>()
    .ForMember(dest => dest.FullName, (src, map) => $"{src.FirstName} {src.LastName}")
    .Ignore(dest => dest.Password)
    .ReverseMap();

var user = new User { FirstName = "Fábio", LastName = "Oliveira", Password = "secret" };
var dto = Konverter.Instance.Map<User, UserDto>(user);

🧠 Advanced Usage

Konverter.Instance.CreateMap<Customer, CustomerDto>()
    .ForMember(dest => dest.TotalOrders, (src, map) => src.Orders.Count)
    .When(dest => dest.Name, src => !string.IsNullOrWhiteSpace(src.Name))
    .BeforeMap((src, dest) => { if (src.Region == null) src.Region = "SP"; })
    .AfterMap((src, dest) => dest.LoyaltyPoints += 10)
    .ReverseMap();

🧩 Implicit Mapping

KonverterMap supports implicit mapping without prior configuration:

var dto = Konverter.Instance.Map<User, UserDto>(user);
// Works if properties match by name and type

See Implicit Mapping for details.

📦 Installation

Add via NuGet:

dotnet add package KonverterMap

Or search for KonverterMap on NuGet.org

✅ Compatibility

• .NET 6, .NET 7, .NET 8
• .NET Framework 4.6.1+

📚 Documentation

All usage examples and advanced features are fully documented at:

📘 https://ols-tecnologia.github.io/KonverterMap/

🤝 Contributing

Contributions, issues and suggestions are welcome!

1. Fork the project
2. Create your branch
3. Submit a pull request

🪪 License

Licensed under the MIT License.

Made with 💙 by Fábio Oliveira and OLS Tecnologia