Added .EqualTo extension method to .ActionResult<TResult> assertion chain (closes #359)

Author: ivaylokenov

src/MyTested.AspNetCore.Mvc.Controllers.ActionResults/ActionResultOfTTestBuilderExtensions.cs

@@ -0,0 +1,36 @@
+namespace MyTested.AspNetCore.Mvc
+{
+    using Builders.ActionResults.ActionResult;
+    using Builders.Contracts.ActionResults.ActionResult;
+    using Utilities.Validators;
+
+    /// <summary>
+    /// Contains extension methods for <see cref="IActionResultOfTTestBuilder{TResult}"/>.
+    /// </summary>
+    public static class ActionResultOfTTestBuilderExtensions
+    {
+        /// <summary>
+        /// Tests whether the <see cref="Microsoft.AspNetCore.Mvc.ActionResult{TResult}"/>
+        /// has a result deeply equal to the provided one.
+        /// </summary>
+        /// <typeparam name="TResult">Type of the expected result.</typeparam>
+        /// <param name="actionResultTestBuilder">
+        /// Instance of <see cref="IActionResultOfTTestBuilder{TResult}"/> type.
+        /// </param>
+        /// <param name="result">Expected result object.</param>
+        /// <returns>The same <see cref="IAndActionResultOfTTestBuilder{TResult}"/>.</returns>
+        public static IAndActionResultOfTTestBuilder<TResult> EqualTo<TResult>(
+            this IActionResultOfTTestBuilder<TResult> actionResultTestBuilder,
+            TResult result)
+        {
+            var actualBuilder = (ActionResultOfTTestBuilder<TResult>)actionResultTestBuilder;
+
+            InvocationResultValidator.ValidateInvocationResult(
+                actualBuilder.TestContext,
+                result,
+                canBeAssignable: true);
+
+            return actualBuilder;
+        }
+    }
+}

test/MyTested.AspNetCore.Mvc.Controllers.ActionResults.Test/BuildersTests/ActionResultsTests/ActionResultTests/ActionResultOfTTestBuilderTests.cs

@@ -0,0 +1,46 @@
+namespace MyTested.AspNetCore.Mvc.Test.BuildersTests.ActionResultsTests.ActionResultTests
+{
+    using Exceptions;
+    using Setups;
+    using Setups.Controllers;
+    using Setups.Models;
+    using Xunit;
+
+    public class ActionResultOfTTestBuilderTests
+    {
+        [Fact]
+        public void ShouldReturnActionResultOfTWithDetailsShouldNotThrowExceptionWithEqualResult()
+        {
+            MyController<MvcController>
+                .Instance()
+                .Calling(c => c.ActionResultOfT(1))
+                .ShouldReturn()
+                .ActionResult<ResponseModel>(result => result
+                    .EqualTo(new ResponseModel
+                    {
+                        IntegerValue = 1,
+                        StringValue = "Test"
+                    }));
+        }
+
+        [Fact]
+        public void ShouldReturnActionResultOfTWithDetailsShouldThrowExceptionWithIncorrectResult()
+        {
+            Test.AssertException<ResponseModelAssertionException>(
+                () =>
+                {
+                    MyController<MvcController>
+                        .Instance()
+                        .Calling(c => c.ActionResultOfT(1))
+                        .ShouldReturn()
+                        .ActionResult<ResponseModel>(result => result
+                            .EqualTo(new ResponseModel
+                            {
+                                IntegerValue = 2,
+                                StringValue = "Test"
+                            }));
+                },
+                "When calling ActionResultOfT action in MvcController expected the response model to be the given model, but in fact it was a different one. Difference occurs at 'ResponseModel.IntegerValue'. Expected a value of '2', but in fact it was '1'.");
+        }
+    }
+}