This action runs isort on a Python repository.

It requires that the checkout action be used first.

Optional. Version of isort to use. Defaults to latest version of isort.

Optional. List of paths to sort, relative to your project root. Defaults to .

Optional. isort configuration options to pass to the isort CLI. Defaults to --check-only --diff.

Optional. Paths to python requirements files to install before running isort. If multiple requirements files are provided, they should be separated by a space. If custom package installation is required, dependencies should be installed in a separate step before using this action.

Output of the isort CLI.

name: Run isort
on:
  - push

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: isort/isort-action@v1
        with:
            requirements-files: "requirements.txt requirements-test.txt"

Before starting on a new feature, please review the contributing guide.

All PRs must pass the CI pipeline to be merged. To validate your code, you may run the test suite locally using docker compose. The full test suite can be run via docker compose run --rm lint, which will auto-format the code or add the --check-only flag to exit without formatting code.