Added ShouldReturn/ShouldReturnActionResult (#359)

Author: ivaylokenov

src/MyTested.AspNetCore.Mvc.Controllers/Builders/Actions/ShouldReturn/ShouldReturnActionResult.cs

@@ -0,0 +1,30 @@
+namespace MyTested.AspNetCore.Mvc.Builders.Actions.ShouldReturn
+{
+    using Contracts.Actions;
+    using Contracts.And;
+    using Internal.TestContexts;
+
+    /// <summary>
+    /// Used for testing returned <see cref="Microsoft.AspNetCore.Mvc.ActionResult"/>.
+    /// </summary>
+    /// <typeparam name="TActionResult">Result from invoked action in ASP.NET Core MVC controller.</typeparam>
+    public class ShouldReturnActionResultTestBuilder<TActionResult>
+        : ShouldReturnTestBuilder<TActionResult>, IShouldReturnActionResultTestBuilder<TActionResult>
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ShouldReturnActionResultTestBuilder{TActionResult}"/> class.
+        /// </summary>
+        /// <param name="testContext"><see cref="ControllerTestContext"/> containing data about the currently executed assertion chain.</param>
+        public ShouldReturnActionResultTestBuilder(ControllerTestContext testContext) 
+            : base(testContext)
+        {
+        }
+
+        /// <inheritdoc />
+        public new IAndTestBuilder ActionResult()
+        {
+            var result = base.ActionResult;
+            throw new System.NotImplementedException();
+        }
+    }
+}

src/MyTested.AspNetCore.Mvc.Controllers/Builders/Actions/ShouldReturn/ShouldReturnActionResultTestBuilder.cs

@@ -3,10 +3,19 @@
     using System;
     using And;
 
+    /// <summary>
+    /// Used for testing returned <see cref="Microsoft.AspNetCore.Mvc.ActionResult"/>.
+    /// </summary>
+    /// <typeparam name="TActionResult">Result from invoked action in ASP.NET Core MVC controller.</typeparam>
     public interface IShouldReturnActionResultTestBuilder<TActionResult>
         : IShouldReturnTestBuilder<TActionResult>
     {
-        // IActionResult, ActionResult or ActionResult<T>
+        /// <summary>
+        /// Tests whether the action result is <see cref="Microsoft.AspNetCore.Mvc.IActionResult"/>,
+        /// <see cref="Microsoft.AspNetCore.Mvc.ActionResult"/> or
+        /// <see cref="Microsoft.AspNetCore.Mvc.ActionResult{TResult}"/>.
+        /// </summary>
+        /// <returns>Test builder of <see cref="IAndTestBuilder"/> type.</returns>
         IAndTestBuilder ActionResult();
 
         //// IActionResult, ActionResult or ActionResult<T> with options to specify the result - Ok() for example

src/MyTested.AspNetCore.Mvc.Controllers/Builders/Contracts/Actions/IShouldReturnActionResultTestBuilder.cs

@@ -26,21 +26,6 @@
     public interface IShouldReturnTestBuilder<TActionResult> 
         : IBaseShouldReturnTestBuilder<TActionResult, IAndTestBuilder>
     {
-        // IActionResult, ActionResult or ActionResult<T>
-        IAndTestBuilder ActionResult();
-
-        // IActionResult, ActionResult or ActionResult<T> with options to specify the result - Ok() for example
-        IAndTestBuilder ActionResult(Action<IShouldReturnTestBuilder<TActionResult>> actionResultTestBuilder);
-
-        //// ActionResult<TResult>, consider OkResult for example to be valid too? 
-        //IAndTestBuilder ActionResult<TResult>();
-
-        //// ActionResult<TResult>, consider OkResult for example to be valid too? with additional options to specify the result - Ok() for example
-        //IAndTestBuilder ActionResult<TResult>(Action<IShouldReturnTestBuilder<TActionResult>> actionResultTestBuilder);
-        
-        //// ActionResult<TResult>, consider OkResult for example to be valid too?!, with additional options to validate the TResult, like EqualTo or Passing (model/result details)
-        //IAndTestBuilder ActionResult<TResult>(Action<IShouldHaveTestBuilder<TActionResult>> actionResultTestBuilder);
-
         /// <summary>
         /// Tests whether the action result is <see cref="Microsoft.AspNetCore.Mvc.AcceptedResult"/>,
         /// <see cref="Microsoft.AspNetCore.Mvc.AcceptedAtActionResult"/> or