SparkyTestHelpers.Mapping 1.0.0

see also:

• SparkyTestHelpers.AutoMapper: Additional SparkyTestHelpers.Mapping extension methods for AutoMapper
• SparkyTestHelpers: exception expectation and "scenario test" (row test) helpers
• SparkyTestHelpers.Moq: syntax helpers for testing with Moq

MapTester<TSource, TDestination>

class SparkyTestHelpers.Mapping.MapTester<TSource, TDestination>

This class is for testing that properties were successfully "mapped" from one type to another.

Methods

• MapTester<TSource, TDestination> WithLogging ([Action<String> action])
  • (optional) log property values when asserting. If called without an action, defaults to Console.WriteLine.
• MapTester<TSource, TDestination> IgnoringMember (Expression<Func<TDestination, Object>> destExpression)
• MapMemberTester<TSource, TDestination> WhereMember (Expression<Func<TDestination, Object>> destExpression)
• void AssertMappedValues (TSource source, TDestination dest)

Static Methods

• MapTester<TSource, TDestination> ForMap ()

Example

using SparkyTestHelpers.Mapping;

    Foo foo = CreateAndPopulateTestFoo();
    Bar bar = Mapper.Map<Foo, Bar>(foo); 

    MapTester.ForMap<Foo, Bar>()
        .WithLogging()
        .IgnoringMember(dest => dest.DestOnlyProperty)
        .WhereMember(dest => dest.StatusCode).ShouldEqual(src => src.Status)
        .WhereMember(dest => dest.IsValid).ShouldEqualValue(true)
        .WhereMember(dest => dest.Percent).IsTestedBy((src, dest) => 
            Assert.AreEqual(src.Rate / 100, dest.Percent))
        .AssertMappedValues(foo, bar);

As with AutoMapper, you don't have to configure anything for properties with the same name/type in the source and destination instances. AssertMappedValues considers those successful if the source/destination values matter.

Use IgnoringMember for destination properties that are not mapped or which you need to test in another way.

Use WhereMember to "dot" to the ShouldEqual, ShouldEqualValue and IsTestedBy functions.

MapMemberTester<TSource, TDestination>

class SparkyTestHelpers.Mapping.MapMemberTester<TSource, TDestination>

This class is for testing that a property was successfully "mapped" from one type to another.

Methods

• MapTester<TSource, TDestination> ShouldEqual (Expression<Func<TSource, Object>> sourceExpression)
  • use to verify destination property mapped from differently named source property(s)
• MapTester<TSource, TDestination> ShouldEqualValue (Object value)
  • use to verify destination property using a constant or some other value not derived from the source
• MapTester<TSource, TDestination> IsTestedBy (Action<TSource, TDestination> customTest)
  • use for custom complex validation that doesn't fit one of the other verification methods

RandomValuesHelper

class SparkyTestHelpers.Mapping.RandomValuesHelper

Test helper for updating class instance properties with random values (so you can fill a "source" instance without writing a lot of code).

Methods

• T CreateInstanceWithRandomValues ()
• T UpdatePropertiesWithRandomValues (T instance)

Example

using SparkyTestHelpers.Mapping;

    Foo foo = new RandomValuesHelper().CreateInstanceWithRandomValues<Foo>();

    var bar = new Bar();
    new RandomValuesHelper().UpdatePropertiesWithRandomValues(bar);