Posters: Shed: the maximal autoformatter

Presented by:


Description

You might have heard of the black autoformatter: you agree to cede control over minutiae of hand-formatting, and Black gives you speed, determinism, and freedom from formatting concerns - letting you save time and mental energy for more important matters.

shed thinks the only problem with black is that it doesn't go far enough.

  • Want your imports sorted, and unused imports removed? shed does that (via autoflake & isort).
  • Want old code constructs updated to new syntax? shed does that too (via pyupgrade).
  • Want to convert type comments to proper annotations? shed does that too!
  • Want to format code examples in your docs? shed handles .md or .rst files as well as docstrings.

And the best part? You don't - in fact, can't - configure `shed.

shed auto-detects your Python version by inspecting the code, your first-party imports by looking for src/ layout packages... and can even find your Python files using git.

Stop bikeshedding. Use shed.