Arebis.ReMapper 0.8.3

Arebis ReMapper

This nuget is a C# Source Generator generating source code consisting of:

• Contract types or Data Transfer Object types.
• Mapper code to convert domain objects into contract objects.
• Reverse mapper code to convert contract objects back into domain objects.

Getting Started

1. Install the Arebis.ReMapper nuget on the project where you want to generate contract types and/or mapper types. You can install the nuget on different projects.
2. Create a ReMapper.xml file (the name does not matter, as long as it has a .xml extension).
3. Set the Build Action property of the ReMapper.xml file to C# analyzer additional file.
4. Write your mapping definition in the file.

Here is an example of a ReMapper.xml file:

<?xml version="1.0" encoding="utf-8" ?>
<ReMapper>
	<Namespace Name=".Models" For="Example.WebShop.Domain">
		<Using CopyAttributes="true">System.ComponentModel.DataAnnotations</Using>
		<Types>
			<Documentation/>
		</Types>
		<Mapper/>
		<ReverseMapper CreateMethod="new" Conservative="true" />
		<Type Name="CustomerModel" For="Customer" ReverseMap="CU">
			<Property Name="Id" IsKey="true" />
			<Property Name="Name" />
			<Property Name="Address" />
		</Type>
		<Type Name="InvoiceModel" For="Invoice" ReverseMap="CU">
			<Property Name="Id" IsKey="true" />
			<Property Name="Date" />
			<Property Name="Customer" Type="CustomerModel" />
		</Type>
	</Namespace>
</ReMapper>

The Arebis.ReMapper.X.Y.Z.nupkg file contains a ReMapper.xsd file to help you defining the mappings. However you will have to manually extract the .xsd file as it is not installed in your project by default.

To generate persistent code files, add the following line to your .csproj file:

<EmitCompilerGeneratedFiles>True</EmitCompilerGeneratedFiles>

For more about Source Generators in general, see: https://learn.microsoft.com/en-us/dotnet/csharp/roslyn-sdk/source-generators-overview