A GitHub Action to generate a report that contains code frequency metrics and programming languages used per repository belonging to a GitHub organization.

The example workflow below runs on a monthly schedule using the amount of weeks as an interval set in the workflow (default 4 weeks) and alternatively can also be triggered manually using a workflow_dispatch event.

name: Code Frequency Action

on:
  schedule:
    # Runs on the first day of the month at 00:00 UTC
    #
    #        ┌────────────── minute
    #        │ ┌──────────── hour
    #        │ │ ┌────────── day (month)
    #        │ │ │ ┌──────── month
    #        │ │ │ │ ┌────── day (week)
    - cron: '0 0 1 * *'
  workflow_dispatch:
    inputs:
      fromdate:
        description: 'Optional interval start date (format: yyyy-mm-dd)'
        required: false # Skipped if workflow dispatch input is not provided
      todate:
        description: 'Optional interval end date (format: yyyy-mm-dd)'
        required: false # Skipped if workflow dispatch input is not provided

jobs:
  code-frequency-report:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v3

      - name: Code Frequency Report
        uses: nicklegan/github-org-code-frequency-action@v2.1.0
        with:
          token: ${{ secrets.ORG_TOKEN }}
          fromdate: ${{ github.event.inputs.fromdate }} # Used for workflow dispatch input
          todate: ${{ github.event.inputs.todate }} # Used for workflow dispatch input
        # org: ''
        # weeks: '4'
        # sort: 'additions'
        # sort-order: 'desc'
        # json: 'false'
        # appid: ${{ secrets.APPID }}
        # privatekey: ${{ secrets.PRIVATEKEY }}
        # installationid: ${{ secrets.INSTALLATIONID }}

💡 Disable token expiration to avoid failed workflow runs when running on a schedule.

The additional option to retrieve code frequency data using a custom date interval. If the below fields are left empty during workflow dispatch input, the default interval option of set weeks from the current date configured in main.yml will be used instead.

💡 The result data includes the weeks which have their start date (Sunday 00:00:00 GMT) within the set interval.

The results of the 2nd and 3rd report column will be the sum of code frequency date for the selected interval per organization repository.

A CSV report file to be saved in the repository reports folder using the following naming format: organization-date-interval.csv.

As an alternative you can use GitHub App authentication to generate the report. For larger organizations it is recommended to use this method as more API requests per hour are allowed which will avoid running into rate limit errors.

Register a new organization/personal owned GitHub App with the below permissions:

After registration install the GitHub App to your organization. Store the below App values as secrets.