From 6d5286d87eefb1fb6920d0e89bd7573a97e6dc05 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Fri, 7 Feb 2025 09:12:56 +0100 Subject: [PATCH 1/5] Release adapter V5 --- .../AdapterV4-Release-Notes.md | 17 +++++++++++++- .../NUnit-And-Microsoft-Test-Platform.md | 22 ++++++++++--------- 2 files changed, 28 insertions(+), 11 deletions(-) diff --git a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md index e2e8743cc..e47541d74 100644 --- a/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md +++ b/docs/articles/vs-test-adapter/AdapterV4-Release-Notes.md @@ -1,4 +1,19 @@ -# Adapter V4 Release Notes +# Adapter Release Notes + +## NUnit3 Test Adapter for Visual Studio and Dotnet - Version 5.0.0 - February 7, 2025 + +This major release introduce support for the new Microsoft Testing Platform. + +### Enhancements + +* [1152](https://github.com/nunit/nunit3-vs-adapter/issues/1152) Microsoft Testing Platform for NUnit + +See more information [here](https://docs.nunit.org/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.html) + +### Breaking changes + +Althought this is a major version, there is no direct breaking changes when using it without enabling the MTP. +Using it **with** MTP enabled will change some parts of how to use it, see the documentation for details. ## NUnit3 Test Adapter for Visual Studio and Dotnet - Version 4.6.0 - July 26, 2024 diff --git a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md index 014dd65e6..59afefbd6 100644 --- a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md +++ b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md @@ -30,18 +30,20 @@ In a property group (use the top-level one), add the following two properties: The first property, `EnableNUnitRunner`, enables the MTP. The second enables it to also run as an executable (but it doesn't prevent you from using it in Test Explorer or through `dotnet test`. -## Information on the Microsoft Test Platform +## Switching from VSTest to dotnet test -* [Microsoft Test Platform](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-intro?tabs=dotnetcli) -* [NUnit Samples](https://github.com/nunit/nunit3-vs-adapter.issues/tree/master/Issue1152) -* [Adapter issue for implementing MTP](https://github.com/nunit/nunit3-vs-adapter/issues/1152) +You can switch between `VSTest` and `dotnet test` using a property in your csproj (or Directory.Build.props): -## Known issues +```xml + true +``` -In the current (v5) version of the NUnit3TestAdapter, running single tests doesn't work. It will always run all tests. -See [Adapter Issue 1232](https://github.com/nunit/nunit3-vs-adapter/issues/1232). +See [this article](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-integration-dotnet-test#dotnet-test---microsofttestingplatform-mode) for more information. -This applies to both Test Explorer and `dotnet test`. +## Information on the Microsoft Test Platform -As a workaround for the latter, you can filter tests using MTP-specific commands -like `dotnet test -- --filter Name=Test1`. +* [Microsoft Test Platform](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-intro?tabs=dotnetcli) +* [Use Microsoft.Testing.Platform with dotnet test](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-integration-dotnet-test) +* [Microsoft Test Platform Architecture](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-architecture) +* [NUnit Samples](https://github.com/nunit/nunit3-vs-adapter.issues/tree/master/Issue1152) +* [Adapter issue for implementing MTP](https://github.com/nunit/nunit3-vs-adapter/issues/1152) From 3cb50bb510032289a4927b891e04414386f13b36 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Fri, 7 Feb 2025 14:42:28 +0000 Subject: [PATCH 2/5] fix line length --- .../vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md index 59afefbd6..1f0371ce2 100644 --- a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md +++ b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md @@ -38,7 +38,8 @@ You can switch between `VSTest` and `dotnet test` using a property in your cspro true ``` -See [this article](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-integration-dotnet-test#dotnet-test---microsofttestingplatform-mode) for more information. +See [this article](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-integration-dotnet-test#dotnet-test---microsofttestingplatform-mode) +for more information. ## Information on the Microsoft Test Platform From 89a89b028c3ded6294fa65b01aa19a0abd148522 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Fri, 7 Feb 2025 14:43:29 +0000 Subject: [PATCH 3/5] Add link --- .../vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md index 1f0371ce2..ffe5af4cf 100644 --- a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md +++ b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md @@ -2,9 +2,9 @@ ## Overview -Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. Test projects can be run as -executables, as with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md) currently. There is no longer a test -runner; the executable _is_ the test runner. +[Microsoft Test Platform (MTP)](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-intro?tabs=dotnetcli) +is the new platform for testing from Microsoft. Test projects can be run as executables, as with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md) +currently. There is no longer a test runner; the executable _is_ the test runner. It will take time to develop feature parity with NUnit's current system, and there are many historical factors to consider. But, the NUnit team recognizes that in the meantime, there needs to be a bridge between these two. In NUnit, From f3a305d553c48dfa614f1da004fb5625f99aeb75 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Fri, 7 Feb 2025 14:43:58 +0000 Subject: [PATCH 4/5] word choice --- .../vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md index ffe5af4cf..5a692a32e 100644 --- a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md +++ b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md @@ -8,7 +8,7 @@ currently. There is no longer a test runner; the executable _is_ the test runner It will take time to develop feature parity with NUnit's current system, and there are many historical factors to consider. But, the NUnit team recognizes that in the meantime, there needs to be a bridge between these two. In NUnit, -the NUnit3TestAdapter contains what is necessary to run the MTP using the same old test runners. +the NUnit3TestAdapter contains what is necessary to run the MTP using the existing test runners. This means we have two modes of MTP operation: either use the new platform but not as an executable, or use it as an executable too. From 0d612ab5f9017b1ab34721e91199b9a4be702856 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Fri, 7 Feb 2025 14:45:14 +0000 Subject: [PATCH 5/5] on second thought, remove link --- .../vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md index 5a692a32e..bbddb20f1 100644 --- a/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md +++ b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md @@ -2,9 +2,9 @@ ## Overview -[Microsoft Test Platform (MTP)](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-intro?tabs=dotnetcli) -is the new platform for testing from Microsoft. Test projects can be run as executables, as with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md) -currently. There is no longer a test runner; the executable _is_ the test runner. +Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. Test projects can be run as executables, +as with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md) currently. There is no longer a test runner; the +executable _is_ the test runner. It will take time to develop feature parity with NUnit's current system, and there are many historical factors to consider. But, the NUnit team recognizes that in the meantime, there needs to be a bridge between these two. In NUnit,