gh-95065: Argument Clinic: Pretty-print long C strings in generated code

[erlend-aasland]

• Issue: Argument Clinic: add support for deprecating positional use of parameters #95065

[serhiy-storchaka]

Could not textwrap.wrap(replace_whitespace=False, drop_whitespace=False) be used here?

[erlend-aasland]

Could not textwrap.wrap(replace_whitespace=False, drop_whitespace=False) be used here?

Perhaps. I experimented a little bit with textwrap.TextWrapper but it does not support custom suffix like line continuation characters.

[erlend-aasland]

A simpler approach could be to use textwrap, then split("\n") and prepend/append the needed quotes and continuation:

wrapped=textwrap.wrap(...)
forlineinwrapped:
# add indent, add quoted line, add suffix and newline

[serhiy-storchaka]

prefix + separator.join(textwrap.wrap(...)) + suffix

[erlend-aasland]

prefix + separator.join(textwrap.wrap(...)) + suffix

Unfortunately, not so simple.

[erlend-aasland]

For example, we don't want the suffix to be applied to the last line.

[erlend-aasland]

I think 3de2378 should do the trick.

[AlexWaygood]

It seems all call sites specify a value for the subsequent_indent parameter. Maybe it should be required, instead of optional?

Suggested change

	width: int=72,
	suffix: str='',
	initial_indent: int=0,
	subsequent_indent: int=4
	subsequent_indent: int,
	width: int=72,
	suffix: str='',
	initial_indent: int=0,

[erlend-aasland]

Hm, perhaps.

[erlend-aasland]

Thank you for the reviews!