lint-changes - v1.0.0

lint-changes

A CLI, API, and GitHub Action for running ESLint only on changed files. The GitHub Action also automatically compares the current branch against its base branch.

GitHub Action

Use this GitHub Action in a pull request or push trigger via electrovir/lint-changes@latest. The action has two inputs:

  • eslintArgs: a single string of args to pass to ESLint. example: --config configs/my-eslint.config.js
  • pastSetupCommand: the command needed to setup your repo's past state for linting. Defaults to just npm ci. example: npm ci && npm run compile

GitHub Action example

name: Lint changes

on:
pull_request:
branches:
- '**'

# this lint script is relatively expensive, so it's a good idea to cancel concurrent runs
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true

jobs:
lint-changes:
name: Lint Changes
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4.1.1
with:
# Fetch the whole git tree so the action can checkout the base ref.
fetch-depth: 0
- uses: electrovir/lint-changes@latest
with:
# Neither of this inputs are required, these are just examples of how to assign them.
eslintArgs: '--config configs/my-eslint.config.js'
pastSetupCommand: 'npm ci && npm run compile'

CLI

You can use this package via your CLI:

  1. install via npm: npm i lint-changes
  2. run the command: lint-changes

CLI args

The CLI args are the same as the API args (listed here: http://electrovir.github.io/lint-changes/variables/apiArgsShape.html). Each arg should be prefixed with -- and use =<value> for assignment. Like this: --checkoutBaseRef=true or --baseRef=main.

Any other arguments not expected by this API are passed directly to ESLint.

API

You can use this package programmatically:

  1. install via npm: npm i lint-changes

  2. use the exposed API:

    import {lintChanges} from 'lint-changes';

    await lintChanges();

For documentation on the API's inputs, outputs, and other exposed functions, see the full docs here: http://electrovir.github.io/lint-changes/functions/lintChanges.html