psf/black

View on GitHub

The uncompromising Python code formatter

Stars: 41.8k
Forks: 2.9k
Open beginner issues: 0
Indexed issues: 266
Avg merge: 5d 6h
Merged PRs (30d): 9

Dominant language: Python
License: MIT
Last GitHub push: Sep 16, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted

Beginner friendly Everything

Open All

266 open issues indexed

`# fmt: skip` on an opening bracket alone makes `if`, `while`, `for` and `with` headers fail to parse Open

Difficulty 3/5 1-2 days Newbie friendliness 78/100

psf/black#5402 · Opened Sep 13, 2026
Paired `fmt: skip` directives make a valid parenthesized if header fail to format Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

psf/black#5397 · Opened Sep 13, 2026
`find_project_root` raises `ValueError` for sources on different Windows drives Open

T: bug

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

psf/black#5379 · 3 comments · 1 reaction · Opened Sep 1, 2026
Nested .gitignore negations can never re-include what an ancestor excluded Open

Difficulty 4/5 3-5 days Newbie friendliness 65/100

psf/black#5376 · 2 comments · Opened Aug 31, 2026
Formatting a dictionary with a long string and type ignore fails on --unstable Open

T: bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

psf/black#5328 · 2 comments · Opened Aug 20, 2026
Quadratic formatting time for chains of subscripts (7s for one 160-subscript line; attribute/call chains stay linear) Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

psf/black#5270 · 2 comments · Opened Jul 29, 2026
`ruff:ignore` should be processed as a pragma in `contains_pragma_comment` Open

T: bug

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

psf/black#5260 · 5 comments · Opened Jul 26, 2026
Potential memory optimizations Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

psf/black#5216 · 2 comments · Opened Jul 1, 2026
Leaf.bracket_depth not initialized Open

T: bug

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

psf/black#5214 · 6 comments · Opened Jul 1, 2026
Allow cache dir configuration via command-line argument Open

T: enhancement

Difficulty 3/5 1-2 days Newbie friendliness 68/100

psf/black#5174 · Opened Jun 10, 2026
Please consider making releases immutable Open

T: bug

psf/black#5120 · 1 reaction · 1 assignee · Opened May 1, 2026
Thinking about `wrap_long_dict_values_in_parens` Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

psf/black#4882 · 4 comments · Opened Dec 4, 2025
wrap_comprehension_in: Black preview style removes parentheses that make code harder to read Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

psf/black#4877 · 2 comments · 1 reaction · Opened Nov 30, 2025
Release workflow: Atomic PyPI pushing? Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

psf/black#4839 · 1 comment · Opened Nov 10, 2025
potential multiprocessing performance improvement Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

psf/black#4771 · 1 comment · 4 reactions · Opened Oct 2, 2025
Preserve alignment of inline comments Open

F: comments T: style

Difficulty 4/5 3-5 days Newbie friendliness 55/100

psf/black#4651 · 2 comments · Opened Apr 14, 2025
Any possible to provide a WASM edition? Open

T: enhancement

Difficulty 5/5 Over a week Newbie friendliness 20/100

psf/black#4649 · 2 comments · Opened Apr 10, 2025
Inconsistencies in how line breaks are added in long "dot-chains", depending on brackets and function calls Open

T: style

Difficulty 5/5 Over a week Newbie friendliness 30/100

psf/black#4554 · 2 comments · 1 reaction · Opened Jan 21, 2025
`hex_codes_in_unicode_sequences`: restrictions around f-strings are too strict Open

F: strings T: style

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4523 · 5 comments · Opened Dec 4, 2024
Change the formatting behaviour when there is bracket in the if statement, like a list, a function Open

T: enhancement

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4516 · 2 comments · 3 reactions · Opened Nov 22, 2024
Test organization improvements Open

C: maintenance

Difficulty 5/5 Over a week Newbie friendliness 35/100

psf/black#4506 · 5 comments · Opened Nov 5, 2024
Odd breaking of operators chain Open

T: style

Difficulty 5/5 Over a week Newbie friendliness 35/100

psf/black#4455 · 3 comments · 3 reactions · Opened Sep 11, 2024
Support Python 3.13 free-threaded build Open

T: enhancement

Difficulty 4/5 3-5 days Newbie friendliness 38/100

psf/black#4438 · 3 comments · Opened Aug 20, 2024
`--line-ranges` formats lines outside of range Open

T: bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4430 · 3 comments · Opened Aug 6, 2024
Newlines between classes do not get added when the last method of one ends with ellipses Open

T: style

Difficulty 3/5 1-2 days Newbie friendliness 45/100

psf/black#4420 · 3 comments · Opened Jul 31, 2024
global config not possible if project contains a `pyproject.toml` Open

S: needs discussion T: bug

Difficulty 3/5 1-2 days Newbie friendliness 48/100

psf/black#4411 · 2 comments · Opened Jul 24, 2024
Allow valid version specifier when specifying Black version in `pyproject.toml` Open

T: enhancement

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4406 · 2 comments · Opened Jul 19, 2024
Long lines that concatenate list comprehensions Open

F: linebreak T: style

Difficulty 4/5 3-5 days Newbie friendliness 42/100

psf/black#4353 · 3 comments · 3 reactions · Opened May 8, 2024
problematic formatting: indentation change in docstring Open

T: style

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4276 · 7 comments · Opened Mar 15, 2024
Bug hazard - multiple strings given same indentation Open

F: parentheses F: strings T: style

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4249 · 4 comments · Opened Feb 23, 2024
Vertical method chaining Open

T: style

Difficulty 5/5 Over a week Newbie friendliness 35/100

psf/black#4244 · 6 reactions · Opened Feb 19, 2024
Remove parentheses around simple top-level expressions Open

F: parentheses T: enhancement

Difficulty 5/5 Over a week Newbie friendliness 30/100

psf/black#4231 · 2 reactions · Opened Feb 13, 2024
Option to force "chop down" multiline (+ add magic comma) when line too long Open

T: enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

psf/black#4229 · 2 comments · 1 reaction · Opened Feb 13, 2024
Future of `string_processing` Open

C: preview style T: bug

Difficulty 5/5 Over a week Newbie friendliness 25/100

psf/black#4208 · 7 comments · 10 reactions · Opened Feb 5, 2024
Improve the style of breaking long lines into two Open

T: style

Difficulty 4/5 3-5 days Newbie friendliness 38/100

psf/black#4203 · 1 comment · Opened Feb 1, 2024
Enable enable-unstable-feature = ['string_processing'] without preview flag Open

C: preview style T: bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4196 · 12 comments · 1 reaction · Opened Jan 30, 2024
Deprecate unusual ways to set things in pyproject.toml Open

C: configuration T: enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

psf/black#4178 · 1 comment · Opened Jan 26, 2024
Line too long: Long from import Open

F: linetoolong T: bug

Difficulty 3/5 1-2 days Newbie friendliness 35/100

psf/black#4177 · 4 comments · Opened Jan 26, 2024
[ISSUE] Github Action Black failing after successful reformatting. Open

T: bug

Difficulty 3/5 1-2 days Newbie friendliness 30/100

psf/black#4156 · 1 comment · Opened Jan 18, 2024
Preview style feedback: Parenthesizing long dict, conditional, and type annotations Open

C: preview style T: style

Difficulty 5/5 Over a week Newbie friendliness 20/100

psf/black#4123 · 6 comments · 16 reactions · Opened Dec 22, 2023
`hug_parens_with_braces_and_square_brackets`: Doesn't hug if all entries fit on a line Open

C: preview style T: style

Difficulty 3/5 1-2 days Newbie friendliness 35/100

psf/black#4099 · 3 comments · 1 reaction · Opened Dec 11, 2023
`hug_parens_with_braces_and_square_brackets`: Recursively hugging parens decrease readability Open

C: preview style T: style

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4098 · 1 comment · 3 reactions · Opened Dec 10, 2023
don't split binary operation if right operand is a function call with short name Open

T: style

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4092 · Opened Dec 9, 2023
Break long expressions at operators, not inside inner parentheses Open

T: style

Difficulty 5/5 Over a week Newbie friendliness 35/100

psf/black#4075 · 2 reactions · Opened Nov 28, 2023
Add parenthesis around walrus Open

T: enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

psf/black#4058 · 2 comments · 2 reactions · Opened Nov 20, 2023
Improve `adjusted_lines`'s diff algorithm used in `--line-ranges`. Open

T: bug

Difficulty 4/5 3-5 days Newbie friendliness 48/100

psf/black#4052 · 1 comment · Opened Nov 18, 2023
Black fails to keep within line length limit when using named parameters Open

F: linetoolong T: bug

Difficulty 4/5 3-5 days Newbie friendliness 45/100

psf/black#4040 · Opened Nov 11, 2023
Single line with binary operator in commented list causes additional line breaks Open

F: linebreak T: bug

Difficulty 3/5 1-2 days Newbie friendliness 52/100

psf/black#4026 · 1 comment · Opened Nov 6, 2023
Support for percent format notebooks Open

T: enhancement

Difficulty 3/5 1-2 days Newbie friendliness 35/100

psf/black#4025 · 5 comments · Opened Nov 6, 2023
Avoid parentheszing non-fluent attribute chain exceeding the line-length Open

T: bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

psf/black#4001 · 3 comments · Opened Oct 30, 2023

psf/black

Get new issues in your inbox