11# NUnit Host Testing
22
33Experimental in-host NUnit for Revit / AutoCAD-family via DevTools Named Pipe,
4- with MTP (` DevTools .NUnit` ) and VSTest (` DevTools.NUnit.TestAdapter ` ) consumers.
4+ with MTP (` RevitDevTool .NUnit` ) and VSTest (` DevTools.NUnit.TestAdapter ` ) consumers.
55The MTP package requires
66[ RevitDevTool] ( https://github.com/trgiangv/RevitDevTool ) ; the host-test
77controller ships in that installer. The live CAD host executes the tests.
88
99## Status
1010
11- ** Experimental.** Discover / run / progress work end-to-end. ` DevTools .NUnit`
11+ ** Experimental.** Discover / run / progress work end-to-end. ` RevitDevTool .NUnit`
1212(MTP) is published independently of the RevitDevTool installer. Version is
1313` <Version> ` in ` source/DevTools.NUnit.Mtp/DevTools.NUnit.Mtp.csproj ` (starts at
1414` 0.0.1 ` ). Run ` .github/workflows/PublishNUnit.yml ` from GitHub Actions to pack
@@ -19,7 +19,7 @@ Host-process debugging is **out of scope**. There is no `--debug` CLI, no Test
1919Explorer Debug attach, and no IDE SDK. Attach the IDE debugger to the host
2020PID yourself if needed; that is not a product feature.
2121
22- Two consumer surfaces share the same Runner/Host: MTP (` DevTools .NUnit` ) and
22+ Two consumer surfaces share the same Runner/Host: MTP (` RevitDevTool .NUnit` ) and
2323VSTest (` DevTools.NUnit.TestAdapter ` ). Keep them on ** separate** test projects.
2424
2525## Modules
@@ -29,10 +29,10 @@ VSTest (`DevTools.NUnit.TestAdapter`). Keep them on **separate** test projects.
2929| ` DevTools.NUnit.Core ` | ` nunit/* ` wire contracts, timing, protocol version |
3030| ` DevTools.NUnit.Host ` | Native NUnit runtime in the CAD host |
3131| ` DevTools.NUnit.Runner ` | CLI controller: find/launch host pipe, discover/run |
32- | ` DevTools.NUnit.Mtp ` | MTP framework (` PackageId=DevTools .NUnit ` ); proxies to Runner |
32+ | ` DevTools.NUnit.Mtp ` | MTP framework (` PackageId=RevitDevTool .NUnit ` ); proxies to Runner |
3333| ` DevTools.NUnit.TestAdapter ` | VSTest adapter; same Runner/Host contract |
3434
35- ` DevTools .NUnit` is an independent test-platform package. Consumers set
35+ ` RevitDevTool .NUnit` is an independent test-platform package. Consumers set
3636` HostName ` / ` HostVersion ` / launch timeouts; the package does not read this
3737repo's ` UseRevit ` / ` UseAutoCad ` . MTP never loads into the CAD host, so it is
3838not ILRepacked. ` Microsoft.Testing.Platform ` is compile-only
@@ -51,7 +51,7 @@ Four live samples — two adapters × two hosts. Do not mix MTP and VSTest on on
5151
5252| Sample | Adapter | Host |
5353| --------| ---------| ------|
54- | ` samples/DevTools.NUnit.SampleTests ` | MTP (` DevTools .NUnit` ) | Revit |
54+ | ` samples/DevTools.NUnit.SampleTests ` | MTP (` RevitDevTool .NUnit` ) | Revit |
5555| ` samples/DevTools.NUnit.Civil3D.SampleTests ` | MTP | Civil 3D |
5656| ` samples/DevTools.NUnit.VSTest.SampleTests ` | VSTest (` DevTools.NUnit.TestAdapter ` ) | Revit |
5757| ` samples/DevTools.NUnit.VSTest.Civil3D.SampleTests ` | VSTest | Civil 3D |
@@ -112,7 +112,7 @@ Runner ships under the ApplicationPlugins bundle `Contents` folder (publish
112112| Probe load | ** Also shadows** : zip test folder → ` %TEMP%\RevitTest\ ` → extract → ` Assembly.LoadFile ` on the temp copy (then optional zip-back) | Content-addressed generation shadow of test output + Runtime |
113113| Transport | Own Console + ` PipeTestServer ` /` PipeTestClient ` (process-named pipe) | Existing ` DevToolsPipeServer ` + ` IHostContextExecutor ` |
114114| IDE surface | VS-oriented + EnvDTE attach | MTP + VSTest samples; no debugger integration |
115- | Package | ricaun NuGet ecosystem | ` DevTools .NUnit` (MTP) NuGet, versioned in the MTP csproj; VSTest adapter in-tree |
115+ | Package | ricaun NuGet ecosystem | ` RevitDevTool .NUnit` (MTP) NuGet, versioned in the MTP csproj; VSTest adapter in-tree |
116116| Hosts | Revit-focused product | Revit + AutoCAD family on shared DevTools platform |
117117
118118** Conflict / coexistence (what actually breaks):**
@@ -127,7 +127,7 @@ Runner ships under the ApplicationPlugins bundle `Contents` folder (publish
127127- Both can load different ` nunit.framework ` identities in the same Revit (Dynamo,
128128 DevTools host, ricaun Application). DevTools avoids ` NUnit.Engine `
129129 ` FrameworkController ` for that reason.
130- - A project that references both ricaun’s VSTest adapter and ` DevTools .NUnit`
130+ - A project that references both ricaun’s VSTest adapter and ` RevitDevTool .NUnit`
131131 can split ownership; keep host-test projects on one framework.
132132
133133Do not depend on ` ricaun.NUnit ` / ` ricaun.RevitTest ` packages for DevTools NUnit.
@@ -165,13 +165,13 @@ options; one intended adapter package aligned with the rest of RevitDevTool.
165165
166166| Package | Publish status |
167167| ---------| ----------------|
168- | ` DevTools .NUnit` (` DevTools.NUnit.Mtp ` ) | Independent of installer tags. Version = csproj ` <Version> ` . Workflow: ` PublishNUnit.yml ` |
168+ | ` RevitDevTool .NUnit` (` DevTools.NUnit.Mtp ` ) | Independent of installer tags. Version = csproj ` <Version> ` . Workflow: ` PublishNUnit.yml ` |
169169| ` DevTools.NUnit.TestAdapter ` | ** Not published** — in-tree VSTest samples only |
170170| Core / Host / Runner | Not consumer NuGet APIs |
171171
172172Bump ` <Version> ` in ` source/DevTools.NUnit.Mtp/DevTools.NUnit.Mtp.csproj ` , commit,
173173then run ** Actions → Publish NUnit** . The workflow reads that property, packs
174- ` DevTools .NUnit.{version}.nupkg` , and pushes nuget.org via
174+ ` RevitDevTool .NUnit.{version}.nupkg` , and pushes nuget.org via
175175[ Trusted Publishing] ( https://learn.microsoft.com/en-us/nuget/nuget-org/trusted-publishing )
176176(OIDC; no long-lived API key). Uncheck ** Push to nuget.org** to pack-only.
177177Do not use installer tags or ` scripts/pack.ps1 ` for this package. Local pack:
@@ -188,7 +188,7 @@ One-time nuget.org setup before the first push:
188188 Optional later: store that name as repo secret ` NUGET_USER ` .
189189 This repo is public; the policy should show ** Active** after Create.
190190
191- Consumers add NUnit, ` DevTools .NUnit` , and ` Microsoft.Testing.Platform.MSBuild ` ;
191+ Consumers add NUnit, ` RevitDevTool .NUnit` , and ` Microsoft.Testing.Platform.MSBuild ` ;
192192install [ RevitDevTool] ( https://github.com/trgiangv/RevitDevTool ) ; set the host-run
193193properties (` HostName ` , ` HostVersion ` , ` HostLaunch ` , timeouts); and keep a
194194test-directory ` global.json ` with ` "test": { "runner": "Microsoft.Testing.Platform" } `
0 commit comments