Skip to main content

`shed` canonicalises Python code.

Project description

shed

shed canonicalises Python code. Shed your legacy, stop bikeshedding, and move on. Black++

What does it do?

shed is the maximally opinionated autoformatting tool. It's all about convention over configuration, and designed to be a single opinionated tool that fully canonicalises my code - formatting, imports, updates, and every other fix I can possibly automate.

There are no configuration options at all, but if the defaults aren't for you that's OK - you can still use the underlying tools directly and get most of the same effect... though you'll have to configure them yourself.

shed must either be run in a git repo to auto-detect the files to format, or explicitly passed a list of files to format on the command-line.

Features

shed...

  • Runs ruff, to remove unused imports and variables, upgrade code, sort imports, and more.
  • Runs black, with autodetected minimum version >= py38
  • Formats code blocks in docstrings, markdown, and restructured text docs (based on blacken-docs).
  • If shed --refactor, also runs com2ann and custom refactoring logic using libcst. See documentation for the codemods in CODEMODS.md

The version detection logic is provided by black. Because shed supports the same versions of Python as upstream, it assumes that the minimum version is Python 3.8.

If you run shed in a Git repository, the name of the root directory is assumed to be a first-party import. src layout packages are also automatically detected, i.e. the foo in any paths like .../src/foo/__init__.py.

Jupyter Notebook support

We recommend using jupytext to save your notebooks in .py or .md files, in which case shed supports them natively. For a quick-and-dirty workflow, you can use nbqa shed notebook.ipynb - nbqa works for any linter or formatter.

Using shed in your editor

We recommend using black in your editor instead of shed, since it provides our core formatting logic and shed's extra smarts can be counterproductive while you're actively editing code - for example, removing an "unused" import just after you add it!

Then, when you're done editing, you can run shed from the command-line, pre-commit hooks, and your CI system.

Using shed with pre-commit

If you use pre-commit, you can use it with Shed by adding the following to your .pre-commit-config.yaml:

minimum_pre_commit_version: '2.9.0'
repos:
- repo: https://github.com/Zac-HD/shed
  rev: 2025.6.1
  hooks:
    - id: shed
      # args: [--refactor, --py311-plus]
      types_or: [python, pyi, markdown, rst]

This is often considerably faster for large projects, because pre-commit can avoid running shed on unchanged files.

See also

shed inherits pyupgrade's careful approach to converting string formatting code. If you want a more aggressive refactoring tool and don't mind checking for breaking changes, check out flynt.

For Django upgrades, see django-codemod or django-upgrade.

The ssort project sorts the contents of python modules so that statements are placed after the things they depend on, for easier navigation and consistency of design.

Semgrep supports some autofixes, with patterns for a wide variety of languages. This includes a variety of both security and style checks, with manual inspection of results recommended.

Changelog

Patch notes can be found in CHANGELOG.md.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shed-2025.6.1.tar.gz (39.8 kB view details)

Uploaded Source

Built Distribution

shed-2025.6.1-py3-none-any.whl (36.5 kB view details)

Uploaded Python 3

File details

Details for the file shed-2025.6.1.tar.gz.

File metadata

  • Download URL: shed-2025.6.1.tar.gz
  • Upload date:
  • Size: 39.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for shed-2025.6.1.tar.gz
Algorithm Hash digest
SHA256 43d056a2495172194ed23ee7738c49cde9cc3a54abbfa6178d5b70fd32b1a3b2
MD5 9d702160a8b51f5b94a6140bda62bcd6
BLAKE2b-256 74c53c8d41c902a0b453b6423779d938f703948bd6f023a6eaecd1c7a86eefc6

See more details on using hashes here.

File details

Details for the file shed-2025.6.1-py3-none-any.whl.

File metadata

  • Download URL: shed-2025.6.1-py3-none-any.whl
  • Upload date:
  • Size: 36.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for shed-2025.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a238f34be0f040bdd705e4cbdaf3f98cdd30db832c34ca542037c8462556eb2a
MD5 e493eaa5aed67fe69d03b88f784077dc
BLAKE2b-256 e4eb76f3dad9f509ef744c925ef374d5b814fafbdf7d4c8da19772717edb21ad

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page