How to Indent Wrapped Text?

[KyleKing]

How do I add indents to wrapped lines? I tried overriding Text.wrap and looking through a few of the Console methods, but there didn't seem to be a configuration option.

I would like to add indents to the wrapped text when printed, so that:

from rich.console import Console
from rich.text import Text

text = Text()
text.append('key: ---------- ' * 50)
Console().print(text)

Outputs something like this (where each new line has an extra four spaces):

key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key:
    ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key:
    ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key:
    ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ---------- key: ----------

I tried end, but that is only after the line and not on fold:

console.print(text, end="\n    ")

Blocking: KyleKing/tail-jsonl#1

[harkabeeparolus]

This is usually known as a hanging indent in word processing. The trick is that the first line is not indented at all, whereas all the subsequent lines are.

I really want this feature too! 😳

You can of course indent all wrapped lines by the same amount using e.g. Padding.indent(), but in this case we want a different indent for the first line.

I wish Padding.indent() had an optional parameter to specify the indent for the first line, perhaps "first_line_level". In that case, you could implement a hanging indent by doing something like:

hanging = Padding.indent(Text("key: ---------- " * 50), level=4, first_line_level=0)  # TODO: Does not exist :-(

[KyleKing]

Wow, that is exactly what I was looking for!

[harkabeeparolus]

Oh shoot. I just noticed that it doesn't actually work; the indented version silently crops characters at the right margin. 😣 It does make sense, though, because the line lengths are rendered before the indent is added. I edited my code above to extend the right margin with Padding(), but then the first line is too short so it doesn't look very nice.

Well, that sucks. I'll have to go back to the drawing board. 😕

[willmcgugan]

Can't think of a quick way of implementing that using the existing API. Sounds a bit like an XY problem though. Why do you need it?

[KyleKing]

I wanted to add hanging indents to my log formatting tool: https://github.com/KyleKing/tail-jsonl

Since I initially posted this discussion, I've tweaked the colors and styling to make the JSONL lines easier to visually scan, which generally seems to work well.

However, for non-JSONL text, I pass those lines through without styling, which could benefit from hanging indents, though it's not something I absolutely need, and I'm happy enough with how the output looks today

[harkabeeparolus]

Yeah, printing log lines, email headers or similar text info but with word wrapping is my primary use case too. 👍🏻

Hanging indents are normally used for a bibliography or reference section. But maybe that's more a topic for word processing and not something you would do in the terminal. 😊