Diff Calculator

CLI and Github Action pack for calculating the diff between two git revisions.
It can be configured to ignore comments, deletions, and whitespaces, so you can focus on the actual changes.

• Diff Calculator
  • CLI
    • Installation
    • Example Usage
    • CLI Example
  • Github Action
    • Example Usages
      • 1. Fail step if the PR has more than 300 lines changed
      • 2. Label the PR based on the diff size
  • Ignoring Files

CLI

CLI is available through npm, yarn and pnpm.

Installation

npm install -g @themoin/diff-calculator-cli
yarn global add @themoin/diff-calculator-cli
pnpm install -g @themoin/diff-calculator-cli

Example Usage

Run the following command to see the how to use the CLI

calcdiff --help

CLI Example

# To check the diff between origin/dev and HEAD with comment, delete and whitespace ignored
calcdiff origin/dev -w -d -c

# To check the diff between origin/dev and origin/feat/something, and only show the total number of lines changed
calcdiff origin/dev origin/feat/something -q

# To check the diff between origin/dev and HEAD with comment, delete and whitespace ignored, and show the verbose output
calcdiff origin/dev -w -d -c -v

Github Action

The Github Action is available through the marketplace. See action.yaml for the available inputs and outputs.

Please note that you must call @actions/checkout@v4 action with the fetch-depth: 0 to get the full git history. It's because this action use git diff command to calculate diff

Example Usages

1. Fail step if the PR has more than 300 lines changed

jobs:
  check-pr-size:
    steps:
      # This step is required to get the full git history. Or you can use another way you prefer.
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Calculate diff size
        id: get-pr-size
        uses: themoin/[email protected]
        with:
          source: origin/${{ github.head_ref }}
          target: origin/${{ github.base_ref }}
          ignore-deletion: true
          ignore-whitespace: true
          ignore-comment: true
      - name: Fail if the PR has more than 300 lines changed
        run: |
          if [ ${{ steps.get-pr-size.outputs.size }} -gt 300 ]; then
            echo "The PR has more than 300 lines changed"
            exit 1
          fi

2. Label the PR based on the diff size

jobs:
  label-pr-size:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Calculate diff size
        id: get-pr-size
        uses: themoin/[email protected]
        with:
          source: origin/${{ github.head_ref }}
          target: origin/${{ github.base_ref }}
          ignore-deletion: true
          ignore-whitespace: true
          ignore-comment: true
      - name: Label PR size
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          VALUE=${{ steps.get-pr-size.outputs.size }}
          if [ $VALUE -le 10 ]; then
            LABEL="size/10"
          elif [ $VALUE -le 100 ]; then
            LABEL="size/100"
          elif [ $VALUE -le 200 ]; then
            LABEL="size/200"
          elif [ $VALUE -le 300 ]; then
            LABEL="size/300"
          else
            LABEL="size/300+"
          fi
          LABEL_EXISTS=$(gh label list --search $LABEL)
          if [ -z "$LABEL_EXISTS" ]; then
            echo "Creating label $LABEL"
            gh label create $LABEL -c 000000
          fi
          EXISTING=$(gh pr view ${{ github.event.number }} --json labels --jq ".labels[].name" | grep "^size/" || true)
          if [ -z "$EXISTING" ]; then
            echo "Adding label $LABEL"
            gh pr edit ${{ github.event.number }} --add-label $LABEL
          elif [ $EXISTING = $LABEL ]; then
            echo "Label is already set to $LABEL"
          else
            echo "Removing label $EXISTING and adding label $LABEL"
            gh pr edit ${{ github.event.number }} --remove-label $EXISTING
            gh pr edit ${{ github.event.number }} --add-label $LABEL
          fi

Ignoring Files

Both CLI and Github Action support ignoring files by providing a .gitdiffignore file in the root of the repository. Its format is the same as .gitignore file. See the specification of .gitignore.