> Black is the uncompromising Python code formatter. By using it, you agree to cede control over minutiae of hand-formatting. In return, Black gives you speed, determinism, and freedom from pycodestyle nagging about formatting. You will save time and mental energy for more important matters.
I run into this philosophical debate at work. In my mind, I don't care much what the resulting code looks like as long as
- it's somewhere in the reasonable spectrum of readablility
- it's consistent and unambiguous
- it never fails for a syntactically valid source file (if it's doing something for syntactically invalid source files, even better, formatting helps me find the error)
There are other opinions though that emphasize minimizing diffs or extensive customization to fit somebody's favorite style (I'm looking at you, rustfmt). Black seems to be right down my alley.
I run into this philosophical debate at work. In my mind, I don't care much what the resulting code looks like as long as
- it's somewhere in the reasonable spectrum of readablility
- it's consistent and unambiguous
- it never fails for a syntactically valid source file (if it's doing something for syntactically invalid source files, even better, formatting helps me find the error)
There are other opinions though that emphasize minimizing diffs or extensive customization to fit somebody's favorite style (I'm looking at you, rustfmt). Black seems to be right down my alley.