Clone this wiki locally
The NCoverConsoleTask allows you to run code coverage analysis through NCover 3’s NCover Console app.
How to use the NCoverConsoleTask
Here is an example of how to use the NCoverConsoleTask to run code coverage analysis.
desc "Run a sample NCover Console code coverage" ncoverconsole :coverage do |ncc| ncc.command = "Tools/NCover-v3.2/NCover.Console.exe" ncc.output :xml => "CodeCoverage/test-coverage.xml" ncc.working_directory = "CodeCoverage/WorkingDir" nunit = NUnitTestRunner.new("Tools/NUnit-v2.5/nunit-console.exe") nunit.assemblies "CodeCoverage/assemblies/TestSolution.Tests.dll" nunit.options '/noshadow' ncc.testrunner = nunit end
NCoverConsole configuration and execution options
Set the location of the ncover.console executable. This can be an absolute or relative path, and should include the executable name.
Set the coverage output type and location. The valid options are
:xml - output xml coverage :html - output html coverage
To set the options, use a hash and specify the xml and/or html options, with a value of the file that you wish to produce. Any valid path, relative or absolute, should work. Be sure to provide the extension (.xml or .html) if you need it.
For example, if you wish to output both xml and html, you can do the following
ncc.output :xml => 'CodeCoverage/coverage.xml', :html => 'CodeCoverage/html/coverage.html'
If you do not provide an :xml output setting, a ‘coverage.xml’ file will be produced in the current folder.
If you do not provide an :html output setting, no html output report will be generated. If you only specify a folder and do not provide a specific file name for the html report, a ‘fullcoveragereport.html’ file will be generated.
You can set the working directory that NCover will use, with this option. This will help to ensure that files produced by the running tasks will be placed into the specified folder.
ncc.working_directory = "some/folder/to_work_in"
NCover does not run the coverage directly, but analyzes code that is being executed through a test runner. Test runners for NCoverConsole don’t need to inherit from a base class or implement a module. They only need to provide a ‘get_command_line’ method that returns a string. The string returned from this method will be passed directly into the command line for NCover.Console.
The only test runner available, at this time, is for NUnit. For more information, please see the nunittestrunner page.
If the test runner returns an error code, this is typically a signal that one or more tests failed. In this case, NCover.Console will also return an error code. When the NCoverConsoleTask sees an error code returned from NCover.Console, it will fail the build.
You can specify an array of assemblies to cover, here, using some basic regular expression syntax. Either append the list, or replace it entirely.
ncc.cover_assemblies( "MyProject.*", "MyOtherStuff.*" )
ncc.cover_assemblies "MyProject.*", "MyOtherStuff.*"
Both of these will produce the same list of included assemblies, to be covered.
For more information on how this works, see the NCover Include Assemblies documentation.
You can specify an array of assemblies to ignore in the coverage output, here, using some basic regular expression syntax. Either append the list, or replace it entirely.
ncc.exclude_assemblies( "ThirdParty.*", "AnotherProject.*" )
ncc.exclude_assemblies "ThirdParty.*", "AnotherProject.*"
Both of these will produce the same list of ignored assemblies.
Note: This feature is only available if you are using NCover Complete. If you are not using NCover Complete, don’t specify the exclude_assemblies list at all, and it will not be passed to NCover.Console.
For more information on how this works, see the NCover Exclude Assemblies documentation.
You can specify an array of attributes to ignore in the coverage analysis. Namespaces, Classes, and Methods with an attribute that matches one of the regular expressions will be excluded from coverage
(see NCover documentation Exclude Attributes)
ncc.exclude_attributes( "CoverageExcludeAttribute", "System.Runtime.CompilerServices.CompilerGeneratedAttribute", "XamlGeneratedNamespace.*" )
You can specify the types of coverage analysis that you want NCover.Console to perform.
ncc.coverage :Branch, :Symbol
ncc.coverage( :Branch, :Symbol )
The valid options are for coverage types are:
:Symbol, :Branch, :MethodVisits, :CyclomaticComplexity
For more information on how this works, see the NCover Coverage Metric documentation.
This task supports configuration via an external YAML file. For more information, see the yamlconfig page.
Command Line Options
This task supports additional command line options, including a
.parameters collection for passing in options that are not directly supported. For more information, see the commandline task options documentation.