README.md

swifty-code-coverage

A github action for generating code coverage report for your ios/macos/spm project.

Example

Here is an actual workflow (https://github.com/michaelhenry/create-report/actions/runs/2156329862) that uses this action and it produced a codecov report on this PR (michaelhenry/create-report#14).

Codecov

jobs:
  code-coverage-report:
    runs-on: ubuntu-latest
    steps:
      - name: Test
        uses: actions/checkout@v1
      - run: swift test --enable-code-coverage
      - uses: michaelhenry/[email protected]
        with:
          build-path: .build
          target: GithubChecksPackageTests.xctest
          is-spm: true
      - name: Upload to Codecov
        run: |
          bash <(curl https://codecov.io/bash) -f "coverage/*.info"
        shell: bash
        env:
          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

Code Climate

jobs:
  code-coverage-report:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v1
      - run: xcodebuild test -project App.xcodeproj -scheme App -configuration Debug -sdk iphonesimulator -destination 'platform=iOS Simulator,name=iPhone X,OS=13.0' -enableCodeCoverage YES -derivedDataPath DerivedData
      - uses: michaelhenry/[email protected]
        with:
          build-path: DerivedData
          target: App.app
          is-spm: false
      - name: Publish to code climate
        uses: paambaati/[email protected]
        env:
          CC_TEST_REPORTER_ID: ${{ secrets.CC_TEST_REPORTER_ID }}
        with:
          coverageLocations: |
            coverage/lcov.info:lcov

For some reason even though the code-coverage was generate from the same llvm version, codeclimate is returning an error " ./cc-test-reporter: cannot execute binary file: Exec format error" when using an ubuntu machine.

Note

If your project is an SPM project, please use the .xctest file as target which was generated from swift test --enable-code-coverage and set the is-spm to true.

Eg.

  - run: swift test --enable-code-coverage
  - uses: michaelhenry/[email protected]
    with:
      build-path: .build
      target: AppTests.xctest
      is-spm: true

Otherwise, if your project is an ios/macos that uses the xcodebuild test to test, please use the .app as target which was the file generated from the xcodebuild test -enableCodeCoverage YES and set the is-spm to false.

Eg.

  - run: xcodebuild test -project App.xcodeproj -scheme App -configuration Debug -sdk iphonesimulator -destination 'platform=iOS Simulator,name=iPhone X,OS=13.0' -enableCodeCoverage YES -derivedDataPath DerivedData
  - uses: michaelhenry/[email protected]
    with:
      build-path: DerivedData
      target: App.app
      is-spm: false

FAQ

How to ignore view controller files?

Just add the regex for *ViewController.swift as ignore-filename-regex param.

For example:

- uses: michaelhenry/[email protected]
  with:
    build-path: DerivedData
    target: Demo.app
    is-spm: false
    ignore-filename-regex: '^[\w,\s-]+ViewController\.swift$'

Don't want to use other third party code coverage service for the report or analysis?

You can still view the code coverage report from the logs(stdout) of llvm-cov report.

Eg.

Sample Apps or libraries that uses this action that you can use as guide.

• michaelhenry/Prettier.swift
• michaelhenry/create-report
• michaelhenry/SimpleXMLParser
• lukeredpath/swift-responsive-textfield
• shayan18/ApiClient-iOS