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.

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:

dotnet tool install -g dotnet-retest

Update:

dotnet tool update -g dotnet-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