Guides for SE student projects »

Using Codecov

Setting up Codecov with GitHub actions

Scenario: You have forked a project that already had support for using Codecov in the GitHub Actions CI pipeline. Now you want to set up your fork to work with Codecov as well.

Given below are the steps for achieving the above, recommended to be done by someone who has admin access to the GitHub organization that contains the fork.

1. Sign up for a Codecov account using your GitHub account.
2. Install the Codecov integration on GitHub::
   1. Go to this page and click on the green Install button.
   2. In the next page, select your GitHub organization
   3. In the next page, choose the Only select repositories and choose your repo (you can also use the All repositories option instead). After that, click the Install.
      
3. Sync your repo list in Codecov: Login to Codecov using your GitHub account. Ensure your org/fork is listed in the home page. If not, use the re-syncing link to sync Codecov data with GitHub (and refresh the page afterward).
   If the organization still fails to show up in the dropdown, proceed to the next step anyway (it's likely the syncing is done but the UI is not showing it).
4. Configure Codecov for the specific fork:
   1. Go to https://app.codecov.io/gh/{YOUR_ORG} (e.g., https://app.codecov.io/gh/my-team-org).
   2. Click the Configure option for your fork, and follow the instructions for GitHub Actions.
      You can skip the Step 1: Generate and upload coverage reports in your CI, as it is already set up in your repo.
      But you still need to do steps 2 i.e., set up the CODECOV_TOKEN secret as instructed but there.
      You can skip step 3 as well.
5. Check for coverage status: Go back to your Codecov home page, choose the org and click on the repo name. After the next time CI runs in your fork, you should see the code coverage percentage in front of your fork name. Here is an example:
6. Display the Codecov badge: If your fork has a badge showing the Codecov status (e.g, ), get the Markdown code for the Codecov badge provided in https://app.codecov.io/gh/{YOUR_ORG}/{YOUR_FORK}/settings/badge (e.g., https://app.codecov.io/gh/se-edu/addressbook-level3/settings/badge) and update the appropriate page in your fork.