Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Putting our foot down for the Nth time (a.k.a. Indentation IV: electric hullabaloo) #2855

Merged
merged 3 commits into from
Feb 2, 2022
Merged

Putting our foot down for the Nth time (a.k.a. Indentation IV: electric hullabaloo) #2855

Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
40a98a6
Putting our foot down for the Nth time (#2798)
felix-hilden Feb 1, 2022
e950fcf
Update docs/faq.md
felix-hilden Feb 2, 2022
61dde4f
Update docs/faq.md
felix-hilden Feb 2, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions docs/faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,18 @@ The most common questions and issues users face are aggregated to this FAQ.
:class: this-will-duplicate-information-and-it-is-still-useful-here
```

## Why spaces? I prefer tabs

PEP 8 recommends spaces over tabs, and they are used by most of the Python community.
_Black_ provides no options to configure the indentation style, and requests for any such
felix-hilden marked this conversation as resolved.
Show resolved Hide resolved
options will not be considered.

However, we recognise that using tabs is an accessibility issue as well. While the
option will never be added to _Black_, visually impaired developers may find conversion
tools such as `expand/unexpand` (for Linux) useful when contributing to Python projects.
A workflow might consist of e.g. setting up appropriate pre-commit and post-merge git
hooks, and scripting `unexpand` to run after applying _Black_.

## Does Black have an API?

Not yet. _Black_ is fundamentally a command line tool. Many
Expand Down