PyPI · #3658 most downloaded on PyPI

usort

1.1.31.2M downloads/mofacebook/usort ↗New releases in your daily digest, changelog included.

Safe, minimal import sorting

Last release 8 months ago
13 Jan 2026
Ships unpredictably
gaps range from 2 weeks to 1.7 years
Nearly every release is documented
notes for 19 of 20 stable releases
1 version withdrawn
withdrawn after publishing
7 years old
29 releases · first in 2020

Release timeline

29 releases since 2020

2020202120222023202420252026

20202026

One column per quarter.

Releases

1.1.313 Jan 2026
Nothing published for this version
1.1.29 Jan 2026
Fixes bug that splits one line import statements with comments
Fixes bug that splits one line import statements with comments
Open source →
1.1.15 Jan 2026
Adds new option, preserve_inline_comments, to keep inline comments wh…
Adds new option, preserve_inline_comments, to keep inline comments wh…
Open source →

What's Changed

Split basic import statements with multiple imported names by @amyreese in #141
Don't use trailrunner to format exactly one file by @Bobronium in #160
Optimize passing multiple paths to usort CLI by @amyreese in #161
Lean on click for making Path objects for us by @amyreese in #162
Skip deep copying CST after parsing by @zsol in #167
Skip visiting CST nodes that cannot have import statements by @zsol in #187
Make sure indentation is tracked by @zsol in #188
Avoid KeyError when imports are duplicated. by @thatch in #195
PEP 621 project metadata by @amyreese in #154
Treat lines with multiple statements as barriers by @amyreese in #204
Script and CI action to validate backwards compatibility by @amyreese in #205
Versioning Guide by @amyreese in #148
Uniformly collapse blank lines within a category by @amyreese in #201
Switch from requirements files to PEP621 optional dependencies by @amyreese in #237
Update copyright statement on website by @zpao in #265
remove py27 only modules from known stdlib by @pmeier in #266
Update RTD config by @amyreese in #279
Test on 3.12 by @amyreese in #284
Fix docs deps, add docs build job by @amyreese in #285
Drop support for <=3.9 by @bowiechen in #330

New Contributors

@Bobronium made their first contribution in #160
@zpao made their first contribution in #265
@pmeier made their first contribution in #266
@bowiechen made their first contribution in #330

Full Changelog: v1.0.8...v1.1.0

Open source →

Additional notes3 sources agree

In addition to changes in 1.1.0b1 and 1.1.0b2, this release drops support for Python versions below 3.9.

Open source →

1.1.0b227 Mar 2023pre-release

New magic_commas option to force multi-line import style like black ( #252 , #247 )

New magic_commas option to force multi-line import style like black (#252, #247)
Fix dropped inline comments on last import item without trailing comma (#251, #249)

Open source →

Additional notes3 sources agree

Beta release

New magic_commas option to force multi-line import style like black (#252, #247)
Fix dropped inline comments on last import item without trailing comma (#251, #249)

$ git shortlog -sn v1.1.0b1...
     5  Amethyst Reese

Open source →

1.1.0b112 Mar 2023pre-release3 sources agree

Splits basic import statements with multiple names

Beta release

Splits basic import statements with multiple names (#140)
Uniformly collapse blank lines within a category (#201)
Support 3.10+ syntax by enabling the LibCST native parser by default (#244)
Drop support for Python 3.6 (#154)

$ git shortlog -sn v1.0.5...
    44  Amethyst Reese
    37  dependabot[bot]
     5  Zsolt Dollenstein
     4  Loren Arthur
     1  Arseny Boykov
     1  Tim Hatch

Open source →

1.0.812 Feb 2024

Added py.typed marker Updated RTD build config

Added py.typed marker
Updated RTD build config

Open source →

Additional notes3 sources agree

Maintenance release

Added py.typed marker
Updated RTD build config

$ git shortlog -sn v1.0.7...
     2  Amethyst Reese

Open source →

1.0.731 May 20234 sources agree

Added pre-commit hook for usort ( #261 , #260 )

Added pre-commit hook for usort (#261, #260)
Fixed tests for LibCST 1.0 release and native parser

$ git shortlog -sn v1.0.6...
     3  Amethyst Reese

Open source →

1.0.627 Mar 2023

Fix dropped inline comments on last import item without trailing comma ( #251 , #249 )

Fix dropped inline comments on last import item without trailing comma (#251, #249)

Open source →

Additional notes3 sources agree

Bugfix release

Fix dropped inline comments on last import item without trailing comma (#251, #249)

$ git shortlog -sn v1.0.5...
     4  Amethyst Reese

Open source →

1.0.514 Sept 2022Deprecated3 sources agree

Deprecated: Python 3.6 support will be dropped in v1.1.0

Bugfix release

Fix AssertionError when sorting multiple statements on one line (#203, #204)
Deprecated: Python 3.6 support will be dropped in v1.1.0 (#154)

$ git shortlog -sn v1.0.4...
     4  Amethyst Reese

Open source →

1.0.41 Aug 20223 sources agree

Make sure indentation is tracked

Bugfix release

Make sure indentation is tracked (#188)

$ git shortlog -sn v1.0.3...
     1  Amethyst Reese

Open source →

1.0.327 Jul 2022withdrawn: https://github.com/facebookexperimental/usort/pull/1883 sources agree

Skip visiting CST nodes that cannot have import statements

Bugfix release

Skip visiting CST nodes that cannot have import statements (#187)
Skip deep copying CST after parsing (#167)
Optimize passing multiple paths to usort CLI (#161)
Don't use trailrunner to format exactly one file (#160)

$ git shortlog -sn v1.0.2...
     2  Amethyst Reese
     2  Zsolt Dollenstein
     1  Arseny Boykov

Open source →

1.0.27 Mar 20223 sources agree

Fix unstable sorting from basic imports with mixed categories (#145, #146)

Bugfix release

Fix unstable sorting from basic imports with mixed categories (#145, #146)
Fix documentation examples (#142)
Updated stdlibs for Python 3.10 (#138)

$ git shortlog -sn v1.0.1...
     7  dependabot[bot]
     5  Amethyst Reese
     2  Tim Hatch

Open source →

1.0.127 Jan 20223 sources agree

Handle single line from-imports with parens

Bugfix release

Handle single line from-imports with parens (#128)
Significant speedup when sorting files that don't produce warnings (#126)
Documentation for the "Why µsort" topic (#130)
Updated copyright, attribution, and logos to Meta Platforms, Inc (#131)
Dependency updates

$ git shortlog -sn v1.0.0...
    14  Amethyst Reese
    12  dependabot[bot]
     3  Zsolt Dollenstein

Open source →

1.0.017 Dec 2021Deprecated3 sources agree

Deprecation: usort_bytes() and usort_string() replaced by usort()

Feature release

New feature: sorting items in a single import statement (#81)
New feature: merging imports from the same module (#81)
Supports usort:skip directives on first and last line of multi-line imports (#108)
Supports usort:skip directives that aren't the first comment directive on a line (#108)
Deprecation: usort_bytes() and usort_string() replaced by usort() (#88)
Fix reading the configured black line length from pyproject.toml (#110)
Improved performance by sorting multiple files in parallel (#70)
Officially support Python 3.10 (#74)
Documentation improvements (#91, #108, #109)

$ git shortlog -sn v0.6.4...
   104  Amethyst Reese
    18  dependabot[bot]
     7  Tim Hatch
     3  Jason Fried

Open source →

1.0.0rc115 Dec 2021pre-release3 sources agree

Supports usort:skip directives on first and last line of multi-line imports

Release Candidate:

Supports usort:skip directives on first and last line of multi-line imports (#108)
Supports usort:skip directives that aren't the first comment directive on a line (#108)
Fix reading the configured black line length from pyproject.toml (#110)
Documentation improvements (#108, #109)

git shortlog -sn v1.0.0b1...
    10  Amethyst Reese

Open source →

1.0.0b113 Dec 2021pre-releaseDeprecated3 sources agree

Deprecation: usort_bytes() and usort_string() replaced by usort()

Beta release

Deprecation: usort_bytes() and usort_string() replaced by usort() (#88)
Improved documentation in user guide for sorting, merging, comments, and associations (#91)
Fixed bug when merging imports and subsequent blocks (#86)
Fixed output of basic imports that exceed line length (#87)

$ git shortlog -sn v1.0.0a1...
    28  Amethyst Reese
    13  dependabot[bot]
     3  Jason Fried

Open source →

1.0.0a126 Oct 2021pre-release3 sources agree

New feature: sorting items in a single import statement

Alpha release

New feature: sorting items in a single import statement (#81)
New feature: merging imports from the same module (#81)
Improved performance by sorting multiple files in parallel (#70)
Officially support Python 3.10 (#74)

$ git shortlog -sn v0.6.4...
    62  Amethyst Reese
     7  Tim Hatch
     5  dependabot[bot]

Open source →

0.6.42 Apr 20213 sources agree

Fix incomplete stdlib detection by using "stdlibs" from pypi

Bugfix release

Fix incomplete stdlib detection by using "stdlibs" from pypi (#56)

$ git shortlog -sn v0.6.3...
     1  Amethyst Reese
     1  Tim Hatch

Open source →

0.6.319 Feb 20213 sources agree

Enforce blank lines before comments within a category

Bugfix release

Enforce blank lines before comments within a category (#50)
Fix config finding with relative paths (#43, #53)
Correctly handle encodings in LibCST (#46, #54)
Sort usort with usort (#51)
Officially support Python 3.9 (#50)

$ git shortlog -sn v0.6.2...
    11  Tim Hatch
     3  Amethyst Reese

Open source →

0.6.218 Nov 20203 sources agree

Option to disable first-party heuristic

Minor release

Option to disable first-party heuristic (#47)

$ git shortlog -sn v0.6.1...
     1  Amethyst Reese
     1  Tim Hatch

Open source →

0.6.117 Nov 20203 sources agree

Improve error messages, especially for parsing errors

Minor release

Improve error messages, especially for parsing errors (#45)

$ git shortlog -sn v0.6.0...
     7  Amethyst Reese
     1  Tim Hatch

Open source →

0.6.027 Oct 20203 sources agree

Add support for configurable side-effect modules as block separators

Add support for configurable side-effect modules as block separators (#39)
Rename default_section option to default_category (#41)

$ git shortlog -sn v0.5.0...
    11  Amethyst Reese
     2  Tim Hatch

Open source →

0.5.016 Oct 20203 sources agree

Fixes case insensitive handling for stdlib modules like cProfile

Initial public release

Fixes case insensitive handling for stdlib modules like cProfile (#37)
Added timing metrics for walking file trees, parsing files, and sorting (#35)
Added a maintainer's guide (#36)
Documentation fixes

$ git shortlog -sn
    34  Tim Hatch
    28  Amethyst Reese
     2  Facebook Community Bot

Open source →

0.5.0a330 Sept 2020pre-release3 sources agree

Improved detection of shadowed imports

Improved detection of shadowed imports (#24)
Normalizes to one blank line between categories (#22)
Ensure case-insensitive sorting order (#19)
Fixed import sorting outside of global scope (#15)
Added support for formatting stdin with usort format - (#12)
Moved diff/check functionality into separate diff and check commands (#12)
Replaced usort format --show-time with usort --benchmark framework (#12)
Added custom section names (#13)
Includes sphinx docs (#7)
Corrects missing toml dep (#11)

Open source →

0.5.0a221 Aug 2020pre-release3 sources agree

Automatic finding of first-party dirs

Automatic finding of first-party dirs
Skip entries marked # usort:skip or #isort:skip
Uses .with_changes on the libcst module object

Open source →

0.0.023 Jan 20202 sources agree

* Reserving name on pypi.

Reserving name on pypi.

Open source →

Additional notes

Reserving name on pypi.

| Page source

Open source →