isort

Sort imports in file

$ isort [file.py]

$ isort --check-only [file.py]

$ isort --diff [file.py]

$ isort .

$ isort --profile black [file.py]

isort [options] [path...]

isort sorts Python imports alphabetically and automatically separates them into sections following PEP 8 guidelines. It groups imports into standard library, third-party, and local application sections with blank lines between each group.
The tool integrates with popular formatters like Black through profiles, and can be used in editor plugins, pre-commit hooks, and CI pipelines to enforce consistent import ordering across a codebase.

--check-only

Check without modifying.

Show changes as diff.

Use predefined profile (black, django, pycharm).

Line length limit.

One import per line.

Skip files matching pattern.

Display help information.

pyproject.toml `[tool.isort]`

Preferred configuration location. Supports all isort settings including profile, linelength, and knownthird_party.

Alternative configuration in setup.cfg format.

Dedicated isort configuration file, searched in the project root.

Python-specific. May conflict with other formatters without proper profile configuration. Use profiles for compatibility with Black or other tools.

isort was created by Timothy Crosley to automatically sort and organize Python imports following best practices.

black(1), flake8(1), autopep8(1), pylint(1)