SSort
The python source code sorter.
Sorts the contents of python modules so that statements are placed after the things they depend on, but leaves grouping to the programmer. Groups class members by type and enforces topological sorting of methods.
Makes old fashioned code navigation easier, you can always scroll up to see where something is defined, and reduces bikeshedding.
Compatible with and intended to complement isort and black.
Before:
from module import BaseClass
def function():
return _dependency()
def _decorator(fn):
return fn
@_decorator
def _dependency():
return Class()
class Class(BaseClass):
def public_method(self):
return self
def __init__(self):
pass
After:
from module import BaseClass
class Class(BaseClass):
def __init__(self):
pass
def public_method(self):
return self
def _decorator(fn):
return fn
@_decorator
def _dependency():
return Class()
def function():
return _dependency()
Installation
SSort can be installed manually using pip.
$ pip install ssort
Usage
To check that a file is correctly sorted use the --check flag. --diff can be passed to see what changes ssort would make.
$ ssort --check --diff path/to/python_module.py
To allow ssort to rearrange your file, simply invoke with no extra flags. If ssort needs to make changes to a black conformant file, the result will not necessarily be black conformant. The result of running black on an ssort conformant file will always be ssort conformant. We recommend that you reformat using isort and black immediately _after_ running ssort.
$ ssort src/ tests/ setup.py; isort src/ tests/ setup.py; black src/ tests/ setup.py
Output
ssort will sort top level statements and statements in classes.
- When sorting top level statements, ssort follows three simple rules:
-
- Statements must always be moved after the statements that they depend on, unless there is a cycle.
- If there is a cycle, the order of statements within the cycle must not be changed.
- If there is no dependency between statements then, to the greatest extent possible, the original order should be kept.
- ssort is more opinionated about the order of statements in classes:
-
- Class attributes should be moved to the top of the class and must always be kept in their original order.
- Lifecycle (__init__, __new__, etc) methods, and the methods they depend on, should go next.
- Regular methods follow, dependencies always ahead of the methods that depend on them.
- Other d'under methods should go at the end in a fixed order.
Links
- Source code: https://github.com/bwhmather/ssort
- Issue tracker: https://github.com/bwhmather/ssort/issues
- PyPI: https://pypi.python.org/pypi/ssort
License
The project is made available under the terms of the MIT license. See LICENSE for details.
2.4k Jan 08, 2023
5.3k Dec 29, 2022
123 Nov 12, 2022
106 Dec 17, 2022
2.4k Dec 27, 2022
146 Dec 13, 2022
6 Dec 26, 2022
653 Dec 30, 2022
51 Dec 08, 2022
3 Jan 23, 2022
4 Feb 07, 2022
1.4k Dec 26, 2022
385 Jan 06, 2023
1.4k Jan 04, 2023
4.1k Dec 28, 2022
0 Feb 22, 2022