From aeccc29e54851d2c4b2e6be395f79e3369820477 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:15:57 +0100 Subject: [PATCH 01/26] add information on the new Microsoft Test Platform --- .../NUnit-And-Microsoft-Test-Platform.md | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md 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 new file mode 100644 index 000000000..1fd01c1ae --- /dev/null +++ b/docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md @@ -0,0 +1,55 @@ +# NUnit and Microsoft Test Platform + +## Overview + +Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. The Test Projects can be run as +executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). There is no longer a test runner, +the executable **is** the test runner. + +It does take time however, to develop the same capabilities that we have with the current system. +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. + +This mean we have two modes of MTP operation, either just use the new platform, but not as an executable, or use it +as an executable too. + +## Changing a project to use MTP + +To change a current test project to use MTP, you need to use version 5 of the NUnit3TestAdapter. + +Note that this version can run both MTP and non-MTP, and you can easily switch between them by setting to project +properties. + +In a propertygroup (use the top level one), add the following two properties + +```xml + true + Exe +``` + +The first one 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 + +[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) + +## Known issues + +In the current version running single tests don't work. It will always run all tests. +See [Adapter Issue 1232](https://github.com/nunit/nunit3-vs-adapter/issues/1232). + +This applies to both Test Explorer and `dotbet test`. + +As a workaround for the latter, you can filter tests using MTP specific commands +like `dotnet test -- --filter Name=Test1`. + + + + + From 4b6b09663acda9735d401396274512f1b67d5ae6 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:19:01 +0100 Subject: [PATCH 02/26] add information on the new Microsoft Test Platform --- .../NUnit-And-Microsoft-Test-Platform.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 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 1fd01c1ae..f51d0a85a 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,16 +2,16 @@ ## Overview -Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. The Test Projects can be run as +Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. The Test Projects can be run as executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). There is no longer a test runner, -the executable **is** the test runner. +the executable **is** the test runner. It does take time however, to develop the same capabilities that we have with the current system. 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. +necessary to run the MTP using the same old test runners. This mean we have two modes of MTP operation, either just use the new platform, but not as an executable, or use it -as an executable too. +as an executable too. ## Changing a project to use MTP @@ -27,7 +27,7 @@ In a propertygroup (use the top level one), add the following two properties Exe ``` -The first one enables the MTP. The second enables it to also run as an executable, but it doesn't prevent you from +The first one 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` @@ -46,7 +46,7 @@ See [Adapter Issue 1232](https://github.com/nunit/nunit3-vs-adapter/issues/1232) This applies to both Test Explorer and `dotbet test`. -As a workaround for the latter, you can filter tests using MTP specific commands +As a workaround for the latter, you can filter tests using MTP specific commands like `dotnet test -- --filter Name=Test1`. From 5b0e7f3256310ba512004f1323db6282a7ccf33f Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:19:42 +0100 Subject: [PATCH 03/26] add information on the new Microsoft Test Platform --- .../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 f51d0a85a..1b9343303 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 @@ -20,7 +20,7 @@ To change a current test project to use MTP, you need to use version 5 of the NU Note that this version can run both MTP and non-MTP, and you can easily switch between them by setting to project properties. -In a propertygroup (use the top level one), add the following two properties +In a property group (use the top level one), add the following two properties ```xml true From a877a72d93123758036e0250e7509f0c02cd0a49 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:20:12 +0100 Subject: [PATCH 04/26] add information on the new Microsoft Test Platform --- .../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 1b9343303..db18656b2 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 @@ -28,7 +28,7 @@ In a property group (use the top level one), add the following two properties ``` The first one 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` +using it in Test Explorer or through `dotnet test`. ## Information on the Microsoft Test Platform From 251b6378597dbfd854805f26ab20c53c32903198 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:20:43 +0100 Subject: [PATCH 05/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 db18656b2..3556b615a 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 @@ -3,7 +3,7 @@ ## Overview Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. The Test Projects can be run as -executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). There is no longer a test runner, +executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). There is no longer a test runner; the executable **is** the test runner. It does take time however, to develop the same capabilities that we have with the current system. From 9e08b0a51f15a78410ceaba1b6fc65a9912d1f24 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:21:31 +0100 Subject: [PATCH 06/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 3556b615a..05ef6dcac 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 @@ -6,7 +6,7 @@ Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. T executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). There is no longer a test runner; the executable **is** the test runner. -It does take time however, to develop the same capabilities that we have with the current system. +It does take time, however, to develop the same capabilities that we have with NUnit's current system, and there are many historical factors to consider. 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. From fe9e0d6562107dafa38a07ded010fc2e04203cd1 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:21:59 +0100 Subject: [PATCH 07/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 05ef6dcac..e5e2d3d7c 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 @@ -10,7 +10,7 @@ It does take time, however, to develop the same capabilities that we have with N 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. -This mean we have two modes of MTP operation, either just use the new platform, but not as an executable, or use it +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. ## Changing a project to use MTP From 42287fbe71287225cfcc41f0b7a1273f1fa044d6 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:22:10 +0100 Subject: [PATCH 08/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 e5e2d3d7c..dceb5eaf9 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 @@ -31,7 +31,7 @@ The first one enables the MTP. The second enables it to also run as an executab using it in Test Explorer or through `dotnet test`. -## Information on the Microsoft Test Platform +## Information on the Microsoft Test Platform [Microsoft Test Platform](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-intro?tabs=dotnetcli) From 4946ae2ce90796a3a0f60133b4947b6a2b48eb49 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:22:18 +0100 Subject: [PATCH 09/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md | 8 +++----- 1 file changed, 3 insertions(+), 5 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 dceb5eaf9..ac53c96c7 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 @@ -33,11 +33,9 @@ using it in Test Explorer or through `dotnet test`. ## Information on the Microsoft Test Platform -[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) +* [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) ## Known issues From 045ec8ae159170f1fabafaba54a49f08133991b2 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:22:32 +0100 Subject: [PATCH 10/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 ac53c96c7..d9f2bc3ef 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 @@ -15,7 +15,7 @@ as an executable too. ## Changing a project to use MTP -To change a current test project to use MTP, you need to use version 5 of the NUnit3TestAdapter. +To change a current test project to use MTP, you need to use version 5.0 or greater of the NUnit3TestAdapter. Note that this version can run both MTP and non-MTP, and you can easily switch between them by setting to project properties. From 267a3eb31ed995b8f382b8a0637c23ec4d46e9c7 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:23:51 +0100 Subject: [PATCH 11/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 d9f2bc3ef..1e127af86 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 @@ -42,7 +42,7 @@ using it in Test Explorer or through `dotnet test`. In the current version running single tests don't work. It will always run all tests. See [Adapter Issue 1232](https://github.com/nunit/nunit3-vs-adapter/issues/1232). -This applies to both Test Explorer and `dotbet test`. +This applies to both Test Explorer and `dotnet test`. As a workaround for the latter, you can filter tests using MTP specific commands like `dotnet test -- --filter Name=Test1`. From aff5eadd438b2184d84c9fcc3ffc852f88bc4f06 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:23:59 +0100 Subject: [PATCH 12/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md | 4 ---- 1 file changed, 4 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 1e127af86..bd015db6c 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 @@ -47,7 +47,3 @@ This applies to both Test Explorer and `dotnet test`. As a workaround for the latter, you can filter tests using MTP specific commands like `dotnet test -- --filter Name=Test1`. - - - - From f046058c782b80de2e56446a10733e9ecad4f2e9 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:24:20 +0100 Subject: [PATCH 13/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 bd015db6c..6dfa0608c 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 @@ -7,7 +7,7 @@ executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner the executable **is** the test runner. It does take time, however, to develop the same capabilities that we have with NUnit's current system, and there are many historical factors to consider. -In the meantime, there needs to be a bridge between these two. In NUnit, the NUnit3TestAdapter contains what is +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. This means we have two modes of MTP operation: either use the new platform but not as an executable, or use it From 820ee7ed2d56bd6370f5acb076904bf40632bd2a Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:25:28 +0100 Subject: [PATCH 14/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 6dfa0608c..a51382305 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,7 +2,7 @@ ## Overview -Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. The Test Projects can be run as +Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. The Test Projects can be run as executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). There is no longer a test runner; the executable **is** the test runner. From 764b9fc3e21edb287fb600f50ac05868c0a43568 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:25:35 +0100 Subject: [PATCH 15/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 a51382305..7765fd9f1 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 @@ -4,7 +4,7 @@ Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. The Test Projects can be run as executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). There is no longer a test runner; -the executable **is** the test runner. +the executable _is_ the test runner. It does take time, however, to develop the same capabilities that we have 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 From f41ab07a802b8fe059c6aa4d57e98755e04ace30 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:27:40 +0100 Subject: [PATCH 16/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 7765fd9f1..60c81b70f 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 @@ -39,7 +39,7 @@ using it in Test Explorer or through `dotnet test`. ## Known issues -In the current version running single tests don't work. It will always run all tests. +In the current (v5) version of the NUnit3TestAdapter, running single tests don't work. It will always run all tests. See [Adapter Issue 1232](https://github.com/nunit/nunit3-vs-adapter/issues/1232). This applies to both Test Explorer and `dotnet test`. From 9ca59ec964575aed6f8bd1e40939fb8374a54e05 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:27:52 +0100 Subject: [PATCH 17/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 60c81b70f..0d5119699 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 @@ -13,7 +13,7 @@ necessary to run the MTP using the same old 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. -## Changing a project to use MTP +## Changing a Project to Use MTP To change a current test project to use MTP, you need to use version 5.0 or greater of the NUnit3TestAdapter. From 62e9cb0d3bfeb6826cf27e660d5d786517d41e33 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:30:07 +0100 Subject: [PATCH 18/26] add information on the new Microsoft Test Platform --- .../vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 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 0d5119699..e3461a086 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 @@ -6,9 +6,10 @@ Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. Th executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). There is no longer a test runner; the executable _is_ the test runner. -It does take time, however, to develop the same capabilities that we have 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. +It does take time, however, to develop the same capabilities that we have 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. 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. @@ -30,7 +31,6 @@ In a property group (use the top level one), add the following two properties The first one 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 * [Microsoft Test Platform](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-platform-intro?tabs=dotnetcli) @@ -46,4 +46,3 @@ This applies to both Test Explorer and `dotnet test`. As a workaround for the latter, you can filter tests using MTP specific commands like `dotnet test -- --filter Name=Test1`. - From 4b53e1e201d6259b4d21aaf3c9fef2f5f1e04334 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:30:59 +0100 Subject: [PATCH 19/26] Update docs/articles/vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md Co-authored-by: Sean Killeen --- .../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 e3461a086..fccd98ba6 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 @@ -44,5 +44,5 @@ See [Adapter Issue 1232](https://github.com/nunit/nunit3-vs-adapter/issues/1232) This applies to both Test Explorer and `dotnet test`. -As a workaround for the latter, you can filter tests using MTP specific commands +As a workaround for the latter, you can filter tests using MTP-specific commands like `dotnet test -- --filter Name=Test1`. From 94bd08c735d7ef11f1d83b5d160877fe68fd33ce Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:40:47 +0100 Subject: [PATCH 20/26] Added toc entry --- docs/articles/vs-test-adapter/toc.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/articles/vs-test-adapter/toc.yml b/docs/articles/vs-test-adapter/toc.yml index a3f9db429..e1391b90d 100644 --- a/docs/articles/vs-test-adapter/toc.yml +++ b/docs/articles/vs-test-adapter/toc.yml @@ -10,6 +10,8 @@ href: Known-Problems.md - name: Configuration with runsettings href: Tips-And-Tricks.md +- name: Microsoft Test Platform (MTP) + href: NUnit-And-Microsoft-Test-Platform.md - name: Trace And Debug Output href: Trace-and-Debug.md - name: Supported Frameworks From f63fbd7aa1c38bc0bcef4450c7bf0919d940da64 Mon Sep 17 00:00:00 2001 From: Terje Sandstrom Date: Sun, 2 Feb 2025 23:44:04 +0100 Subject: [PATCH 21/26] Added toc entry --- .../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 fccd98ba6..e00e3339f 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 @@ -18,7 +18,7 @@ as an executable too. To change a current test project to use MTP, you need to use version 5.0 or greater of the NUnit3TestAdapter. -Note that this version can run both MTP and non-MTP, and you can easily switch between them by setting to project +Note that this version can run both MTP and non-MTP, and you can easily switch between them by setting two project properties. In a property group (use the top level one), add the following two properties From 0dee0e36408410289f4a98e622be82caa6b0176f Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Mon, 3 Feb 2025 01:36:29 +0000 Subject: [PATCH 22/26] phrasing update --- .../vs-test-adapter/NUnit-And-Microsoft-Test-Platform.md | 7 +++---- 1 file changed, 3 insertions(+), 4 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 e00e3339f..770a33129 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 @@ -6,10 +6,9 @@ Microsoft Test Platform (MTP) is the new platform for testing from Microsoft. Th executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). There is no longer a test runner; the executable _is_ the test runner. -It does take time, however, to develop the same capabilities that we have 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. +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. 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 a23695b684552c77f35f27c7e06b3bbc73a94c09 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Mon, 3 Feb 2025 01:38:07 +0000 Subject: [PATCH 23/26] more --- .../NUnit-And-Microsoft-Test-Platform.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 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 770a33129..cceb943ad 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 @@ -17,18 +17,18 @@ as an executable too. To change a current test project to use MTP, you need to use version 5.0 or greater of the NUnit3TestAdapter. -Note that this version can run both MTP and non-MTP, and you can easily switch between them by setting two project +Note that this version can run both with and without MTP, and you can easily switch between them by setting two project properties. -In a property group (use the top level one), add the following two properties +In a property group (use the top-level one), add the following two properties: ```xml true Exe ``` -The first one 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`. +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 @@ -38,7 +38,7 @@ using it in Test Explorer or through `dotnet test`. ## Known issues -In the current (v5) version of the NUnit3TestAdapter, running single tests don't work. It will always run all tests. +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). This applies to both Test Explorer and `dotnet test`. From ca1ec97ba86e542d7fcf2110f2d5f6012b33ae76 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Mon, 3 Feb 2025 01:38:39 +0000 Subject: [PATCH 24/26] errant space --- .../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 cceb943ad..c7b839226 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 @@ -27,7 +27,7 @@ In a property group (use the top-level one), add the following two properties: Exe ``` -The first property, `EnableNUnitRunner`, enables the MTP. The second enables it to also run as an executable (but it +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 From b33ecad742cf4ad2eec13713a254adf4f83c4115 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Mon, 3 Feb 2025 01:40:27 +0000 Subject: [PATCH 25/26] final touches --- .../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 c7b839226..374b5ab60 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. The Test Projects can be run as -executables, like we do with [NUnitLite](../nunit/running-tests/NUnitLite-Runner.md). 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, From c4228bbd2b60649eb49a9beedcb722d291d79588 Mon Sep 17 00:00:00 2001 From: Sean Killeen Date: Mon, 3 Feb 2025 01:41:25 +0000 Subject: [PATCH 26/26] missed an errant space --- .../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 374b5ab60..014dd65e6 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 @@ -3,7 +3,7 @@ ## 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 +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