Expose more NUnitConsole arguments in NUnit3 for testing and tuning (#41)

* Expose more NUnitConsole arguments for testing and tuning
* Also add instructions for packing the project for local testing

+semver:minor

Author: jasonleenaylor

CHANGELOG.md

@@ -16,6 +16,15 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
+## [2.4.0] - 2021-01-22
+
+### Added
+
+- [SIL.BuildTasks] `Nunit3` task: Add `Process`, `Workers`, `Trace`, `Test`, `Agents`, and `Debug` properties for passing
+  on to the NUnit console runner for tuning and debugging
+
+- ReadMe.md Added windows instructions for building a package for local testing
+
 ## [2.3.4] - 2020-10-05
 
 ### Fixed
@@ -126,4 +135,4 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ### Added
 
-- First release as NuGet package
+- First release as NuGet package

Documentation/SIL.BuildTasks.md

@@ -161,13 +161,27 @@ Runs NUnit3 on a test assembly.
 
 See properties for NUnit task. The following additional properties are defined:
 
-- `UseNUnit3Xml`: Whether to use the NUnit3 or NUnit2 XML format
-
 - `NoColor`: Determines the use of colors in the output
 
+- `UseNUnit3Xml`: Whether to use the NUnit3 or NUnit2 XML format
+
 - `TeamCity`: Should be set to true if the tests are running on a TeamCity server.
   Adds `--teamcity` when calling nunit which _"Turns on use of TeamCity service messages."_
 
+- `Agent`: The number of NUnit agents to use when running the tests
+
+- `Workers`: Specify the NUMBER of worker threads to be used in running tests
+
+- `Process`: PROCESS isolation for test assemblies. Values: Single, Separate, Multiple
+
+- `DisposeRunners`: When true Dispose each test runner after it has finished running its tests
+
+- `Debug`: Causes NUnit to break into the debugger immediately before it executes your tests
+
+- `Test`: Comma-separated list of FULLNAMES of tests to run or explore. This option may be repeated
+
+- `Trace`: Set internal trace LEVEL. Values: Off, Error, Warning, Info, Verbose (Debug)
+
 ### Example
 
 See NUnit task.

Readme.md

@@ -44,3 +44,9 @@ Run tests:
 ```bash
 msbuild build/SIL.BuildTasks.proj
 ```
+
+### Building a local package of SIL.BuildTasks for testing (Windows)
+
+1. Run the Pack build command from inside Visual Studio on the SIL.ReleaseTasks.Dogfood project
+2. Run the Pack build command from inside Visual Studio on the SIL.BuildTasks project
+3. Install the package from the output folder into your local Nuget source e.g.`nuget.exe add output/Debug/SIL.BuildTasks.2.3.5-beta.1.nupkg -Source /c/Repositories/DevelopmentPackages/`

SIL.BuildTasks/UnitTestTasks/NUnit3.cs

@@ -51,6 +51,28 @@ public bool TeamCity
 			}
 		}
 
+		public string Test { get; set; }
+
+		public string Trace { get; set; }
+
+		public int Agents { get; set; }
+
+		public int Workers { get; set; }
+
+		public bool DisposeRunners { get; set; }
+
+		/// <summary>
+		/// When set to true it will offer the opportunity to attach a debugger before starting the unit tests
+		/// </summary>
+		public bool Debug { get; set; }
+
+		/// <summary>
+		/// PROCESS isolation for test assemblies. Values: Single, Separate, Multiple.
+		/// If not specified, defaults to Separate for a single assembly or Multiple for more than one.
+		/// By default, processes are run in parallel
+		/// </summary>
+		public string Process { get; set; }
+
 		/// <inheritdoc />
 		/// <summary>
 		/// Gets the name (without path) of the NUnit executable. When running on Mono this is
@@ -77,6 +99,20 @@ protected override string AddAdditionalProgramArguments()
 				bldr.Append(" --x86");
 			if (TeamCity)
 				bldr.Append(" --teamcity");
+			if (!string.IsNullOrEmpty(Trace))
+				bldr.AppendFormat(" --trace={0}", Trace);
+			if (!string.IsNullOrEmpty(Test))
+				bldr.AppendFormat(" --test={0}", Test);
+			if (DisposeRunners)
+				bldr.Append(" --dispose-runners");
+			if (Debug)
+				bldr.Append(" --debug");
+			if (!string.IsNullOrEmpty(Process))
+				bldr.AppendFormat(" --process={0}", Process);
+			if (Workers > 0)
+				bldr.AppendFormat(" --workers={0}", Workers);
+			if (Agents > 0)
+				bldr.AppendFormat(" --agents={0}", Agents);
 			return bldr.ToString();
 		}