psf/black
The uncompromising Python code formatter
Build with Backblaze B2
SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.
Loading star history...
Where it stands
Rank, growth pace and release cadence relative to everything GStars tracks.
Ranks #44 of 2,841 repositories GStars tracks this week (top 2%).
1 release in the last 90 days, the latest 4 days ago, with 455 contributors on GitHub.
Use Cases & Benefits
- Formats Python code automatically to enforce a consistent and opinionated style.
- Provides deterministic, minimal-diff formatting that saves time and mental energy by removing style debates.
- Use for enforcing uniform code style across large Python projects to simplify code reviews.
- Use for integrating automatic formatting into CI pipelines to ensure code style compliance before merging.
- Use for formatting Jupyter Notebooks by installing with the jupyter extra for consistent notebook code style.
Should you depend on it?
License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.
License
MIT
Permissive: commercial use, modification and redistribution are allowed with attribution.
Community files
- README: present
- Contributing guide: present
- Code of conduct: present
Watch-outs
No watch-outs from GStars' checks.
General guidance from repository metadata, not legal advice. How we score
From the README
“Any color you like.”
Black is the uncompromising Python code formatter. By using it, you agree to cede control over minutiae of hand-formatting. In return, Black gives you speed, determinism, and freedom from
pycodestylenagging about formatting. You will save time and mental energy for more important matters.Blackened code looks the same regardless of the project you're reading. Formatting becomes transparent after a while and you can focus on the content instead.
Black makes code review faster by producing the smallest diffs possible.
Try it out now using the Black Playground. Watch the PyCon 2019 talk to learn more.
Black can be installed by running
pip install black. It requires Python 3.9+ to run. If you want to format Jupyter Notebooks, install withpip install "black[jupyter]".If you can't wait for the latest hotness and want to install from GitHub, use:
pip install git+https://github.com/psf/black
Daily snapshots
Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots
+152 stars over 87 days across 9 snapshot days; best day +7 on Oct 8.
Forks
2.9K+103
Open issues
264-28
Compared with peers in Developer Tools
Fastest-growing repositories GStars tracks in this cohort for the week of Oct 4, by 7-day star growth
| Repository | Stars | +7d | Health | Last release |
|---|---|---|---|---|
| DietrichGebert/ponytail | 162.8K | +7.3K | 75 | today |
| tt-a1i/archify | 81.8K | +4.5K | 75 | 6 days ago |
| affaan-m/ECC | 278.6K | +4.2K | 64 | 12 days ago |
| OpenCut-app/OpenCut | 93.9K | +2.3K | 59 | 18 days ago |
| FalkorDB/FalkorDB | 8.2K | +1.6K | 75 | today |
| psf/black | 41.9K | +0 | 75 | 4 days ago |
| Category median | 93.9K | +4.2K | 75 | — |
Discover Repositories
Search across tracked repositories by name or description