codesorter 0.2.8

Command Line Interface

The simplest way to use CodeSorter is through the command-line interface:

# Sort a single file
codesorter my_file.py

# Sort all Python files in a directory
codesorter my_project/

# Sort with additional options
codesorter --help

Pre-commit Hook

Add CodeSorter to your pre-commit configuration to automatically sort code on every commit:

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/praw-dev/CodeSorter
    rev: v0.2.5
    hooks:
      - id: codesorter

Or use the check-only variant, which fails the hook without modifying files:

repos:
  - repo: https://github.com/praw-dev/CodeSorter
    rev: v0.2.5
    hooks:
      - id: codesorter-check

Programmatic Usage

You can also use CodeSorter programmatically:

import libcst as cst
from codesorter.sort_code import SortCodeCommand
from libcst.codemod import CodemodContext

# Parse your code
code = """
def z_function():
    pass

def a_function():
    pass
"""

# Create context and command
context = CodemodContext()
command = SortCodeCommand(context)

# Transform the code
result = command.transform_module(cst.parse_module(code))
print(result.code)

Function Sorting

• Functions are sorted alphabetically by name

• Global functions are sorted separately from class methods

Class Method Sorting

• Methods are grouped by kind, in this order:

  • @abstractmethod methods

  • pytest fixtures (autouse fixtures first)

  • @staticmethod methods

  • @classmethod methods

  • cached properties and @property methods (getter, then setter, then deleter)

  • @contextmanager methods

  • regular instance methods

• Within each group, methods are sorted alphabetically, with leading-underscore (_private and __dunder__) names ahead of public ones

Pytest Fixture Sorting

• Fixtures are sorted by scope (session, package, module, class, function)

• Within each scope, fixtures are sorted alphabetically

• autouse fixtures are handled specially

Example Transformation

Before:

class MyClass:
    def z_method(self):
        pass

    @property
    def a_property(self):
        pass

    @staticmethod
    def b_static():
        pass

After:

class MyClass:
    @staticmethod
    def b_static():
        pass

    @property
    def a_property(self):
        pass

    def z_method(self):
        pass

Setting Up Development Environment

# Clone the repository
git clone https://github.com/praw-dev/CodeSorter.git
cd CodeSorter

# Install with development dependencies
uv sync

# Install pre-commit hooks
uv run pre-commit install

Running Tests

# Run all tests
uv run pytest

# Run a specific test file
uv run pytest tests/test_sort_code.py

# Run the full tox matrix (tests, type, pre-commit)
uv run tox

Code Quality

The project uses several tools to maintain code quality:

• Ruff: Fast linting and formatting

• Pyright: Type checking

• Pre-commit: Automated quality checks

Run all quality checks:

uv run pre-commit run --all-files