README.md

group-runner

Group Rust executable output in GitHub logs

group-runner is useful, e.g., when you have lots of integration tests and seeing their output concatenated can be overwhelming.

Example output

Recommended usage

1. In your GitHub workflow, install group-runner:

   steps:
     - name: Install group-runner
       run: cargo install group-runner

2. Pass the following option to cargo run, cargo test, or cargo bench:

   --config "target.'cfg(all())'.runner = 'group-runner'"

   Example:

   steps:
     - name: Test
       run: cargo test --config "target.'cfg(all())'.runner = 'group-runner'"

   See The Cargo Book for more information.

Notes

• To avoid mixing build output with test output, we recommend building tests in a separate step prior to running them. Example:

  steps:
    - name: Build
      run: cargo test --no-run
    - name: Test
      run: cargo test --config "target.'cfg(all())'.runner = 'group-runner'"