Mappa 1.0.0

Mappa

This package contains all the attributes that can be used to drive the behaviour of the Mappa source generator. This is the list of attributes provided:

• Mappa: Identify partial classes that are meant to be source generated by Mappa source generator;
• MappaIgnore: Identify methods that should not be used for the mapping;
• MappaDependency: Identify a property or a field inside a mapper class that can be used when identifying suitable mapping between two types;
• MappaSettings: Allows to specify the behaviour while mapping sometimes (e.g. it allows to specify culture when mapping strings into System.DateTime and to specify the format when mapping strings into System.Guid);
• MappaUseProperty: When mapping structured types (class, struct and records) allows to specify which property use from the source property for a target property or constructor parameter;
• MappaAssignFromContext: When mapping structured types (class, struct and records) allows to specify which value from the context of type MappaContext use for a target property or constructor parameter;
• MappaInvokeMethodAttribute: When mapping structured types (class, struct and records) allows to specify that a property or attribute should be mapped by invoking a method.

This package also provide the MappaContext class that can be used to pass contextual values to mappers via the MappaAssignFromContext attribute.

Via MappaSettings the following settings can be identified:

• DateTimeFormat: the format to use to map strings into System.DateTime and vice versa;
• DateTimeOffsetFormat: the format to use to map strings into System.DateTimeOffset and vice versa;
• DateOnlyFormat: the format to use to map strings into System.DateOnly and vice versa;
• TimeOnlyFormat: the format to use to map strings into System.TimeOnly and vice versa;
• TimeSpanFormat: the format to use to map strings into System.TimeSpan and vice versa;
• GuidFormat: the format to use to map strings into System.Guid and vice versa;
• CultureInfoSetting: define which culture use when mapping any of the above types (can be current culture, invariant culture or user defined culture);
• CultureName: define the culture to use then user defined culture is selected by CultureInfoSetting;
• ProtobufOptional: enable or disable the ability of Mappa source generator to handle optional fields in protobuf models.

Relevant packages:

• Mappa source generator: source generator that allows to automatically generate mapping between classes and value types;
• Mappa Protobuf: methods to map Google.Protobuf.WellKnownTypes objects from Google.Protobuf package into common objects.
• Mappa Protobuf dependency: utility methods to register the Protobuf mapper.
• Mappa Bson: methods to map MongoDB.Bson objects from MongoDB.Bson package into common objects.
• Mappa Bson dependency: utility methods to register the Bson mapper.

You can find samples here. Visit the Mappa documentation to learn more.