.NET 10 P3 - SDK Notes

[jamesmontemagno]

No description provided.

[baronfel]

Doc list for me:

CLI

• --interactive support
• [ ] Noun-first CLI commands done in p2
• Shell-specific static completion scripts + examples and docs
• [ ] dotnet run file holding for p4

Containers

• Console apps can natively create containers
• Force OCI image formats

Test

• dotnet test support for MTP

[Youssef1313]

For me I'd like to add dotnet test support for Microsoft.Testing.Platform under CLI. Conceptual docs. A small brief like:

## Microsoft.Testing.Platform (MTP) as first-citizen in `dotnet test` CLI

In .NET 10 Preview 3, `dotnet test` now has a native experience towards [Microsoft.Testing.Platform](https://aka.ms/mtp-overview), which you can opt-in by using `dotnet.config` file as follows:

```toml
[dotnet.test:runner]
name = "Microsoft.Testing.Platform"
```

For more information, see [Testing with `dotnet test`](https://learn.microsoft.com/dotnet/core/testing/unit-testing-with-dotnet-test), which explains how Microsoft.Testing.Platform used to work with `dotnet test` in .NET 9 and earlier, and why a new `dotnet test` experience is needed.

cc @nohwnd @mariam-abdulla

[mariam-abdulla]

## Microsoft.Testing.Platform (MTP) as a First-Class Citizen in `dotnet test` CLI

Starting with .NET 10 Preview 3, `dotnet test` now offers a native experience towards [Microsoft.Testing.Platform](https://aka.ms/mtp-overview). You can enable this feature by adding the following configuration to your dotnet.config file:

 ```toml
 [dotnet.test:runner]
 name = "Microsoft.Testing.Platform"

For more details, refer to [Testing with `dotnet test`](https://learn.microsoft.com/dotnet/core/testing/unit-testing-with-dotnet-test), which explains how Microsoft.Testing.Platform was integrated with `dotnet test` in .NET 9 and earlier versions, and the reasons behind the new `dotnet test` experience.

What do you think of this?
@Youssef1313 @nohwnd @MarcoRossignoli

[nohwnd]

a native experience towards

nit: a native experience for Microsoft.Testing.Platform

[baronfel]

@DamianEdwards do you want to do a blurb for dotnet run foo.cs, or would you like me to do that when I tackle my own blurbs?

[DamianEdwards]

I don't want to announce until P4+ as it's missing some key features in P3.

[baronfel]

thanks - noted that on my list.

[baronfel]

First draft up - @nohwnd want to spot-check the test section? @dsplaisted for SDK-related words as well.

[nohwnd]

@Youssef1313 / @mariam-abdulla did you manage to merge the change that understands the new format without the :? I saw remarks about the change being in preview4 in multiple places.

[baronfel]

does the :-based impl work? I'm concerned with putting something in the p3 relnotes and then changing it in p4 - folks often just google and copy-paste.

[Youssef1313]

: violates TOML and is going to P3. Unfortunately, we already documented it and it's shipping in P3.

[Youssef1313]

@Youssef1313 / @mariam-abdulla did you manage to merge the change that understands the new format without the :? I saw remarks about the change being in preview4 in multiple places.

Yes the change was merged.

[baronfel]

I would rather just not talk about the non-compliant feature in p3 if a fix and future-forward version is coming in a month. Similar logic to what Damian was saying with regards to dotnet-run singlefile. You get one chance to make a first impression - it should be correct and complete.

[Youssef1313]

@baronfel So you mean drop it from release notes?

We have had it documented in dotnet/docs repo though and have seen few users playing with it already on Preview 2 😕

[nohwnd]

Yes the change was merged.

I meant merged in code that will be released in preview3.

I assume "Microsoft.Testing.Platform" would NOT work with preview3 right?

[baronfel]

reverted to the working p3 form.

[Youssef1313]

"Microsoft.Testing.Platform" should work with preview 3.

https://github.com/dotnet/sdk/blob/release/10.0.1xx-preview3/src/Cli/dotnet/commands/dotnet-test/CliConstants.cs#L23

[baronfel]

edit: actually fixed the things - Microsoft.Testing.Platform and dotnet.test:runner for p3

[jamesmontemagno]

Please ping me when ready to merge

[baronfel]

@jamesmontemagno go ahead!