This is the first beta for isort 10. This version will contain a breaking style change to align the handling of non-aliased from imports (e.g., from package import module) with ruff and fix some related bugs.
Like ruff, isort will now group these imports into one statement. For example: from package import module, module_two.

Please let us know whether this change causes unintended problems in your projects.

There are a couple of less signficiant breaking changes discussed below.

💥 Breaking Changes

• Group non-aliased from imports by @DanielNoord in #2614
• Drop Python 3.10 support by @DanielNoord with @Copilot in #2697
• Remove shebang-based file detection by @DanielNoord with @Copilot in #2701
  Previously isort would open every file in the passed directories to see whether they contained a Python shebang line and then format these files. This is no longer supported and only files with the selected file extensions will be formatted. Not opening every file it encounters speeds up isort significantly.
• Unify --version CLI arguments and always show quick guide by @DanielNoord in #2726

🚀 Features

• Interpret \t in the indent setting as a tab by @shan3520 in #2708

🪲 Fixes

• Keep the multiline layout of a sorted literal that has a trailing comment by @youdie006 in #2686
• Fix combine_straight_imports mixing up module names on long lines by @APX403 in #2724
• Respect extension filters for explicit files with --filter-files by @00200200 in #2720* Keep an import that follows an indented import block with lines_before_imports by @Eljees in #2672
• Preserve atomic Cython output for write-only streams by @xiehuanyi in #2721
• grid: preserve trailing comment when no line wrap is needed by @Master-Norna in #2675

Other changes

• Bump the uv group with 4 updates by @dependabot[bot] in #2700
• Bump urllib3 from 2.7.0 to 2.8.0 by @dependabot[bot] in #2702
• Update dependencies in playground by @DanielNoord in #2713
• Several small typing improvements by @DanielNoord in #2714
• Document how imports are classified into sections by @abdull-ah-med in #2722
• Small cleanup before release by @DanielNoord in #2731

Full Changelog: 9.0.2...10.0.0b1

🪲 Fixes

• Preserve blank lines before comment-only sections by @fzlzjerry in #2655
• Preserve trailing-comma layout when sorting reexports by @PSR94 in #2605
• fix: treat EOF on stdin as 'quit' in --interactive prompt by @Eljees in #2653
• Fix multi_line_output=10 emitting unparsable code around trailing comments by @dylanpulver in #2651
• Stop configuration discovery at Git worktree boundaries by @vzer200 in #2654
• fix: preserve trailing comments when sorting literals by @Manny7717 in #2647
• Preserve LF stdin output on Windows by @AleksZyro in #2616
• Handle star imports better when using parenthesis by @DanielNoord in #2665
• Sort unwrapped lines in force_sort_within_sections by @DanielNoord in #2667
• Preserve file line endings when sorting reexports by @vyrnsynx in #2669
• Fix float_to_top hoisting indented semicolon imports by @Pajimo in #2671
• Preserve CRLF blank lines during float-to-top preprocessing by @hansu650 in #2683
• mypy: type-check tests and use pathlib fixtures by @DanielNoord in #2685

Other changes

• Fix codecov build reports by @DanielNoord in #2666
• Refactors in process by @DanielNoord in #2677
• Core developers revision by @staticdev in #2691

Full Changelog: 9.0.1...9.0.2

🪲 Fixes

• Restore python -m isort by excluding __main__ from mypyc compilation by @DanielNoord with @Copilot in #2643

Other changes

• Add changelog entries for last releases by @DanielNoord in #2641

Full Changelog: 9.0.0...9.0.1

isort 9.0.0 is the result of several alpha and beta releases, as well as a small number of fixes added after the last beta. For release notes for the individual alphas and betas we would like to refer to:

• 9.0.0a2
• 9.0.0a3
• 9.0.0b1
• 9.0.0b2
• 9.0.0b5

Skipped version numbers are the result of changes to our release infrastructure that broke while creating the actual releases.

Please find below the full release notes for version 9.0.0, the newest release of isort after version 8.0.1.

isort 9.0.0 contains some significant changes and improvements. Most notably there is now support for Python 3.15 and its lazy imports and we have included several performance improvements as well as providing mypyc compiled wheels for all major platforms and supported versions of Python. In our own tests we saw speeds ups of more than 2x and 3x times, but this is highly dependent on the codebase isort needs to inspect.

The full list of changes is as follows:

💥 Breaking Changes

• Remove logic for deprecated options (#2498) @DanielNoord

🚀 Features

• Sort lazy import statements (#2503) @DanielNoord
• Add initial support for Python 3.15 (#2466) @DanielNoord
• Compile with mypyc by @DanielNoord in #2586
• Cache calls to posixpath.abspath by @DanielNoord in #2606
• Consider private stdlib modules to be stdlib (#2295) @devdanzin
• Add CLI Flag for --forced-separate (#2367) @hirak99
• Add separate_packages option (#2313) @alex-liang3

🪲 Fixes

• Fix inline comment duplication across merged from X import lines (#2499) @copilot-swe-agent
• Fix src glob patterns passed via CLI (#2497) @ReinerBRO
• Fix opening-line comment moving to alias attribute line on wrapped imports (#2491) @copilot-swe-agent
• Fix multi_line_output=3/5 ignored when wrapping single imports with inline comments (#2474) @copilot-swe-agent
• Fix false positive in check_code when using float_to_top + add_imports (#2492) @copilot-swe-agent
• Fix: preserve bare # inline comments on imports (#2488) @copilot-swe-agent
• Fix grouping of non-aliased imports when mixed with aliased imports from the same module (#2470) @copilot-swe-agent
• Fix #2500: trusted publishing by @staticdev in #2521
• Fix git_hook lazy=True option by @sparrowt in #2542
• Honor # isort: off/on/split during float_to_top preprocessing with CRLF input by @DanielNoord with @Copilot in #2553
• Fix --sort-reexports crash with non-seekable streams (e.g. stdin) by @Abdu-Ahmed in #2547
• Fix non-idempotent output with split_on_trailing_comma and a non-default wrap mode by @sarathfrancis90 in #2554
• Fix non-idempotent NOQA wrap mode with imports that carry their own comment by @sarathfrancis90 in #2556
• Fix NOQA wrap mode accumulating spaces before the comment on each run by @sarathfrancis90 in #2558
• Fix NOQA not added to long imports in several output paths by @urayoru113 in #2568
• Honor # isort: skip when a __future__ import is present (#2092) by @apoorvdarshan in #2574
• fix: make sorted __all__ and literals black-compatible (#2280) by @lord-haffi in #2576
• Honor skip comments when sorting reexports by @sakshichitnis27 in #2581
• Keep aliased import when the plain name carries a comment by @sarathfrancis90 in #2567
• fix: don't crash on --config-root without --resolve-all-configs by @Gooh456 in #2597
• fix: check_code misses lines_before_imports-only changes (#2242) by @gaoflow in #2563
• Fix preservation of form-feed blank lines by @utkarshalpha in #2599
• Small clean up and fix inconsistency in handling of * imports by @DanielNoord in #2619
• Fix word-wrapping of 'from ... import *' into invalid Python (#2267) by @sudorm-rf0 in #2624
• Fix pylint disable-next comments at the start of imports by @Neallin-917 in #2628
• Keep add_imports below a prefixed module docstring by @Eljees in #2626

Other changes

• Add read the docs configuration (#2504) @DanielNoord
• Remove unused and broken dependencies (#2517) @DanielNoord
• Remove Any from parse.py (#2516) @DanielNoord
• Bring documentation in line with old documentation (#2507) @DanielNoord
• Sync profile docs with implementation (#2495) @copilot-swe-agent
• Fix the playground (#2494) @DanielNoord7) @hirak99
• Remove unused _ENCODING_PATTERN regex and re import by @duriantaco in #2525
• Remove references to defunct git_ignore config by @sparrowt in #2531
• Fix broken relative links in README and CHANGELOG for both GitHub and Sphinx by @rohitshinde08 in #2530
• Bump vendored tomli by @DanielNoord in #2579
• Document temporary .isorted files by @sapunyangkut in #2580
• Remove cruft by @DanielNoord in #2610
• Small fixes in preparation for mypyc compiled wheels by @DanielNoord in #2623
• Small fixes in preparation for compiling with mypyc by @DanielNoord in #2625
• Fix test_importable for local dev by @DanielNoord in #2635

Full Changelog: 8.0.1...9.0.0

Please see the release notes of 9.0.0a2, 9.0.0a3, 9.0.0b1 and 9.0.0b2 for additional changes compared to the last full release.

isort now provides wheels that contain code compiled with mypyc. Depending on your use of isort this can provide a 10% reduction in the time it takes for isort to check your code.

🚀 Features

• Compile with mypyc by @DanielNoord in #2586

Other changes

• Remove cruft by @DanielNoord in #2610
• Small fixes in preparation for mypyc compiled wheels by @DanielNoord in #2623
• Small fixes in preparation for compiling with mypyc by @DanielNoord in #2625

This was never released due to issues with our release infrastructure. Please refer to 9.0.0b5.

This was never released due to issues with our release infrastructure. Please refer to 9.0.0b4.

Please see the release notes of 9.0.0a2, 9.0.0a3 and 9.0.0b1 for additional changes compared to the last full release.

🚀 Features

• Cache calls to posixpath.abspath by @DanielNoord in #2606

🪲 Fixes

• Honor skip comments when sorting reexports by @sakshichitnis27 in #2581
• Keep aliased import when the plain name carries a comment by @sarathfrancis90 in #2567
• fix: don't crash on --config-root without --resolve-all-configs by @Gooh456 in #2597
• fix: check_code misses lines_before_imports-only changes (#2242) by @gaoflow in #2563
• Fix preservation of form-feed blank lines by @utkarshalpha in #2599
• Small clean up and fix inconsistency in handling of * imports by @DanielNoord in #2619

Other changes

• Bump vendored tomli by @DanielNoord in #2579
• Document temporary .isorted files by @sapunyangkut in #2580

Please see the release notes of 9.0.0a2 and 9.0.0a3 for additional changes compared to the last full release.

🪲 Fixes

• Fix git_hook lazy=True option by @sparrowt in #2542
• Honor # isort: off/on/split during float_to_top preprocessing with CRLF input by @DanielNoord with @Copilot in #2553
• Fix --sort-reexports crash with non-seekable streams (e.g. stdin) by @Abdu-Ahmed in #2547
• Fix non-idempotent output with split_on_trailing_comma and a non-default wrap mode by @sarathfrancis90 in #2554
• Fix non-idempotent NOQA wrap mode with imports that carry their own comment by @sarathfrancis90 in #2556
• Fix NOQA wrap mode accumulating spaces before the comment on each run by @sarathfrancis90 in #2558
• Fix NOQA not added to long imports in several output paths by @urayoru113 in #2568
• Honor # isort: skip when a future import is present (#2092) by @apoorvdarshan in #2574
• fix: make sorted all and literals black-compatible (#2280) by @lord-haffi in #2576

Other changes

• Remove unused _ENCODING_PATTERN regex and re import by @duriantaco in #2525
• Remove references to defunct git_ignore config by @sparrowt in #2531
• Fix broken relative links in README and CHANGELOG for both GitHub and Sphinx by @rohitshinde08 in #2530

What's Changed

• Fix #2500: trusted publishing by @staticdev in #2521

Full Changelog: 9.0.0a2...9.0.0a3