`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
autoflake
, to remove unused imports and variables - Runs
pyupgrade
, with autodetected minimum version >= py37 - Runs
isort
, with autodetected first-party imports and--ca --profile=black
args - Runs
black
, with autodetected minimum version >= py37 - Formats code blocks in docstrings, markdown, and restructured text docs
(like
blacken-docs
). - If
shed --refactor
, also runscom2ann
and custom refactoring logic usinglibcst
.
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.7.
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: 0.10.1
hooks:
- id: shed
# args: [--refactor, --py39-plus]
types_or: [python, 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
.
Changelog
Patch notes can be found in CHANGELOG.md
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file shed-0.10.1.tar.gz
.
File metadata
- Download URL: shed-0.10.1.tar.gz
- Upload date:
- Size: 26.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.9.13
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7d06485742e9659d6e5ad6f5ecb44d9d6ddf441040adb422197c3d89b1da572a |
|
MD5 | f9c6746c5988fb8ef6454824d0a8e68f |
|
BLAKE2b-256 | b9d6e33ab0d79e74d2071f1cca0088dbe577fc7b01933c05b473a2bb6b0679ad |
Provenance
File details
Details for the file shed-0.10.1-py3-none-any.whl
.
File metadata
- Download URL: shed-0.10.1-py3-none-any.whl
- Upload date:
- Size: 26.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.9.13
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 510d23c491265eebfc83458988ca796a78542750de3a118e1974b29822563d76 |
|
MD5 | b8ef42478dff98c65af6759725a05cb2 |
|
BLAKE2b-256 | 4ca06b5a1fdac9839be00f7b88bb9b15d8329f9a4b69660aa8a80d07474deabd |