HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
psf
black
Python2018–2026
psf / black

black

The uncompromising Python code formatter

79Distinct people
83Mentions
3Explicit recommenders
42.2KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

The uncompromising Python code formatter

GitHub

Where it is used

No documented product use was verified in the last source check.

What people are saying

I don't see the black python formatter[0] mentioned. I use it for all of my projects and I love it as I prefer not to have a linter distract me while I type. You can see a…

reportgunner used a recommendation phrase. 3 indexed comments match. This is a phrase match, not a verdict.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 8–Nov 15 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/15/2026, 10:56:20 AM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year83 dated mentions

Observed mentions: 2018-03-14 21:57:08 UTC to 2026-09-30 22:50:00 UTC.

0510152018-01-01 00:00:00 UTC to 2019-01-01 00:00:00 UTC (exclusive): 11 mentions; 5 submissions, 6 comments20182019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 16 mentions; 2 submissions, 14 comments2020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 9 mentions; 0 submissions, 9 comments2021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 14 mentions; 3 submissions, 11 comments2022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 16 mentions; 3 submissions, 13 comments20222023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 3 mentions; 0 submissions, 3 comments2024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 7 mentions; 1 submissions, 6 comments2025-01-01 00:00:00 UTC to 2026-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments2026-01-01 00:00:00 UTC to 2027-01-01 00:00:00 UTC (exclusive): 5 mentions; 1 submissions, 4 comments. Incomplete calendar period.2026*

* An incomplete calendar period is marked with an outlined bar. Its count is not directly comparable with a full period.

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20182018-01-01 00:00:00 UTC2019-01-01 00:00:00 UTC1156
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC16214
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC909
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC14311
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC16313
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC303
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC716
20252025-01-01 00:00:00 UTC2026-01-01 00:00:00 UTC202
2026 (partial)2026-01-01 00:00:00 UTC2027-01-01 00:00:00 UTC514

What Hacker News says

11 sources
alangpierce·Jul 30, 2018Recommendation phrase
FWIW Black ( https://github.com/ambv/black ) is a disciplined Python formatter that's reasonably successful, so I'm not convinced that the "significant indentation" thing actually matters too much; it probably just means that formatters need to be more careful to not introduce bugs, but the same principle of code -> AST -> code seems just as valid. What line splitting issues are you referring to? I've been pretty happy with the approach used by Prettier (and I believe Black) of fitting it on one line if possible, and doing one per line otherwise. I'd say that's my favorite part of Prettier: I don't need to think about wrapping anymore, it figures it out, so it's sad to see that gofmt doesn't do that (from my testing just now).
In Elastic TabStops: A Better Way to Indent and Align Code (2017)
I wanted to add a bit of positivity and mention that I'm really liking how the black project is approaching problems. For example, a few people brought up fluent interfaces[0] as an issue. There were many opinions about the right and wrong thing to do, but discussion got to a very pragmatic decision I feel. Then there were requests to add command line arguments specifically so that tools could integrate with black that were added almost immediately. Congrats on gaining so much traction so quickly, and thanks for listening to users (when it makes sense). [0] https://github.com/ambv/black/issues/67
In Black: An uncompromising Python code formatter
I do like the idea overall. So, let me tell you why I instantly hated it and closed the tab. Your Show HN headline did a great job, I was excited to see what a github repo quality bot does! This is a personal preference, but I find the name "Git Enforcer", the police officer emoji, and the git logo with a police hat on it completely off-putting. Not the atmosphere I would want to foster when I'm trying to use persuasion to get colleagues to adopt good practices. In my world, police are authoritarian bullies who demand instant compliance without negotiation, or else they'll brutalize you. It's humbler and more inviting for a bot to come across as an assistant. "Git Enforcer" comes across as something a clueless boss imposes. I think all the wrong-footed design cues come from the name "git enforcer". Basically your bot is a linter for colla
Read the rest
boration behaviors. It can't actually enforce anything, all it can do is nag. Actually, if the name was GitNag and the icon was a horse, I would find your bot charming. Speaking of linters, lately I've been using [Black](https://github.com/ambv/black) for my Python. Its self-description in that Readme sold me on it instantly. I wish you well with this! It is a cool idea.
In Show HN: I'm Creating a GitHub Repo Quality Bot

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.