So to summarise the discussion so far:

1. automated code formatting will be a great boon - reduce work, lower barrier for new committers, reduce work for the fellows, etc.

2. there are issues with git history in doing "the great commit".

3. there are issues with black's formatting choices.

So to address 1:

I am entirely +1 for automated code formatting to take the work out of our hands.

Can such a tool be automated into, say, github in a way that doesn't create extra commit noise?

To address 2:

I side with those who favour a progressive solution, whereby new code only has the new tool applied.

That said, there might be cause to suggest a deadline [perhaps a N.0 release?] where all remaining code is "cleaned".

And finally 3:

My perspective on the goal of any code formatting tool is this:

When we as developers approach a piece of code, our goal is the understand its intent and its implementation of that intent.

In the process of reaching that, we pass through the stages of (a) identifying the relevant code, (b) understanding the action of the code, and (c) understanding the intent of the code.

Good code formatting choices will remove or reduce the cognitive load in (b) and (c).

In my experience with using black [we use it at work], there are numerous choices (including those demonstrated in this list already) where it can significantly _increase_ the cognitive load in simply parsing the code.

As simple as black can make the job of code formatting, I feel I'd rather see a different tool that retained the benefits of "trivial code reformatting", but still allowed us to retain some of Django's existing code formatting rules.

(An interesting [and defensible] choice, we had a module with a lot of strings wrapped across lines. black opted to push them onto the same line, but NOT to merge them. This is because in Python prior to 3.7, it would have altered the generated AST - one of the guides black uses)


You received this message because you are subscribed to the Google Groups "Django 
developers  (Contributions to Django itself)" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
To post to this group, send email to
Visit this group at
To view this discussion on the web visit
For more options, visit

Reply via email to