Style reference and PEP 8

Black reformats entire files in place. It is not configurable. It doesn’t take previous formatting into account.

This section orders topics in the same sequence as Python’s PEP 8 (HTML | Source).

Code layout

• Horizontal whitespace
• Vertical whitespace
• Empty lines

String Quotes

Whitespace in Expressions and Statements

When to use trailing commas

• Trailing commas

Comments

Naming Conventions

Programming Recommendations

• Use code block guards to skip reformat