Merge pull request #362 - Versioning plugin

Versioning plugin

Author: ivaylokenov

BACKERS.md

@@ -25,8 +25,13 @@ Additionally, funds donated via [Patreon](https://www.patreon.com/ivaylokenov) (
     <tr>
       <td align="center" valign="middle">
           <a href="http://bit.ly/bellatrixsolutions" target="_blank">
-    <img width="323px" src="https://user-images.githubusercontent.com/3391906/68993273-d4f5c700-087e-11ea-9b39-e173733fcbfb.png" alt=""The Ultimate Cross-Platform .NET Framework>
-  </a>
+    <img width="323px" src="https://user-images.githubusercontent.com/3391906/68993273-d4f5c700-087e-11ea-9b39-e173733fcbfb.png" alt="The Ultimate Cross-Platform .NET Framework">
+          </a>
+      </td>
+      <td align="center" valign="middle">
+          <a href="https://www.jetbrains.com/?from=MyTestedASP.NET" target="_blank">
+    <img width="323px" src="https://user-images.githubusercontent.com/3391906/72542498-ee21f080-388c-11ea-92ac-0b0153028933.png" alt="JetBrains">
+          </a>
       </td>
     </tr>
   </tbody>
@@ -98,7 +103,7 @@ Additionally, funds donated via [Patreon](https://www.patreon.com/ivaylokenov) (
 Aleksandur Gyuzelov, Desislav Stoyanov, Emil Venkov, Georgi Krasimirov Georgiev, Kristiyan Mihailov, Lyubomir Krastanov, Nikolay Boyadzhiev, Nikolay Mihaylov, Rositsa Nenova, Slavi Bozhikov, Vasil Bonev, Yuriy Georgiev, Калин Ценков, Velina Getova
 
 ## One-Time Donations
-Stilgar Naibski, Ivomir Assi, Maria Georgieva, Tyler Austen, Stefan Minchev, Borislav Lazarov, Georgi Petrov, Yuliyana Tahova, Philip Shishov, Mariya Georgieva, Tanya Georgieva, Danny Berova, German Dimitrov, Aleksandar Evangelatov, Anton Petrov, Hristo Ivanov, Anna Stambolieva, Nedelcho Penev, Yulian Ashikov, Boyana Aleksova, Plamen Haralambiev, Victoria Karamanova, Ivaylo Goranov, Aneliya Drazheva, Zdravko Yakimov, Vanya Kuncheva, Georgi Petrov, Stanimir Pavlov, Teodor Stefanov, Stefan Minchev, Simon Valentinova Kochova, Marin Marinov, Petar Peshev, Radoslav Astardzhiev, Dimitar Radkov, Aleksandar Tsvetkov, Georgi Dragnev, Veselin Neychev, Kaloyan Kolev, Andrey Blagoev, Yordan Penev, Ventsislav Yordanov, Nikolay Georgiev, Siyana Yasenova Zdravkova, Ani Kalpachka, Gergana Damyanova, Petya Koleva, Dyanko Petkov, Nikola Kolchakov, Borislava Hranova
+Stilgar Naibski, Ivomir Assi, Maria Georgieva, Tyler Austen, Stefan Minchev, Borislav Lazarov, Yuliyana Tahova, Philip Shishov, Mariya Georgieva, Tanya Georgieva, Danny Berova, German Dimitrov, Aleksandar Evangelatov, Anton Petrov, Hristo Ivanov, Anna Stambolieva, Nedelcho Penev, Yulian Ashikov, Boyana Aleksova, Plamen Haralambiev, Victoria Karamanova, Ivaylo Goranov, Aneliya Drazheva, Zdravko Yakimov, Vanya Kuncheva, Georgi Petrov, Stanimir Pavlov, Teodor Stefanov, Stefan Minchev, Simon Valentinova Kochova, Marin Marinov, Petar Peshev, Radoslav Astardzhiev, Dimitar Radkov, Aleksandar Tsvetkov, Georgi Dragnev, Veselin Neychev, Kaloyan Kolev, Andrey Blagoev, Yordan Penev, Ventsislav Yordanov, Nikolay Georgiev, Siyana Yasenova Zdravkova, Ani Kalpachka, Gergana Damyanova, Petya Koleva, Dyanko Petkov, Nikola Kolchakov, Borislava Hranova
 
 ## Previous Supporters
 - Regina Uzunova

MyTested.AspNetCore.Mvc.sln

@@ -231,6 +231,10 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Test.MultipleEntryPoints",
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Common", "samples\Configuration\Common\Common.csproj", "{AC971EBF-48A1-47C1-B61F-CF97FCE4F48C}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MyTested.AspNetCore.Mvc.Versioning", "plugins\MyTested.AspNetCore.Mvc.Versioning\MyTested.AspNetCore.Mvc.Versioning.csproj", "{3529E0FC-4D63-4828-A3DC-ACE7B6243A73}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MyTested.AspNetCore.Mvc.Versioning.Test", "test\MyTested.AspNetCore.Mvc.Versioning.Test\MyTested.AspNetCore.Mvc.Versioning.Test.csproj", "{6541FC98-C8B1-48CF-A3A5-7028B19455E8}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -645,6 +649,14 @@ Global
 		{AC971EBF-48A1-47C1-B61F-CF97FCE4F48C}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{AC971EBF-48A1-47C1-B61F-CF97FCE4F48C}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{AC971EBF-48A1-47C1-B61F-CF97FCE4F48C}.Release|Any CPU.Build.0 = Release|Any CPU
+		{3529E0FC-4D63-4828-A3DC-ACE7B6243A73}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{3529E0FC-4D63-4828-A3DC-ACE7B6243A73}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{3529E0FC-4D63-4828-A3DC-ACE7B6243A73}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{3529E0FC-4D63-4828-A3DC-ACE7B6243A73}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6541FC98-C8B1-48CF-A3A5-7028B19455E8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6541FC98-C8B1-48CF-A3A5-7028B19455E8}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6541FC98-C8B1-48CF-A3A5-7028B19455E8}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6541FC98-C8B1-48CF-A3A5-7028B19455E8}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -760,6 +772,8 @@ Global
 		{25649D8E-C12B-492E-8778-9638B0C4B31C} = {7BEC9808-8650-4322-BCC6-1D7D91B53678}
 		{840C7C04-90CC-4F0F-BDF9-0D97D399BA3F} = {7BEC9808-8650-4322-BCC6-1D7D91B53678}
 		{AC971EBF-48A1-47C1-B61F-CF97FCE4F48C} = {7BEC9808-8650-4322-BCC6-1D7D91B53678}
+		{3529E0FC-4D63-4828-A3DC-ACE7B6243A73} = {EF386110-3D7B-4BDF-B403-8DC2AB8CF7BB}
+		{6541FC98-C8B1-48CF-A3A5-7028B19455E8} = {D140FA14-A6C2-4279-8A41-35BC55279DA8}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {99A2DEDD-5195-4EE6-A546-B1CA54C5539F}

README.md

@@ -7,8 +7,13 @@
     <tr>
       <td align="center" valign="middle">
           <a href="http://bit.ly/bellatrixsolutions" target="_blank">
-    <img width="323px" src="https://user-images.githubusercontent.com/3391906/68993273-d4f5c700-087e-11ea-9b39-e173733fcbfb.png" alt=""The Ultimate Cross-Platform .NET Framework>
-  </a>
+    <img width="323px" src="https://user-images.githubusercontent.com/3391906/68993273-d4f5c700-087e-11ea-9b39-e173733fcbfb.png" alt="The Ultimate Cross-Platform .NET Framework">
+          </a>
+      </td>
+      <td align="center" valign="middle">
+          <a href="https://www.jetbrains.com/?from=MyTestedASP.NET" target="_blank">
+    <img width="323px" src="https://user-images.githubusercontent.com/3391906/72542498-ee21f080-388c-11ea-92ac-0b0153028933.png" alt="JetBrains">
+          </a>
       </td>
     </tr>
   </tbody>
@@ -49,7 +54,7 @@
 
 *Windows:* [![Build status](https://ci.appveyor.com/api/projects/status/3xlag3a7f87bg4on?svg=true)](https://ci.appveyor.com/project/ivaylokenov/mytested-aspnetcore-mvc)
 
-*Ubuntu & Mac OS:* [![Build Status](https://travis-ci.org/ivaylokenov/MyTested.AspNetCore.Mvc.svg?branch=development)](https://travis-ci.org/ivaylokenov/MyTested.AspNetCore.Mvc) 
+*Ubuntu & Mac OS:* [![Build Status](https://travis-ci.org/ivaylokenov/MyTested.AspNetCore.Mvc.svg?branch=development)](https://travis-ci.com/ivaylokenov/MyTested.AspNetCore.Mvc) 
 
 *Downloads:* [![NuGet Badge](https://buildstats.info/nuget/MyTested.AspNetCore.Mvc)](https://www.nuget.org/packages/MyTested.AspNetCore.Mvc/)
 
@@ -103,39 +108,59 @@ Funds donated via both platforms are used for development and marketing purposes
 
 Additionally, funds donated via [Patreon](https://www.patreon.com/ivaylokenov) (see the stretch goals) give me the freedom to add more features to the free `Lite` edition of the library.
 
+## Main Features
+
+- **Built-in service mock resolver** - register your mocks once, use them everywhere.
+- **Full request setup** - excellent arrangement of fake request data.
+- **Detailed response assertions** - precise validation for all available result objects.
+- **Controller tests** - unit or integration tests for both MVC and API scenarios.
+- **View component tests** - validate your view logic as fast as possible.
+- **Route tests** - asserting route paths and model binding is as accessible as it can get.
+- **Pipeline tests** - from the web request to the returned response - the whole chain is validated.
+- **Simple and easy to learn fluent API** - takes no more than 20 minutes to learn the library.
+- **Strongly-typed assertions** - the fluent test chain is designed to be developer-friendly and helpful. 
+- **Friendly error messages** - failed tests throw exceptions with detailed error reports.
+- **Isolated test scope** - each test is run in isolated scope, making asynchronous execution more than welcome. 
+- **Built-in mocks** - in-memory database, authentication, authorization, session, caching, temp data, and more.
+
 ## Quick Start
 
+This quick start is for ASP.NET Core 3.1. For previous versions, check the [corresponding branches](https://github.com/ivaylokenov/MyTested.AspNetCore.Mvc/branches).
+
 To add **MyTested.AspNetCore.Mvc** to your solution, you must follow these simple steps:
 
 1. Create a test project.
 2. Reference your web application.
 3. Install **`MyTested.AspNetCore.Mvc.Universe`** (or just the [testing packages](#package-installation) you need) from [NuGet](https://www.nuget.org/packages/MyTested.AspNetCore.Mvc.Universe/).
-4. Open the test project's `.csproj` file.
-5. Change the project SDK to `Microsoft.NET.Sdk.Web`:
-
-```xml
-<Project Sdk="Microsoft.NET.Sdk.Web">
-```
-
-6. Add a package reference to the web framework - `Microsoft.AspNetCore.App`:
+4. Create a `testsettings.json` file at the root of the test project, set its `Copy to Output Directory` property to `Copy if newer`, and set your required application settings to fake ones:
 
-```xml
-<PackageReference Include="Microsoft.AspNetCore.App" />
+```json
+{
+  "ConnectionStrings": {
+    "DefaultConnection": "My Fake Connection String"
+  },
+  "AllowedHosts": "*"
+}
 ```
 
-7. Your test project's `.csproj` file should be similar to this one:
+5. Your test project's `.csproj` file should be similar to this one:
 
 ```xml
-<Project Sdk="Microsoft.NET.Sdk.Web"> <!-- Changed project SDK -->
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.2</TargetFramework>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.App" /> <!-- Reference to the web framework -->
-    <PackageReference Include="MyTested.AspNetCore.Mvc.Universe" Version="2.2.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.2.0" />
+    <None Update="testsettings.json">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
+  </ItemGroup>
+	
+  <ItemGroup>
+    <PackageReference Include="MyTested.AspNetCore.Mvc.Universe" Version="3.1.1" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.4.0" />
     <PackageReference Include="xunit" Version="2.4.1" /> <!-- Can be any testing framework --> 
     <PackageReference Include="xunit.runner.visualstudio" Version="2.4.1" />
   </ItemGroup>
@@ -147,7 +172,7 @@ To add **MyTested.AspNetCore.Mvc** to your solution, you must follow these simpl
 </Project>
 ```
 
-8. Create a `TestStartup` class at the root of the test project to register the dependency injection services, which will be used by all test cases in the assembly. A quick solution is to inherit from the web project's `Startup` class. By default **MyTested.AspNetCore.Mvc** replaces all ASP.NET Core services with ready to be used mocks. You only need to replace your own custom services with mocked ones by using the provided extension methods. 
+6. Create a `TestStartup` class at the root of the test project to register the dependency injection services, which will be used by all test cases in the assembly. A quick solution is to inherit from the web project's `Startup` class. By default **MyTested.AspNetCore.Mvc** replaces all ASP.NET Core services with ready to be used mocks. You only need to replace your own custom services with mocked ones by using the provided extension methods. 
 
 ```c#
 namespace MyApp.Tests
@@ -170,7 +195,7 @@ namespace MyApp.Tests
 }
 ```
 
-9. Create a test case by using the fluent API the library provides. You are given a static `MyMvc` class from which all assertions can be easily configured:
+7. Create a test case by using the fluent API the library provides. You are given a static `MyMvc` class from which all assertions can be easily configured:
 
 ```c#
 namespace MyApp.Tests.Controllers
@@ -183,12 +208,16 @@ namespace MyApp.Tests.Controllers
     public class HomeControllerShould
     {
         [Fact]
-        public void ReturnViewWhenCallingIndexAction()
+        public void ReturnOkWithCorrectModelWhenCallingAuthenticatedIndexAction()
             => MyMvc
-                .Controller<HomeController>()
+                .Controller<HomeController>(instance => instance
+                    .WithUser("TestUser")
+                    .WithData(MyTestData.GetData()))
                 .Calling(c => c.Index())
                 .ShouldReturn()
-                .Ok();
+                .Ok(result => result
+                    .WithModelOfType<List<MyResponseModel>>()
+                    .Passing(model => model.Count == 10));
     }
 }
 ```
@@ -330,7 +359,7 @@ MyController<MyMvcController>
 
 ### Route Tests
 
-A route test validates the web application's routing configuration:
+A route test validates the web application's routing configuration, without executing the defined filters:
 
 ```c#
 // Tests a route for correct controller, action, and resolved route values.
@@ -340,7 +369,7 @@ MyRouting
     .To<MyController>(c => c.Action(1));
 
 // Tests a route for correct controller, action, and resolved route values
-// with authenticated post request and submitted form.
+// with post request and submitted form.
 MyRouting
     .Configuration()
     .ShouldMap(request => request
@@ -350,9 +379,7 @@ MyRouting
         {
             Title = title,
             Content = content
-        })
-        .WithUser()
-        .WithAntiForgeryToken())
+        }))
     .To<MyController>(c => c.Action(new MyFormModel
     {
         Title = title,
@@ -362,14 +389,12 @@ MyRouting
     .ToValidModelState();
 
 // Tests a route for correct controller, action, and resolved route values
-// with authenticated post request and JSON body.
+// with post request and JSON body.
 MyRouting
     .Configuration()
     .ShouldMap(request => request
         .WithLocation("/My/Action/1")
         .WithMethod(HttpMethod.Post)
-        .WithUser()
-        .WithAntiForgeryToken()
         .WithJsonBody(new
         {
             Integer = 1,
@@ -384,11 +409,11 @@ MyRouting
     .ToValidModelState();
 ```
 
-*Note: route tests execute action filters.*
+*Note: route tests do not execute action filters.*
 
 ### Pipeline tests
 
-A pipeline test provides strongly-typed assertions for the MVC pipeline (from routing to action result):
+A pipeline test provides strongly-typed assertions for the MVC pipeline (from routing to action result, including the application filters):
 
 ```c#
 // Tests a route for correct route values, 
@@ -398,26 +423,33 @@ A pipeline test provides strongly-typed assertions for the MVC pipeline (from ro
 // while resolving services from the `TestStartup` class.
 MyMvc
     .Pipeline()
-    .ShouldMap("/My/Action/1")
+    .ShouldMap(request => request
+        .WithLocation("/My/Action/1")
+        .WithMethod(HttpMethod.Post)
+        .WithUser()
+        .WithAntiForgeryToken()
+        .WithJsonBody(new
+        {
+            Integer = 1,
+            String = "Text"
+        }))
     .To<MyController>(c => c.Action(1))
     .Which(controller => controller
-        .WithUser()
         .WithData(MyDataProvider.GetMyModels()))
     .ShouldReturn()
     .Redirect(redirect => redirect
         .To<AnotherController>(c => c.AnotherAction()));
 
 // Tests a route for correct route values, 
 // and validates whether the controller action 
-// with an authenticated user and the provided data
+// with the provided data
 // returns view result with a specific model,
 // while resolving services from the provided mocks.
 MyMvc
     .Pipeline()
     .ShouldMap("/My/Action/1")
     .To<MyController>(c => c.Action(1))
     .Which(controller => controller
-        .WithUser()
         .WithData(MyDataProvider.GetMyModels())
         .WithDependencies(
             serviceMock,
@@ -647,7 +679,7 @@ using MyTested.AspNetCore.Mvc;
 
 ## Versioning
 
-**MyTested.AspNetCore.Mvc** follows the ASP.NET Core MVC versions with which the testing framework is fully compatible. Specifically, the *major* and the *minor* versions will be incremented only when the MVC framework has a new official release. For example, version 2.2.\* of the testing framework is fully compatible with ASP.NET Core MVC 2.2.\*, version 1.1.\* is fully compatible with ASP.NET Core MVC 1.1.\*, version 1.0.15 is fully compatible with ASP.NET Core MVC 1.0.\*, and so on. 
+**MyTested.AspNetCore.Mvc** follows the ASP.NET Core MVC versions with which the testing framework is fully compatible. Specifically, the *major* and the *minor* versions will be incremented only when the MVC framework has a new official release. For example, version 3.1.\* of the testing framework is fully compatible with ASP.NET Core MVC 3.1.\*, version 2.2.\* is fully compatible with ASP.NET Core MVC 2.2.\*, version 1.0.15 is fully compatible with ASP.NET Core MVC 1.0.\*, and so on. 
 
 The public interface of **MyTested.AspNetCore.Mvc** will not have any breaking changes when the version increases (unless entirely necessary).
 

plugins/MyTested.AspNetCore.Mvc.NewtonsoftJson/MyTested.AspNetCore.Mvc.NewtonsoftJson.csproj

@@ -4,7 +4,7 @@
     <Description>My Tested ASP.NET Core MVC Newtonsoft JSON components.</Description>
     <Copyright>2015-2019 Ivaylo Kenov</Copyright>
     <AssemblyTitle>MyTested.AspNetCore.Mvc.NewtonsoftJson</AssemblyTitle>
-    <VersionPrefix>3.1.0</VersionPrefix>
+    <VersionPrefix>3.1.1</VersionPrefix>
     <Authors>Ivaylo Kenov</Authors>
     <TargetFramework>netcoreapp3.1</TargetFramework>
     <NoWarn>$(NoWarn);CS1591</NoWarn>
@@ -29,7 +29,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.0" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="3.1.1" />
   </ItemGroup>
 
   <ItemGroup>

plugins/MyTested.AspNetCore.Mvc.NewtonsoftJson/Properties/AssemblyInfo.cs

@@ -0,0 +1,5 @@
+using System.Reflection;
+using System.Runtime.InteropServices;
+
+[assembly: AssemblyProduct("MyTested.AspNetCore.Mvc.NewtonsoftJson")]
+[assembly: ComVisible(false)]