unity-technologies / unitytestrunnerresultsreporter

Unity Test Runner Results Reporter

The Unity Test Runner Results Reporter is a .NET Core assembly that, when invoked with the correct parameters, parses test results from Unity Test Runner results .xml file formate (e.g. Unity.exe -runTests ...) and generates an html report.

In order to invoke the test results reporter, you'll need to ensure you've downloaded the latest .NET Core SDK.

Usage

--resultsPath=<Path to a directory where test result XML file and Unity log file can be find>

[--resultXMLName="Name of the test result XML file, reporter will look for TestResults.xml if no value"]

[--unityLogName="Name of the unity log file, reporter will look for UnityLog.txt if no value"]

[--reportdirpath="Path to where the report will be written"]

Example 1:

// Run Unity Test Runner tests with default result file names

Unity.exe -projectPath G:\MyUnityTest -logFile G:\MyUnityTest\Results\UnityLog.txt -testPlatform Android -testResults G:\MyUnityTest\Results\TestResults.xml -buildTarget Android -runTests

// Run reporter for test results

dotnet UnityTestRunnerResultsReporter.dll --resultsPath=G:\MyUnityTest\Results

Example 2:

// Run Unity Test Runner tests with customized result file names

Unity.exe -projectPath G:\MyUnityTest -logFile G:\MyUnityTest\Results\myLog.txt -testPlatform Android -testResults G:\MyUnityTest\Results\results.xml -buildTarget Android -runTests

// Run reporter for test results

dotnet UnityTestRunnerResultsReporter.dll --resultsPath=G:\MyUnityTest\Results --resultXMLName=results.xml --unityLogName=myLog.txt

Options:

-?, --help, -h Prints out the options.

--resultsPath=VALUE // REQUIRED - Path to a directory where test result XML file and Unity log file can be find.

--resultXMLName, --XMLName[=VALUE] // OPTIONAL - Name of test result XML file name.

--unityLogName, --LogName[=VALUE] // OPTIONAL - Name of Unity log file name.

--report, --reportdirpath[=VALUE] // OPTIONAL - Path to where the report will be

unitytestrunnerresultsreporter's Issues

UnityTestRunnerResultsReporter.dll not found?

C:\Users\KyleLeighton\.dotnet\tools\UnityTestRunnerResultsReporter>dotnet UnityTestRunnerResultsReporter.dll --resultsPath=C:\TestRunner
Could not execute because the specified command or file was not found.
Possible reasons for this include:
  * You misspelled a built-in dotnet command.
  * You intended to execute a .NET program, but dotnet-UnityTestRunnerResultsReporter.dll does not exist.
  * You intended to run a global tool, but a dotnet-prefixed executable with this name could not be found on the PATH.

I've searched the repo and this file does not exist anywhere, yet that is what we are calling in the dotnet command. Am I missing something here? I'm running on dotnet-sdk-6.0.101-win-x64

License?

Can you please attach license file? Due to github rules, repo without licence is read-only.
Is it MIT or something else?

Parsing Error

Convert.ToDouble() throws an error if the machine default culture is not en-US

Fixed with :
System.Threading.Thread.CurrentThread.CurrentCulture = CultureInfo.GetCultureInfo("en-US");

Please add an example HTML report to the readme

Could be very useful to see a real example of what this HTML report would look like