docs/articles/nunit-analyzers/NUnit1009.md
| Topic | Value |
|---|---|
| Id | NUnit1009 |
| Severity | Error |
| Enabled | True |
| Category | Structure |
| Code | ParallelizableUsageAnalyzer |
One may not specify ParallelScope.Children on a non-parameterized test method.
To prevent tests that will fail at runtime due to improper construction.
[Parallelizable(ParallelScope.Children)]
[Test]
public void NUnit1009SampleTest()
{
Assert.Pass();
}
In the sample above, the Parallelizable attribute is used with ParallelScope.Children.
However, in a non-parameterized test, such as a [Test] and not a [TestCase], there will be no children generated,
and thus this type of parallelization does not make sense.
Remove the attribute:
[Test]
public void NUnit1009SampleTest()
{
Assert.Pass();
}
Or, turn the test into one that will have children generated, such as a TestCase:
[Parallelizable(ParallelScope.Children)] // These will now run in parallel
[TestCase(1)]
[TestCase(2)]
public void NUnit1009SampleTest(int numberValue)
{
Assert.That(numberValue, Is.GreaterThan(0));
}
Configure the severity per project, for more info see MSDN.
# NUnit1009: One may not specify ParallelScope.Children on a non-parameterized test method
dotnet_diagnostic.NUnit1009.severity = chosenSeverity
where chosenSeverity can be one of none, silent, suggestion, warning, or error.
#pragma warning disable NUnit1009 // One may not specify ParallelScope.Children on a non-parameterized test method
Code violating the rule here
#pragma warning restore NUnit1009 // One may not specify ParallelScope.Children on a non-parameterized test method
Or put this at the top of the file to disable all instances.
#pragma warning disable NUnit1009 // One may not specify ParallelScope.Children on a non-parameterized test method
[SuppressMessage][System.Diagnostics.CodeAnalysis.SuppressMessage("Structure",
"NUnit1009:One may not specify ParallelScope.Children on a non-parameterized test method",
Justification = "Reason...")]