Black is the Uncompromising Code Formatter for Python. Auto-formatting with black will give FreeIPA a consistent code style, eliminate any need to discuss code style issues in PRs, and get rid of about remaining 25,000 pycodestyle violations.
black-codestyle.rst for FreeIPA
Django DEP 0008
Please no.
This will result in a massive commit that will mess up "blame" output, making it harder (and more effort) to determine history of a line.
We already have tools enforcing style. If we want to change the target style going forward, ok, let's discuss that. But a "big bang" reformatting of the codebase (or "small-bang" on a file-by-file basis) does more harm than good.
Please no. This will result in a massive commit that will mess up "blame" output, making it harder (and more effort) to determine history of a line.
My design doc in https://github.com/freeipa/freeipa/pull/4621 explains why it's not going to mess up git blame. The --ignore-revs-file option to git blame allow us to define a file with commit hashses that are ignored by git blame. Developers can persist the configuration with git config --local blame.ignoreRevsFile .gitignorerevs, too.
git blame
--ignore-revs-file
git config --local blame.ignoreRevsFile .gitignorerevs
master:
ipa-4-8: