netcore/gen-xunit-runner/README.md

   1 # Introduction
   2
   3 This is a small netcore app to convert a corefx test assembly into a console app which runs the tests without any xunit framework code.
   4
   5 # Usage
   6
   7 ## Project Runner Generator
   8
   9 ```
  10 dotnet run ../output ~/git/corefx/ ~/git/corefx/artifacts/bin/System.Runtime.Tests/netcoreapp-Unix-Debug/System.Runtime.Tests.dll -notrait category=nonosxtests -notrait category=failing -notrait category=Outerloop -stoponfail
  11 ```
  12
  13 There is support for response files, i.e.
  14 ```
  15 dotnet run ../output ~/git/corefx/ ~/git/corefx/artifacts/bin/System.Runtime.Tests/netcoreapp-Unix-Debug/System.Runtime.Tests.dll @excludes.rsp
  16 ```
  17
  18
  19 ## Tests Runner Build
  20
  21 Go to for example `../output` from the example above and do
  22
  23 ```
  24 dotnet build
  25 ```
  26
  27 ## Tests Execution
  28
  29 This assumes you have sucesfully ran HelloWorld sample before
  30
  31 ```
  32 ../../sample/dotnet  --fx-version "3.0.0-preview-27408-5" bin/Debug/netcoreapp3.0/{name-of-the-test-dll}.dll
  33 ```
  34
  35 The test dll will usually be in the format `System.Runtime.Tests-runner.dll`
  36
  37
  38 # Notes
  39
  40 - If xunit can't load a trait discoverer assembly, it silently ignores the error.
  41 - The RemoteTestExecutor code used by corefx only seems to work if
  42 the app is executed from the binary dir using dotnet ./<dllname>.
  43 If ran using dotnet run, it seems to invoke itself instead of
  44 RemoteExecutorConsoleApp.exe.
  45 If ran using dotnet bin/.../<dllname>, it fails with:
  46 No executable found matching command "dotnet-<dir>/RemoteExecutorConsoleApp.exe"