Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions docs/articles/nunit/writing-tests/attributes/explicit.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,17 @@ included, the test is a non-explicit testrun, and all explicit tests will be ign
can be empty, or even have a false Assume statement, which will make the test be inconclusive, thus not part of your
results."*

## TRICK

If you want to ensure NO Explicit tests are being run, e.g. a CI build, you can change the ExplicitMode to None.
You can do this either in a .runsettings file, or as a command line parameter

```cmd
dotnet test -- NUnit.ExplicitMode=None
```

(From version 5.2.0)

## Test Fixture Syntax

C#:
Expand Down
2 changes: 2 additions & 0 deletions docs/articles/vs-test-adapter/Adapter-Engine-Compatibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ post.

| Adapter version | Embedded engine version |
| --------------- | ----------------------- |
| 5.2.0 | 3.18.1 |
| 5.1.0 | 3.18.1 |
| 5.0.0 | 3.18.1 |
| 4.6.0 | 3.18.1 |
| 4.5.0 | 3.15.4 |
Expand Down
2 changes: 1 addition & 1 deletion docs/articles/vs-test-adapter/Adapter-License.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## MIT License

Copyright (c) 2011-2021 Charlie Poole, 2014-2023 Terje Sandstrom
Copyright (c) 2011-2021 Charlie Poole, 2014-2025 Terje Sandstrom

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
44 changes: 44 additions & 0 deletions docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,50 @@ uid: adapterreleasenotes

# Adapter Release Notes

## NUnit3 Test Adapter for Visual Studio and Dotnet - Version 5.2.0 - October 6, 2025

There are 2 issues fixed in this release.

In addition, the MTP version have been updated to 1.9.0.

### Enhancements

* [1111](https://github.com/nunit/nunit3-vs-adapter/issues/1111) New Mode that completely excludes explicit tests. Thanks to NUnit Team member [Terje Sandstrom](https://github.com/OsirisTerje) for [PR 1323](https://github.com/nunit/nunit3-vs-adapter/pull/1323)

### Bug fixes

* [1292](https://github.com/nunit/nunit3-vs-adapter/issues/1292) (Apparently) inconsistent version requirements of Microsoft.Testing.Extensions.VSTestBridge and Microsoft.Testing.Platform.MSBuild. Thanks to NUnit Team member [Terje Sandstrom](https://github.com/OsirisTerje) for [PR 1296](https://github.com/nunit/nunit3-vs-adapter/pull/1296)

### Acknowledgements

We want to express our heartfelt gratitude to everyone who has contributed to this release
by reporting bugs, suggesting enhancements, and providing valuable feedback.
Your efforts help make NUnit better for the entire community.

A special thank you to the following reporters for identifying issues:

<table>
<tr>
<td><a href="https://github.com/dmurty">dmurty</a></td>
<td><a href="https://github.com/lennartb-">Lennart Brggemann</a></td>
<td><a href="https://github.com/OsirisTerje">Terje Sandstrom</a></td>
</tr>
</table>

and to the commenters who engaged in discussions and offered further insights:

<table>
<tr>
<td><a href="https://github.com/dmurty">dmurty</a></td>
<td><a href="https://github.com/manfred-brands">Manfred Brands</a></td>
<td><a href="https://github.com/moh-hassan">Mohamed Hassan</a></td>
<td><a href="https://github.com/OsirisTerje">Terje Sandstrom</a></td>
</tr>
<tr>
<td><a href="https://github.com/Youssef1313">Youssef Victor</a></td>
</tr>
</table>

## NUnit3 Test Adapter for Visual Studio and Dotnet - Version 5.1.0 - August 6, 2025

There are 10 issues fixed in this release.
Expand Down
8 changes: 6 additions & 2 deletions docs/articles/vs-test-adapter/Tips-And-Tricks.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Certain NUnit Test Adapter settings are configurable using a .runsettings file.
| [NewOutputXmlFileForEachRun](#newoutputxmlfileforeachrun) | bool | Creates a new file for each test run | false |
| [IncludeStackTraceForSuites](#includestacktraceforsuites) | bool | Includes stack trace for failures in suites, like exceptions in OneTimeSetup and OneTimeTearDown | true |
| [IncludeStackTrace](#includestacktrace) | bool | Includes stack trace for all failures | true |
| [ExplicitMode](#explicitmode) | enum | Changes handling of explicit tests, options are `Strict` or `Relaxed` | Strict |
| [ExplicitMode](#explicitmode) | enum | Changes handling of explicit tests, options are `Strict`, `Relaxed` or `None` | Strict |
| [SkipExecutionWhenNoTests](#skipexecutionwhennotests) | bool | Skip execution if no tests are found | false |
| [AllowParallelWithDebugger](#allowparallelwithdebugger) | bool | Allow parallel execution when debugger is attached | false |
| [ThrowOnEachFailureUnderDebugger](#throwoneachfailureunderdebugger) | bool | | false |
Expand Down Expand Up @@ -364,7 +364,7 @@ This is default true. If turned off (false) it will stop outputting any stacktr

#### ExplicitMode

This setting can be either ```Strict``` or ```Relaxed```. The default is ```Strict```, which means that ```Explicit```
This setting can be either ```Strict```, ```Relaxed``` or ```None```. The default is ```Strict```, which means that ```Explicit```
tests can only be run with other Explicit tests, and not mixed with non-Explicit tests. The ```Relaxed``` mode is the
original NUnit mode, where if you select a category, a class or a set of tests, both explicit and non-explicit tests
will be run. From Visual Studio Test Explorer there are no longer (since VS2019) any way of separating between a
Expand All @@ -373,6 +373,10 @@ line tests, dependent upon how your tests are set up and run.

(From version 4.2.0)

When using `None`, no explicit tests will be run at all. This can be useful for CI scenarios.

(From version 5.2.0)

#### SkipExecutionWhenNoTests

If set, this setting will skip execution for an assembly if no tests are found during the pre-execution discovery phase.
Expand Down
Loading