Docs on dotnet test arguments coming from vstest are missing

[dhrumil0902]

Proposed topic or title

Vstest Arguments Transferred to DotNet Test

Location in table of contents.

No response

Reason for the article

According to the dotnet vstest documentation page, the command is superseded by the dotnet test command, which can now be used to run assemblies.

Which, I believe, was done as a result of microsoft/vstest#1453 request in a scope of microsoft/vstest-docs#196.

dotnet vstest is able to run tests from the assemblies in parallel if --parallel flag is provided. Per the referenced microsoft/vstest-docs#196, there was an intention to support the same behavior for the dotnet test command as well.

Success criteria (as per user ask)

The "dotnet test" command can be used in place of the "dotnet vstest" command.
The "dotnet test" command can accept a list of dlls
Using "dotnet test" and targeting a list of dlls, there is an argument for "--parallel" which will run the tests from the dlls in parallel.
Using "dotnet test" and targeting a dll, the inclusion or exclusion of the "--no-build" argument will have no impact on the behavior of execution.
My local testing confirms that --parallel flag is respected and tests are run in parallel; test from the assemblies are run sequentially otherwise. Note, that I'm talking parallel execution of the assemblies themselves and not the internal assembly-level of tests parallelization, which is handled by NUnit and its adapter for me.

However, there is no documentation for that feature at the dotnet test page and in the output of the dotnet test --help command, which is confusing.

Is parallel execution of tests from assemblies supported by the dotnet test command officially, and it's safe to rely on that, or it's an implementation detail exposed accidentally?
Should the documentation for dotnet test be updated to reflect that?

Article abstract

More information about how exisiting features of vstest can be used in dotnet test.

Relevant searches

dotnet test --parallel
dotnet test
dotnet test and vstest integration