DRKV333 / vscode-dotnet-test-explorer

.NET Test Provider / Explorer for Visual Studio Code

Home Page:https://marketplace.visualstudio.com/items?itemName=jcamp.dotnet-test-explorer

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

.NET Test Provider / Explorer

Future use

Note that this extension will eventually be deprecated once OmniSharp includes built in test API. See the mention of this here: dotnet/vscode-csharp#5054

I needed it for use now, so just put it together to suit my needs until OmniSharp has it integrated.

Features

Notes

I didn't see evidence the original version was being maintained any longer and I really wanted to add VS Code Test Integration. I'm not quite ready to totally remove the old UI code just yet, so it is there.

Also note that the source code linking doesn't show up until OmniSharp is finished initializing, so you will need to refresh the test explorer once OmniSharp is done so it fully integrates.

Prerequisites

  • .NET Core is installed
  • NUnit and MSTest requires a dotnet sdk version of >= 2.2.104.

New in 0.8.0

  • Tree in original browser works properly in VS Code 1.70 or later
  • VS Code Test Integration (Run, Debug, Go to Code)
  • Removed telemetry

To-do

  • Watching does not work in new UI
  • Provide option to not discover tests upon startup in new UI

Usage

Open a .NET test project, or set dotnet-test-explorer.testProjectPath to the folder path of .NET test project. Then, you will see all the tests in Test Explorer. More information on how to set the testProjectPath can be found below under Settings.

Settings

The settings are available via File / Preferences / Settings. Navigate to extensions and .NET Core test explorer.

image

Settings examples

dotnet-test-explorer.testProjectPath

Glob pattern that points to path of .NET Core test project(s). A common pattern is "**/*Tests.csproj".

Given the folder structure

  • root
    • testProjectOne
      • testproject1.Tests.csproj
    • testProjectTwo
      • testproject2.Tests.csproj

the glob pattern "+(testProjectOne|testProjectTwo)" or "**/*Tests.csproj" should add both of the test projects.

dotnet-test-explorer.autoWatch

If true, starts dotnet watch test after test discovery is completed

dotnet-test-explorer.testArguments

Additional arguments that are added to the dotnet test command. These can for instance be used to collect code coverage data ("/p:CollectCoverage=true /p:CoverletOutputFormat=lcov /p:CoverletOutput=../../lcov.info") or pass test settings ("--settings:./myfilename.runSettings")

Stopping the current test runner(s)

Press the stop button in the top menu. This also works as a reset of sorts so if the extension has managed to end up in a weird state where it thinks a test is running even though it is not or that the debugger is running even though it is not the stop button can solve these types of issues as well.

test-explorer

Logging

Text from the dotnet test output as well as debug info is written to the Output/Test explorer terminal window. To view the log you can access it simply by clicking the view log icon.

showlog

Debugging (alpha)

To debug a test, right click the test and choose to Debug test. The option to run and debug test that appear in the code lens are provided by the omnisharp plugin and has nothing to do with this extension.

The debugger might get stuck before loading your test assembly code. If this happens you can continue the debug process (F5) and it should load the rest of the assemblies and stop and the desired breakpoint.

Keyboard shortcuts

  • Run all tests, default Alt+R Alt+A

  • Rerun last command, default Alt+R Alt+R

  • Run test(s) in context, default Alt+R Alt+C

Known issues

Go to test does not work with multiple workspaces

This is because of limitations in the omnisharp extensions. We can only navigate to symbols which are in the currently selected workspace.

Test result is not shown in CodeLens / tree

Try and change the setting dotnet-test-explorer.pathForResultFile to point to a folder you have access right too. CodeLens functionality also requires the C# extension)

No tree view or color-coded explorer for NUnit / MSTest

This requires you to run dotnet SDK version 2.2.104 or higher.

xUnit projects assembly name needs to match the test class namespace

See #201

DisplayName attribute not working for xUnit

See #56

Project discovery with UNC Paths doesn't work

See #179

Change Log

See Change Log here

Issues

If you find any bug or have any suggestion/feature request, please submit the issues to the GitHub Repo.

❤️ Contributors

Thanks to all the contributors!

Special thanks to Stefan Forsberg (@stefanforsberg) for maintaining the project and implementing so many cool features! Also thanks to Janaka Abeywardhana (@janaka) for maintaining the project!

About

.NET Test Provider / Explorer for Visual Studio Code

https://marketplace.visualstudio.com/items?itemName=jcamp.dotnet-test-explorer

License:MIT License


Languages

Language:TypeScript 94.8%Language:C# 4.8%Language:JavaScript 0.4%Language:F# 0.1%