Add build number to supported inputs options

[afinetooth]

Description

Let users substitute an alternate build number for the default build number: S{{ github.run_id }} .

• Add build-number to input options and pass it to the binary.
• Add a test to verify --build-number is correctly passed to coverage-reporter

Contributed by

• @brianatgather 🙏

Alternative Approach: Coveralls Environment Variables

Please note that substituting key input values, like build number (aka. service_number), so they are passed to the coverage-reporter binary from this github-action, is always possible through the use of Coveralls Environment Variables.

To substitute build number, use COVERALLS_SERVICE_NUMBER in your step config:

• Example: commit sha: - A common alternative to ${{ github.run_id }} that can be used to tie several GitHub Actions workflows together at Coveralls is commit sha (${{ github.sha }}), so a configuration like the one below will override the default (${{ github.run_id }}):

Parallel upload step:

    - name: Coveralls Parallel Upload
      uses: coverallsapp/github-action@v2
      env:
        COVERALLS_SERVICE_NUMBER: ${{ github.sha }} # default: ${{ github.run_id }}
      with:
        parallel: true
        flag_name: my-flag-name-1

In the case of this substitution, make sure you also pass it to the "Parallel finished" step, which requires the build number to find your build at Coveralls:

Parallel finished step:

    - name: Coveralls Finished
      uses: coverallsapp/github-action@v2
      env:
        COVERALLS_SERVICE_NUMBER: ${{ github.sha }}
      with:
        parallel-finished: true
        carryforward: "my-flag-name-1,my-flag-name-2"