Skip to content

Commit

Permalink
typos
Browse files Browse the repository at this point in the history
  • Loading branch information
lambdageek committed Apr 17, 2024
1 parent 1034489 commit 689d28c
Showing 1 changed file with 7 additions and 8 deletions.
15 changes: 7 additions & 8 deletions docs/workflow/testing/testing-managed-tools.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
# Testing managed tools

Managed unit and functional tests for a number of tools are included in the product including the
compiler for NativeAOT, and the trimmer (illink)
There are managed unit and functional tests for a number of tools including the
compiler for NativeAOT (`ILCompiler`), and the trimmer (`illink`).

## Adding new testsuites

To add new test suite, create a new `.csproj` with a name that ends in `Tests`, such as:
To add a new test suite, create a new `.csproj` with a name that ends in `Tests`, such as:
`MyTool.Tests.csproj`. The property `IsTestProject` will be set by the `Directories.Build.props` in
the repository root. The property will, in turn, add references to the xunit package and the
apropriate test runner.

Now add a `ProjectToBuild` item to `eng/Substes.props` to one of the existing subsets such as
`clr.toolstests` or add a new subset.
Now add a `ProjectToBuild` item in `eng/Substes.props` to one of the existing subsets, such as
`clr.toolstests`, or a new subset.

## Adding new testsuites to CI

To run the tests in CI, add a new pipeline or add to an exsiting pipeline such as `CLR_Tools_Tests`
in `eng/pipelines/runtime.yml`. Update the trigger condition, perhaps by adding a new set of paths
to `eng/pipelines/common/evaluate-default-paths.yml` in order to run the tests when the tool source
or the test sources change./
or the test sources change.

## Running tests locally

Expand All @@ -41,6 +41,5 @@ The `dotnet-test` xunit filter mechanisms work to run a single test or a subset
```

The above command runs all tests whose fully-qualified name contains the substring `MyTest`. See
[dotnet test - Run selective unit
test](https://learn.microsoft.com/en-us/dotnet/core/testing/selective-unit-tests?pivots=mstest#syntax)
[dotnet test - Run selective unit tests](https://learn.microsoft.com/en-us/dotnet/core/testing/selective-unit-tests?pivots=mstest#syntax)
for the full syntax.

0 comments on commit 689d28c

Please sign in to comment.