All patches and comments are welcome. Please squash your changes to logical
commits before using git-format-patch and git-send-email to
patches@git.madduck.net.
If you'd read over the Git project's submission guidelines and adhered to them,
I'd be especially grateful.
1 x = "This is a really long string that can't possibly be expected to fit all together on one line. In fact it may even take up three or more lines... like four or five... but probably just three."
3 x += "This is a really long string that can't possibly be expected to fit all together on one line. In fact it may even take up three or more lines... like four or five... but probably just three."
9 print('This is a really long string inside of a print statement with extra arguments attached at the end of it.', x, y, z)
11 print("This is a really long string inside of a print statement with no extra arguments attached at the end of it.")
13 D1 = {"The First": "This is a really long string that can't possibly be expected to fit all together on one line. Also it is inside a dictionary, so formatting is more difficult.", "The Second": "This is another really really (not really) long string that also can't be expected to fit on one line and is, like the other string, inside a dictionary."}
15 D2 = {1.0: "This is a really long string that can't possibly be expected to fit all together on one line. Also it is inside a dictionary, so formatting is more difficult.", 2.0: "This is another really really (not really) long string that also can't be expected to fit on one line and is, like the other string, inside a dictionary."}
17 D3 = {x: "This is a really long string that can't possibly be expected to fit all together on one line. Also it is inside a dictionary, so formatting is more difficult.", y: "This is another really really (not really) long string that also can't be expected to fit on one line and is, like the other string, inside a dictionary."}
19 D4 = {"A long and ridiculous {}".format(string_key): "This is a really really really long string that has to go i,side of a dictionary. It is soooo bad.", some_func("calling", "some", "stuff"): "This is a really really really long string that has to go inside of a dictionary. It is {soooo} bad (#{x}).".format(sooo="soooo", x=2), "A %s %s" % ("formatted", "string"): "This is a really really really long string that has to go inside of a dictionary. It is %s bad (#%d)." % ("soooo", 2)}
21 D5 = { # Test for https://github.com/psf/black/issues/3261
22 ("This is a really long string that can't be expected to fit in one line and is used as a nested dict's key"): {"inner": "value"},
25 D6 = { # Test for https://github.com/psf/black/issues/3261
26 ("This is a really long string that can't be expected to fit in one line and is used as a dict's key"): ["value1", "value2"],
29 L1 = ["The is a short string", "This is a really long string that can't possibly be expected to fit all together on one line. Also it is inside a list literal, so it's expected to be wrapped in parens when spliting to avoid implicit str concatenation.", short_call("arg", {"key": "value"}), "This is another really really (not really) long string that also can't be expected to fit on one line and is, like the other string, inside a list literal.", ("parens should be stripped for short string in list")]
31 L2 = ["This is a really long string that can't be expected to fit in one line and is the only child of a list literal."]
33 S1 = {"The is a short string", "This is a really long string that can't possibly be expected to fit all together on one line. Also it is inside a set literal, so it's expected to be wrapped in parens when spliting to avoid implicit str concatenation.", short_call("arg", {"key": "value"}), "This is another really really (not really) long string that also can't be expected to fit on one line and is, like the other string, inside a set literal.", ("parens should be stripped for short string in set")}
35 S2 = {"This is a really long string that can't be expected to fit in one line and is the only child of a set literal."}
37 T1 = ("The is a short string", "This is a really long string that can't possibly be expected to fit all together on one line. Also it is inside a tuple literal, so it's expected to be wrapped in parens when spliting to avoid implicit str concatenation.", short_call("arg", {"key": "value"}), "This is another really really (not really) long string that also can't be expected to fit on one line and is, like the other string, inside a tuple literal.", ("parens should be stripped for short string in list"))
39 T2 = ("This is a really long string that can't be expected to fit in one line and is the only child of a tuple literal.",)
41 func_with_keywords(my_arg, my_kwarg="Long keyword strings also need to be wrapped, but they will probably need to be handled a little bit differently.")
44 'But what should happen when code has already been formatted but in the wrong way? Like'
45 " with a space at the end instead of the beginning. Or what about when it is split too soon?"
48 bad_split2 = "But what should happen when code has already " \
49 "been formatted but in the wrong way? Like " \
50 "with a space at the end instead of the " \
51 "beginning. Or what about when it is split too " \
52 "soon? In the case of a split that is too " \
53 "short, black will try to honer the custom " \
57 "What if we have inline comments on " # First Comment
58 "each line of a bad split? In that " # Second Comment
59 "case, we should just leave it alone." # Third Comment
63 "But what should happen when code has already "
64 "been formatted but in the wrong way? Like "
65 "with a space at the end instead of the "
66 "beginning. Or what about when it is split too "
67 "soon? In the case of a split that is too "
68 "short, black will try to honer the custom "
75 long_string_kwarg="But what should happen when code has already been formatted but in the wrong way? Like "
76 "with a space at the end instead of the beginning. Or what about when it is split too "
82 "But what should happen when code has already "
83 r"been formatted but in the wrong way? Like "
84 "with a space at the end instead of the "
85 r"beginning. Or what about when it is split too "
86 r"soon? In the case of a split that is too "
87 "short, black will try to honer the custom "
95 inline_comments_func1(
96 "if there are inline "
97 "comments in the middle "
98 # Here is the standard alone comment.
99 "of the implicitly concatenated "
100 "string, we should handle "
105 inline_comments_func2(
106 "what if the string is very very very very very very very very very very long and this part does "
107 "not fit into a single line? "
108 # Here is the standard alone comment.
109 "then the string should still be properly handled by merging and splitting "
110 "it into parts that fit in line length.",
114 raw_string = r"This is a long raw string. When re-formatting this string, black needs to make sure it prepends the 'r' onto the new string."
116 fmt_string1 = "We also need to be sure to preserve any and all {} which may or may not be attached to the string in question.".format("method calls")
118 fmt_string2 = "But what about when the string is {} but {}".format("short", "the method call is really really really really really really really really long?")
120 old_fmt_string1 = "While we are on the topic of %s, we should also note that old-style formatting must also be preserved, since some %s still uses it." % ("formatting", "code")
122 old_fmt_string2 = "This is a %s %s %s %s" % ("really really really really really", "old", "way to format strings!", "Use f-strings instead!")
124 old_fmt_string3 = "Whereas only the strings after the percent sign were long in the last example, this example uses a long initial string as well. This is another %s %s %s %s" % ("really really really really really", "old", "way to format strings!", "Use f-strings instead!")
126 fstring = f"f-strings definitely make things more {difficult} than they need to be for {{black}}. But boy they sure are handy. The problem is that some lines will need to have the 'f' whereas others do not. This {line}, for example, needs one."
128 fstring_with_no_fexprs = f"Some regular string that needs to get split certainly but is NOT an fstring by any means whatsoever."
130 comment_string = "Long lines with inline comments should have their comments appended to the reformatted string's enclosing right parentheses." # This comment gets thrown to the top.
132 arg_comment_string = print("Long lines with inline comments which are apart of (and not the only member of) an argument list should have their comments appended to the reformatted string's enclosing left parentheses.", # This comment gets thrown to the top.
133 "Arg #2", "Arg #3", "Arg #4", "Arg #5")
135 pragma_comment_string1 = "Lines which end with an inline pragma comment of the form `# <pragma>: <...>` should be left alone." # noqa: E501
137 pragma_comment_string2 = "Lines which end with an inline pragma comment of the form `# <pragma>: <...>` should be left alone." # noqa
139 """This is a really really really long triple quote string and it should not be touched."""
141 triple_quote_string = """This is a really really really long triple quote string assignment and it should not be touched."""
143 assert some_type_of_boolean_expression, "Followed by a really really really long string that is used to provide context to the AssertionError exception."
145 assert some_type_of_boolean_expression, "Followed by a really really really long string that is used to provide context to the AssertionError exception, which uses dynamic string {}.".format("formatting")
147 assert some_type_of_boolean_expression, "Followed by a really really really long string that is used to provide context to the AssertionError exception, which uses dynamic string %s." % "formatting"
149 assert some_type_of_boolean_expression, "Followed by a really really really long string that is used to provide context to the AssertionError exception, which uses dynamic %s %s." % ("string", "formatting")
151 some_function_call("With a reallly generic name and with a really really long string that is, at some point down the line, " + added + " to a variable and then added to another string.")
153 some_function_call("With a reallly generic name and with a really really long string that is, at some point down the line, " + added + " to a variable and then added to another string. But then what happens when the final string is also supppppperrrrr long?! Well then that second (realllllllly long) string should be split too.", "and a second argument", and_a_third)
155 return "A really really really really really really really really really really really really really long {} {}".format("return", "value")
158 "This is a really long string argument to a function that has a trailing comma which should NOT be there.",
162 "This is a really long string argument to a function that has a trailing comma which should NOT be there.", # comment after comma
167 "This is a really long string argument to a function that has a trailing comma"
168 " which should NOT be there."
174 "This is a really long string argument to a function that has a trailing comma"
175 " which should NOT be there."
176 ), # comment after comma
179 func_with_bad_parens_that_wont_fit_in_one_line(
180 ("short string that should have parens stripped"),
186 func_with_bad_parens_that_wont_fit_in_one_line(
189 ("short string that should have parens stripped"),
193 func_with_bad_parens(
194 ("short string that should have parens stripped"),
200 func_with_bad_parens(
203 ("short string that should have parens stripped"),
207 annotated_variable: Final = "This is a large " + STRING + " that has been " + CONCATENATED + "using the '+' operator."
208 annotated_variable: Final = "This is a large string that has a type annotation attached to it. A type annotation should NOT stop a long string from being wrapped."
209 annotated_variable: Literal["fakse_literal"] = "This is a large string that has a type annotation attached to it. A type annotation should NOT stop a long string from being wrapped."
211 backslashes = "This is a really long string with \"embedded\" double quotes and 'single' quotes that also handles checking for an even number of backslashes \\"
212 backslashes = "This is a really long string with \"embedded\" double quotes and 'single' quotes that also handles checking for an even number of backslashes \\\\"
213 backslashes = "This is a really 'long' string with \"embedded double quotes\" and 'single' quotes that also handles checking for an odd number of backslashes \\\", like this...\\\\\\"
227 raw_strings = r"Don't" " get" r" merged" " unless they are all raw."
230 yield "This is a really long string that can't possibly be expected to fit all together on one line. In fact it may even take up three or more lines... like four or five... but probably just three."
232 x = f"This is a {{really}} long string that needs to be split without a doubt (i.e. most definitely). In short, this {string} that can't possibly be {{expected}} to fit all together on one line. In {fact} it may even take up three or more lines... like four or five... but probably just four."
234 long_unmergable_string_with_pragma = (
235 "This is a really long string that can't be merged because it has a likely pragma at the end" # type: ignore
239 long_unmergable_string_with_pragma = (
240 "This is a really long string that can't be merged because it has a likely pragma at the end" # noqa
244 long_unmergable_string_with_pragma = (
245 "This is a really long string that can't be merged because it has a likely pragma at the end" # pylint: disable=some-pylint-check
249 string_with_nameescape = (
250 "........................................................................ \N{LAO KO LA}"
253 string_with_nameescape = (
254 "........................................................................... \N{LAO KO LA}"
257 string_with_nameescape = (
258 "............................................................................ \N{LAO KO LA}"
261 string_with_nameescape_and_escaped_backslash = (
262 "...................................................................... \\\N{LAO KO LA}"
265 string_with_nameescape_and_escaped_backslash = (
266 "......................................................................... \\\N{LAO KO LA}"
269 string_with_nameescape_and_escaped_backslash = (
270 ".......................................................................... \\\N{LAO KO LA}"
273 string_with_escaped_nameescape = (
274 "........................................................................ \\N{LAO KO LA}"
277 string_with_escaped_nameescape = (
278 "........................................................................... \\N{LAO KO LA}"
286 "This is a really long string that can't possibly be expected to fit all together"
287 " on one line. In fact it may even take up three or more lines... like four or"
288 " five... but probably just three."
292 "This is a really long string that can't possibly be expected to fit all together"
293 " on one line. In fact it may even take up three or more lines... like four or"
294 " five... but probably just three."
301 "This is a really long string inside of a print statement with extra arguments"
302 " attached at the end of it."
310 "This is a really long string inside of a print statement with no extra arguments"
311 " attached at the end of it."
316 "This is a really long string that can't possibly be expected to fit all"
317 " together on one line. Also it is inside a dictionary, so formatting is more"
321 "This is another really really (not really) long string that also can't be"
322 " expected to fit on one line and is, like the other string, inside a"
329 "This is a really long string that can't possibly be expected to fit all"
330 " together on one line. Also it is inside a dictionary, so formatting is more"
334 "This is another really really (not really) long string that also can't be"
335 " expected to fit on one line and is, like the other string, inside a"
342 "This is a really long string that can't possibly be expected to fit all"
343 " together on one line. Also it is inside a dictionary, so formatting is more"
347 "This is another really really (not really) long string that also can't be"
348 " expected to fit on one line and is, like the other string, inside a"
354 "A long and ridiculous {}".format(string_key): (
355 "This is a really really really long string that has to go i,side of a"
356 " dictionary. It is soooo bad."
358 some_func("calling", "some", "stuff"): (
359 "This is a really really really long string that has to go inside of a"
360 " dictionary. It is {soooo} bad (#{x}).".format(sooo="soooo", x=2)
363 % ("formatted", "string"): (
364 "This is a really really really long string that has to go inside of a"
365 " dictionary. It is %s bad (#%d)."
370 D5 = { # Test for https://github.com/psf/black/issues/3261
371 "This is a really long string that can't be expected to fit in one line and is used as a nested dict's key": {
376 D6 = { # Test for https://github.com/psf/black/issues/3261
377 "This is a really long string that can't be expected to fit in one line and is used as a dict's key": [
384 "The is a short string",
386 "This is a really long string that can't possibly be expected to fit all"
387 " together on one line. Also it is inside a list literal, so it's expected to"
388 " be wrapped in parens when spliting to avoid implicit str concatenation."
390 short_call("arg", {"key": "value"}),
392 "This is another really really (not really) long string that also can't be"
393 " expected to fit on one line and is, like the other string, inside a list"
396 "parens should be stripped for short string in list",
400 "This is a really long string that can't be expected to fit in one line and is the"
401 " only child of a list literal."
405 "The is a short string",
407 "This is a really long string that can't possibly be expected to fit all"
408 " together on one line. Also it is inside a set literal, so it's expected to be"
409 " wrapped in parens when spliting to avoid implicit str concatenation."
411 short_call("arg", {"key": "value"}),
413 "This is another really really (not really) long string that also can't be"
414 " expected to fit on one line and is, like the other string, inside a set"
417 "parens should be stripped for short string in set",
421 "This is a really long string that can't be expected to fit in one line and is the"
422 " only child of a set literal."
426 "The is a short string",
428 "This is a really long string that can't possibly be expected to fit all"
429 " together on one line. Also it is inside a tuple literal, so it's expected to"
430 " be wrapped in parens when spliting to avoid implicit str concatenation."
432 short_call("arg", {"key": "value"}),
434 "This is another really really (not really) long string that also can't be"
435 " expected to fit on one line and is, like the other string, inside a tuple"
438 "parens should be stripped for short string in list",
443 "This is a really long string that can't be expected to fit in one line and is"
444 " the only child of a tuple literal."
451 "Long keyword strings also need to be wrapped, but they will probably need to"
452 " be handled a little bit differently."
457 "But what should happen when code has already been formatted but in the wrong way?"
458 " Like with a space at the end instead of the beginning. Or what about when it is"
463 "But what should happen when code has already "
464 "been formatted but in the wrong way? Like "
465 "with a space at the end instead of the "
466 "beginning. Or what about when it is split too "
467 "soon? In the case of a split that is too "
468 "short, black will try to honer the custom "
473 "What if we have inline comments on " # First Comment
474 "each line of a bad split? In that " # Second Comment
475 "case, we should just leave it alone." # Third Comment
480 "But what should happen when code has already "
481 "been formatted but in the wrong way? Like "
482 "with a space at the end instead of the "
483 "beginning. Or what about when it is split too "
484 "soon? In the case of a split that is too "
485 "short, black will try to honer the custom "
498 "But what should happen when code has already been formatted but in the wrong"
499 " way? Like with a space at the end instead of the beginning. Or what about"
500 " when it is split too soon?"
506 "But what should happen when code has already "
507 r"been formatted but in the wrong way? Like "
508 "with a space at the end instead of the "
509 r"beginning. Or what about when it is split too "
510 r"soon? In the case of a split that is too "
511 "short, black will try to honer the custom "
519 inline_comments_func1(
520 "if there are inline comments in the middle "
521 # Here is the standard alone comment.
522 "of the implicitly concatenated string, we should handle them correctly",
526 inline_comments_func2(
527 "what if the string is very very very very very very very very very very long and"
528 " this part does not fit into a single line? "
529 # Here is the standard alone comment.
530 "then the string should still be properly handled by merging and splitting "
531 "it into parts that fit in line length.",
536 r"This is a long raw string. When re-formatting this string, black needs to make"
537 r" sure it prepends the 'r' onto the new string."
541 "We also need to be sure to preserve any and all {} which may or may not be"
542 " attached to the string in question.".format("method calls")
545 fmt_string2 = "But what about when the string is {} but {}".format(
547 "the method call is really really really really really really really really long?",
551 "While we are on the topic of %s, we should also note that old-style formatting"
552 " must also be preserved, since some %s still uses it." % ("formatting", "code")
555 old_fmt_string2 = "This is a %s %s %s %s" % (
556 "really really really really really",
558 "way to format strings!",
559 "Use f-strings instead!",
563 "Whereas only the strings after the percent sign were long in the last example,"
564 " this example uses a long initial string as well. This is another %s %s %s %s"
566 "really really really really really",
568 "way to format strings!",
569 "Use f-strings instead!",
574 f"f-strings definitely make things more {difficult} than they need to be for"
575 " {black}. But boy they sure are handy. The problem is that some lines will need"
576 f" to have the 'f' whereas others do not. This {line}, for example, needs one."
579 fstring_with_no_fexprs = (
580 f"Some regular string that needs to get split certainly but is NOT an fstring by"
581 f" any means whatsoever."
584 comment_string = ( # This comment gets thrown to the top.
585 "Long lines with inline comments should have their comments appended to the"
586 " reformatted string's enclosing right parentheses."
589 arg_comment_string = print(
590 ( # This comment gets thrown to the top.
591 "Long lines with inline comments which are apart of (and not the only member"
592 " of) an argument list should have their comments appended to the reformatted"
593 " string's enclosing left parentheses."
601 pragma_comment_string1 = "Lines which end with an inline pragma comment of the form `# <pragma>: <...>` should be left alone." # noqa: E501
603 pragma_comment_string2 = "Lines which end with an inline pragma comment of the form `# <pragma>: <...>` should be left alone." # noqa
605 """This is a really really really long triple quote string and it should not be touched."""
607 triple_quote_string = """This is a really really really long triple quote string assignment and it should not be touched."""
609 assert some_type_of_boolean_expression, (
610 "Followed by a really really really long string that is used to provide context to"
611 " the AssertionError exception."
614 assert some_type_of_boolean_expression, (
615 "Followed by a really really really long string that is used to provide context to"
616 " the AssertionError exception, which uses dynamic string {}.".format("formatting")
619 assert some_type_of_boolean_expression, (
620 "Followed by a really really really long string that is used to provide context to"
621 " the AssertionError exception, which uses dynamic string %s." % "formatting"
624 assert some_type_of_boolean_expression, (
625 "Followed by a really really really long string that is used to provide context to"
626 " the AssertionError exception, which uses dynamic %s %s."
627 % ("string", "formatting")
631 "With a reallly generic name and with a really really long string that is, at some"
632 " point down the line, "
634 + " to a variable and then added to another string."
638 "With a reallly generic name and with a really really long string that is, at some"
639 " point down the line, "
641 + " to a variable and then added to another string. But then what happens when the"
642 " final string is also supppppperrrrr long?! Well then that second (realllllllly"
643 " long) string should be split too.",
644 "and a second argument",
649 "A really really really really really really really really really really really"
650 " really really long {} {}".format("return", "value")
655 "This is a really long string argument to a function that has a trailing comma"
656 " which should NOT be there."
661 ( # comment after comma
662 "This is a really long string argument to a function that has a trailing comma"
663 " which should NOT be there."
669 "This is a really long string argument to a function that has a trailing comma"
670 " which should NOT be there."
675 ( # comment after comma
676 "This is a really long string argument to a function that has a trailing comma"
677 " which should NOT be there."
681 func_with_bad_parens_that_wont_fit_in_one_line(
682 "short string that should have parens stripped", x, y, z
685 func_with_bad_parens_that_wont_fit_in_one_line(
686 x, y, "short string that should have parens stripped", z
689 func_with_bad_parens(
690 "short string that should have parens stripped",
696 func_with_bad_parens(
699 "short string that should have parens stripped",
703 annotated_variable: Final = (
708 + "using the '+' operator."
710 annotated_variable: Final = (
711 "This is a large string that has a type annotation attached to it. A type"
712 " annotation should NOT stop a long string from being wrapped."
714 annotated_variable: Literal["fakse_literal"] = (
715 "This is a large string that has a type annotation attached to it. A type"
716 " annotation should NOT stop a long string from being wrapped."
720 "This is a really long string with \"embedded\" double quotes and 'single' quotes"
721 " that also handles checking for an even number of backslashes \\"
724 "This is a really long string with \"embedded\" double quotes and 'single' quotes"
725 " that also handles checking for an even number of backslashes \\\\"
728 "This is a really 'long' string with \"embedded double quotes\" and 'single' quotes"
729 ' that also handles checking for an odd number of backslashes \\", like'
733 short_string = "Hi there."
735 func_call(short_string="Hi there.")
737 raw_strings = r"Don't" " get" r" merged" " unless they are all raw."
742 "This is a really long string that can't possibly be expected to fit all"
743 " together on one line. In fact it may even take up three or more lines... like"
744 " four or five... but probably just three."
749 "This is a {really} long string that needs to be split without a doubt (i.e."
750 f" most definitely). In short, this {string} that can't possibly be {{expected}} to"
751 f" fit all together on one line. In {fact} it may even take up three or more"
752 " lines... like four or five... but probably just four."
755 long_unmergable_string_with_pragma = (
756 "This is a really long string that can't be merged because it has a likely pragma at the end" # type: ignore
760 long_unmergable_string_with_pragma = (
761 "This is a really long string that can't be merged because it has a likely pragma at the end" # noqa
765 long_unmergable_string_with_pragma = (
766 "This is a really long string that can't be merged because it has a likely pragma at the end" # pylint: disable=some-pylint-check
770 string_with_nameescape = (
771 "........................................................................"
775 string_with_nameescape = (
776 "..........................................................................."
780 string_with_nameescape = (
781 "............................................................................"
785 string_with_nameescape_and_escaped_backslash = (
786 "......................................................................"
790 string_with_nameescape_and_escaped_backslash = (
791 "........................................................................."
795 string_with_nameescape_and_escaped_backslash = (
796 ".........................................................................."
800 string_with_escaped_nameescape = (
801 "........................................................................ \\N{LAO"
805 string_with_escaped_nameescape = (
806 "..........................................................................."