Fix `--project` and `--solution` descriptions for `dotnet test` MTP to use "test" instead of "run" and extract shared localization strings #51052

Copilot · 2025-09-29T14:16:34Z

Customer Issue

Current description for --solution (dotnet test):

Defines the path of the solution file to run. If not specified, it defaults to the current directory.

Current description for --project (dotnet test):

Defines the path of the project file to run (folder name or full path). If not specified, it defaults to the current directory.

This is confusing to users because both command-line options accept either full path to project/solution or just the directory. Moreover, the description says "run" instead "test".

Current description for --project (dotnet run):

The path to the project file to run (defaults to the current directory if there is only one project).

We would like to align these for correctness and consistency.

Description

Tiny help text change to --project (both run and test commands) and --solution (test command).
PR link: #51052

Testing

Automated tests were updated.

Risk

Low - only updates CLI description strings.

Changes Made:

Created parameterized resource strings CmdProjectDescriptionFormat and CmdSolutionDescriptionFormat in CliCommandStrings.resx that accept a verb parameter
Added factory methods ProjectOption(string verb) and SolutionOption(string verb) in CommonOptions.cs
Created localized verb resources VerbRun and VerbTest in CliCommandStrings.resx
Updated MicrosoftTestingPlatformOptions.cs to use CommonOptions.ProjectOption(CliCommandStrings.VerbTest) and CommonOptions.SolutionOption(CliCommandStrings.VerbTest)
Updated RunCommandParser.cs to use CommonOptions.ProjectOption(CliCommandStrings.VerbRun)
Removed unused resources: CmdProjectDescription and CommandOptionProjectDescription
Updated completion test snapshots (zsh and pwsh) with new project option description
Both commands now share the same localization string pattern with localizable verbs

Verification:

dotnet test --help (with MTP enabled) shows "Defines the path of the project file to test..." and "Defines the path of the solution file to test..."
dotnet run --help shows "Defines the path of the project file to run..."
Build succeeds
The verbs are now properly localizable, ensuring consistent translations across all languages
Unused resources have been cleaned up
Completion test snapshots updated with new description format

Original prompt

This section details on the original issue you should resolve

<issue_title>Description of --solution of MTP dotnet test should be worded similarly to --project</issue_title>
<issue_description>

sdk/src/Cli/dotnet/Commands/CliCommandStrings.resx

Lines 596 to 598 in 2ca3933

<data name="CmdSolutionDescription" xml:space="preserve">

<value>Defines the path of the solution file to run. If not specified, it defaults to the current directory.</value>

</data>

sdk/src/Cli/dotnet/Commands/CliCommandStrings.resx

Lines 552 to 554 in 2ca3933

<data name="CmdProjectDescription" xml:space="preserve">

<value>Defines the path of the project file to run (folder name or full path). If not specified, it defaults to the current directory.</value>

</data>

</issue_description>

Comments on the Issue (you are @copilot in this section)
@Youssef1313 Also, the description says "run", but should be `test` for `dotnet test` (the description for `--project` is currently shared between run and test commands) @baronfel @Youssef1313 definitely agree - copilot should be able to handle this similar to https://github.com//pull/51042 if you don't want to spend personal time on it.

Fixes #51051

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Co-authored-by: Youssef1313 <[email protected]>

src/Cli/dotnet/CommandFactory/CommandResolution/ProjectToolsCommandResolver.cs

Co-authored-by: Youssef1313 <[email protected]>

nohwnd · 2025-10-02T09:17:44Z

src/Cli/dotnet/Commands/xlf/CliCommandStrings.cs.xlf

        <note />
      </trans-unit>
+      <trans-unit id="TestCmdProjectDescription">
+        <source>Defines the path of the project file to test (folder name or full path). If not specified, it defaults to the current directory.</source>


Suggested change

<source>Defines the path of the project file to test (folder name or full path). If not specified, it defaults to the current directory.</source>

<source>Defines the path of the project file to test. Use path to the project file, or path to the directory containing the project file. If not specified, it defaults to the current directory.</source>

I would formulate it like this, because the current wording forces me to do too much thinking. It says that I should specify the path to the project, but then it talks about folder name or full path. These two are not the opposites in my eyes,

folder name is not the same as relative or full path to a folder.
and full path, is not the same as relative or full path to the project file.

@copilot please apply the change in wording to the resources, and re-build so we get the updates.

I was following the same wording as used by dotnet run. I prefer to keep both in sync, so I went ahead and updated it for both test and run.

@jjonescz Any concerns about the resource rewording here?

looks good to me

baronfel · 2025-10-02T15:01:43Z

src/Cli/dotnet/Commands/Test/MTP/MicrosoftTestingPlatformOptions.cs

    public static readonly Option<string> ProjectOption = new("--project")
    {
-        Description = CliCommandStrings.CmdProjectDescription,
+        Description = CliCommandStrings.TestCmdProjectDescription,


I have a minor nit: the strings for run and test are the same except for the 'verb' used - we've been extracting this pattern out to shared strings and providing the 'verb' as a parameter when creating the Option/Argument.

@copilot can you extract the shared loc string and update the test and run usages of the Project and Solution options to use the shared string, passing in the matching verb?

@baronfel Is it fine if the words "run"/"test" are not localized? Or do we want to also have resources with "single" words for "run" and "test" so they are localized?

good point - @copilot make those single words localizeable as well

Done in commit 99e653e. Created parameterized resource strings CmdProjectDescriptionFormat and CmdSolutionDescriptionFormat, and factory methods CommonOptions.ProjectOption(string verb) and CommonOptions.SolutionOption(string verb). Both test and run commands now use these shared methods with their respective verbs ("test" and "run").

Test command:

--project <PROJECT_PATH> Defines the path of the project file to test. Use path to the project file, or path to the directory containing the project file. If not specified, it defaults to the current directory.

Run command:

--project <PROJECT_PATH> Defines the path of the project file to run. Use path to the project file, or path to the directory containing the project file. If not specified, it defaults to the current directory.

Done in commit d8074b5. Added localized verb resources VerbRun and VerbTest in CliCommandStrings.resx. Updated both test and run command parsers to use these localized strings instead of hardcoded "test" and "run".

Changes:

Created VerbRun and VerbTest resource strings

Updated MicrosoftTestingPlatformOptions to use CliCommandStrings.VerbTest

Updated RunCommandParser to use CliCommandStrings.VerbRun

The verbs are now properly localizable, ensuring consistent translations across all languages.

… verb parameter Co-authored-by: baronfel <[email protected]>

Co-authored-by: baronfel <[email protected]>

Youssef1313 · 2025-10-02T15:43:36Z

src/Cli/dotnet/Commands/CliCommandStrings.resx

  <data name="CmdProjectDescription" xml:space="preserve">
-    <value>Defines the path of the project file to run (folder name or full path). If not specified, it defaults to the current directory.</value>
+    <value>Defines the path of the project file to run. Use path to the project file, or path to the directory containing the project file. If not specified, it defaults to the current directory.</value>
  </data>


@copilot This resource is unused now? It can be deleted.

Removed in commit cecdc27. Deleted both CmdProjectDescription and CommandOptionProjectDescription resources as they are no longer used after switching to the parameterized CmdProjectDescriptionFormat.

…on resources Co-authored-by: Youssef1313 <[email protected]>

Youssef1313

@copilot You need to also update:

test/dotnet.Tests/CompletionTests/snapshots/zsh/DotnetCliSnapshotTests.VerifyCompletions.verified.zsh
test/dotnet.Tests/CompletionTests/snapshots/pwsh/DotnetCliSnapshotTests.VerifyCompletions.verified.ps1

Specifically, change:

The path to the project file to run (defaults to the current directory if there is only one project).

to

Defines the path of the project file to run. Use path to the project file, or path to the directory containing the project file. If not specified, it defaults to the current directory.

Co-authored-by: Youssef1313 <[email protected]>

Copilot · 2025-10-03T03:49:18Z

@copilot You need to also update:

test/dotnet.Tests/CompletionTests/snapshots/zsh/DotnetCliSnapshotTests.VerifyCompletions.verified.zsh
...

Updated in commit 9b2267f. Both completion test snapshot files now use the new description format:

Old description:

The path to the project file to run (defaults to the current directory if there is only one project).

New description:

Defines the path of the project file to run. Use path to the project file, or path to the directory containing the project file. If not specified, it defaults to the current directory.

Changed in:

test/dotnet.Tests/CompletionTests/snapshots/zsh/DotnetCliSnapshotTests.VerifyCompletions.verified.zsh
test/dotnet.Tests/CompletionTests/snapshots/pwsh/DotnetCliSnapshotTests.VerifyCompletions.verified.ps1

Youssef1313 · 2025-10-03T14:26:57Z

@baronfel Is this good to merge?

baronfel · 2025-10-03T14:30:21Z

@Youssef1313 it needs Tactics approval, so you'd need to send the mail

Initial plan

b68d460

Copilot AI assigned Copilot and Youssef1313 Sep 29, 2025

Copilot started work on behalf of Youssef1313 September 29, 2025 14:16 View session

Fix dotnet test MTP option descriptions to use 'test' instead of 'run'

4c9c63e

Co-authored-by: Youssef1313 <[email protected]>

Copilot AI changed the title ~~[WIP] Description of --solution of MTP dotnet test should be worded similarly to --project~~ Fix --project and --solution descriptions for dotnet test MTP to use "test" instead of "run" Sep 29, 2025

Copilot AI requested a review from Youssef1313 September 29, 2025 14:34

Copilot finished work on behalf of Youssef1313 September 29, 2025 14:34

This was referenced Sep 29, 2025

GenerateBundle Task fails writing to singlefilehost.exe #50784

Open

The command output did not contain expected result: error NETSDK1204 #51049

Open

Youssef1313 reviewed Oct 1, 2025

View reviewed changes

src/Cli/dotnet/CommandFactory/CommandResolution/ProjectToolsCommandResolver.cs Outdated Show resolved Hide resolved

Copilot started work on behalf of Youssef1313 October 1, 2025 08:15 View session

Revert formatting changes, keep only functional changes

7d82904

Co-authored-by: Youssef1313 <[email protected]>

Copilot AI requested a review from Youssef1313 October 1, 2025 08:28

Copilot finished work on behalf of Youssef1313 October 1, 2025 08:28

Cleanup

9587df9

Youssef1313 marked this pull request as ready for review October 1, 2025 08:39

This was referenced Oct 1, 2025

error : HttpRequestException: The SSL connection could not be established, see inner exception. dotnet/dnceng#5015

Open

arcade/src/Microsoft.DotNet.Arcade.Sdk/src/DownloadFile.cs:line 184 TimeoutException: The operation was canceled. dotnet/dnceng#6074

Open

nohwnd reviewed Oct 2, 2025

View reviewed changes

Address review comment

605166a

Copilot started work on behalf of nohwnd October 2, 2025 10:09 View session

Copilot AI requested a review from nohwnd October 2, 2025 10:10

Copilot finished work on behalf of nohwnd October 2, 2025 10:10

Youssef1313 requested review from baronfel and jjonescz October 2, 2025 10:13

baronfel reviewed Oct 2, 2025

View reviewed changes

Copilot started work on behalf of baronfel October 2, 2025 15:01 View session

Extract shared localization strings for project/solution options with…

99e653e

… verb parameter Co-authored-by: baronfel <[email protected]>

Copilot AI changed the title ~~Fix --project and --solution descriptions for dotnet test MTP to use "test" instead of "run"~~ Fix --project and --solution descriptions for dotnet test MTP to use "test" instead of "run" and extract shared localization strings Oct 2, 2025

Copilot AI requested a review from baronfel October 2, 2025 15:16

Copilot finished work on behalf of baronfel October 2, 2025 15:16

Copilot started work on behalf of baronfel October 2, 2025 15:16 View session

Make verb strings localizable for project/solution options

d8074b5

Co-authored-by: baronfel <[email protected]>

Copilot finished work on behalf of baronfel October 2, 2025 15:26

Youssef1313 reviewed Oct 2, 2025

View reviewed changes

Copilot started work on behalf of Youssef1313 October 2, 2025 15:43 View session

Remove unused CmdProjectDescription and CommandOptionProjectDescripti…

cecdc27

…on resources Co-authored-by: Youssef1313 <[email protected]>

Copilot AI requested a review from Youssef1313 October 2, 2025 15:54

Copilot finished work on behalf of Youssef1313 October 2, 2025 15:54

Youssef1313 reviewed Oct 3, 2025

View reviewed changes

Copilot started work on behalf of Youssef1313 October 3, 2025 03:41 View session

Update completion test snapshots with new project option description

9b2267f

Co-authored-by: Youssef1313 <[email protected]>

Copilot finished work on behalf of Youssef1313 October 3, 2025 03:49

Copilot AI requested a review from Youssef1313 October 3, 2025 03:49

baronfel added the Servicing-consider label Oct 3, 2025

baronfel approved these changes Oct 3, 2025

View reviewed changes

Youssef1313 added 3 commits October 6, 2025 17:21

Cleanup

504b6d2

Cleanup

3cc26fb

Update

8b5c495

	<data name="CmdSolutionDescription" xml:space="preserve">
	<value>Defines the path of the solution file to run. If not specified, it defaults to the current directory.</value>
	</data>

	<data name="CmdProjectDescription" xml:space="preserve">
	<value>Defines the path of the project file to run (folder name or full path). If not specified, it defaults to the current directory.</value>
	</data>

	<source>Defines the path of the project file to test (folder name or full path). If not specified, it defaults to the current directory.</source>
	<source>Defines the path of the project file to test. Use path to the project file, or path to the directory containing the project file. If not specified, it defaults to the current directory.</source>

Fix --project and --solution descriptions for dotnet test MTP to use "test" instead of "run" and extract shared localization strings #51052

Are you sure you want to change the base?

Fix --project and --solution descriptions for dotnet test MTP to use "test" instead of "run" and extract shared localization strings #51052

Uh oh!

Conversation

Copilot AI commented Sep 29, 2025 • edited by Youssef1313 Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Customer Issue

Description

Testing

Risk

Comments on the Issue (you are @copilot in this section)

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 2, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 2, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 2, 2025

Choose a reason for hiding this comment

Uh oh!

Youssef1313 left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Oct 3, 2025

Uh oh!

Youssef1313 commented Oct 3, 2025

Uh oh!

baronfel commented Oct 3, 2025

Uh oh!

Uh oh!

Fix `--project` and `--solution` descriptions for `dotnet test` MTP to use "test" instead of "run" and extract shared localization strings #51052

Fix `--project` and `--solution` descriptions for `dotnet test` MTP to use "test" instead of "run" and extract shared localization strings #51052

Copilot AI commented Sep 29, 2025 •

edited by Youssef1313

Loading