dotnet retest

Runs dotnet test with retries for failed tests automatically, and pretty-prints aggregated test results, integrating also with GitHub PR comments just like dotnet-trx.

Install latest and run with a single command: dnx retest.

When running locally, it provides live progress on each run:

and timing and outcome for each attempt:

Typical usage: dotnet retest [OPTIONS] [-- [dotnet test options]]:

    - name: 🧪 test
      run: |
        dotnet tool update -g dotnet-retest
        dotnet retest -- --no-build [other test options and args]

PR comment integration:

NOTE: this behavior is triggered by the presence of the GITHUB_REF_NAME and CI environment variables.

USAGE:
    dotnet retest [OPTIONS] [-- [dotnet test options]]

OPTIONS:
                        DEFAULT                                                 
    -h, --help                     Prints help information                      
        --version                  Prints version information                   
        --retries       3          Maximum retries when re-running failed tests 
        --no-summary               Whether to emit a summary to console/GitHub  
        --output                   Include test output in report                
    -v, --verbosity     Quiet      Output display verbosity:                    
                                   - quiet: only failed tests are displayed     
                                   - normal: failed and skipped tests are       
                                   displayed                                    
                                   - verbose: failed, skipped and passed tests  
                                   are displayed                                
        --gh-comment    True       Report as GitHub PR comment                  
        --gh-summary    True       Report as GitHub step summary                

NOTE: rendering the passed tests requires verbose verbosity, since typically you'll just want to see the failed tests in the report, especially in projects with large number of tests.

Install and Run latest:

dnx retest

Install:

dotnet tool install -g retest

Update:

dotnet tool update -g retest

Open Source Maintenance Fee

To ensure the long-term sustainability of this project, use of dotnet-retest requires an Open Source Maintenance Fee. While the source code is freely available under the terms of the MIT License, all other aspects of the project --including opening or commenting on issues, participating in discussions and downloading releases-- require adherence to the Maintenance Fee.

In short, if you use this project to generate revenue, the Maintenance Fee is required.

To pay the Maintenance Fee, become a Sponsor at the corresponding OSMF tier (starting at just $10!).

Sponsors

Learn more about GitHub Sponsors