Purpose of NUnit Parser?

Neal Culiner

I have the NUnit runner working and tests are working.  I'm new to unit testing and we're using NUnit.  I hooked up the parser and it created a file, just not sure the purpose or what to do with it.  Is Bamboo supposed to display some nicely formatted test result somewhere?  Can someone please explain the value of the NUnit parser and how to use it?

Thank you.

Marcin Oles

Hi Neal,

The NUnit Runner (or basically any other test runner, like Mocha Test Runner or MSTest Runner) will execute tests. Running tests will produce report file(s) - the report format depends on testing framework, in NUnit case it should be an XML file. The Runner task afterwards will automatically gather test results, making it easy to browse test results in Bamboo.

However, you can execute tests in a custom way, not using the Runner task. For example, using a shell script - for any reasons you may have. Such execution will produce the report XML file with test results, however, it will not gather the results and will not make it browseable in Bamboo.

NUnit parser is a task that parses the XML results after tests were run (by *any* other method), and displays the test results in Bamboo. You could say it is the last phase of NUnit runner, it just skips the test execution part.

Having parsers and runners separate usually gives users more choice and more tools to use. If you do not need the parser (if the runner does all the work for you), just don't use it as it's not necessary (I'd even say it's not recommended, only use it in advanced use cases).

 

Task descriptions should also give you a hint what they do:

• NUnit Runner: Executes, parses and displays NUnit test results
• NUnit Parser: Parses and displays NUnit test results

(the execution of tests is skipped)

 

Cheers,
Marcin