Preserve Markdown callout blockquote lines in docbuilder style docstring formatting

[qgallouedec]

from doc_builder.style_doc import style_docstring


test_docstring = """Function description

Params:
    x (`int`): This is x.

> [!NOTE]
> This is a note.
> This is still part of the note.
"""

print(style_docstring(test_docstring, 119)[0])

Before this PR:

$ python demo.py 
Function description

Params:
    x (`int`): This is x.

> [!NOTE]
> This is a note. > This is still part of the note.

After this PR:

$ python demo.py 
Function description

Params:
    x (`int`): This is x.

> [!NOTE]
> This is a note.
> This is still part of the note.

[albertvillanova]

Thanks! Much better.

Just a question: are we sure that the regex does not match unintended text?

[qgallouedec]

I'm not an expert in regex, but let me look into it.

[qgallouedec]

The only case I can think of is

text = """Shell snippet written outside fenced code:

> This is just a normal quote line that is intentionally very very very very very very very very very very very very long and would usually be wrapped.
"""
print(style_docstring(text, 119)[0])

where we would like to get something like

Shell snippet written outside fenced code:

> This is just a normal quote line that is intentionally very very very very very
> very very very very very very very long and would usually be wrapped.

but we get

Shell snippet written outside fenced code:

> This is just a normal quote line that is intentionally very very very very very very very very very very very very long and would usually be wrapped.

which is not a big deal I think, cause before this PR:

Shell snippet written outside fenced code:

> This is just a normal quote line that is intentionally very very very very
very very very very very very very very long and would usually be wrapped.

[qgallouedec]

Addressed here: #757

[Wauplin]

Looks good 👍

[Wauplin]

Suggested change

	_re_blockquote_tip = re.compile(r"^\s*>\s?.*$")
	_re_blockquote = re.compile(r"^\s*>\s?.*$")

(nit) (not catching only tips anymore)