Leave trailing line break in reST directives (#385)

* Add to `pdoc.test.Docformats.test_reST_include` to catch issue.

* Add a single line-break at the end of `.. include::`ed files - except for when in a code block.

* Minor change comment

* Revert last 2 commits.

* Don't consume trailing newline from reST directives.

* [] itself a disjunctive list of characters

pdoc/html_helpers.py

@@ -275,6 +275,9 @@ def _admonition(match, module=None, limit_types=None):
         if limit_types and type not in limit_types:
             return match.group(0)
 
+        if text is None:
+            text = ""
+
         if type == 'include' and module:
             try:
                 return _ToMarkdown._include_file(indent, value,
@@ -323,7 +326,8 @@ def admonitions(text, module, limit_types=None):
         See: https://python-markdown.github.io/extensions/admonition/
         """
         substitute = partial(re.compile(r'^(?P<indent> *)\.\. ?(\w+)::(?: *(.*))?'
-                                        r'((?:\n(?:(?P=indent) +.*| *$))*)', re.MULTILINE).sub,
+                                        r'((?:\n(?:(?P=indent) +.*| *$))*[^\r\n])*',
+                                        re.MULTILINE).sub,
                              partial(_ToMarkdown._admonition, module=module,
                                      limit_types=limit_types))
         # Apply twice for nested (e.g. image inside warning)

pdoc/test/__init__.py

@@ -1568,7 +1568,22 @@ def test_reST_include(self):
 <p>1
 x = 2
 x = 3
-x =</p>'''
+x =</p>
+<table>
+<thead>
+<tr>
+<th>Name</th>
+<th>Value</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>Hello</td>
+<td>World</td>
+</tr>
+</tbody>
+</table>
+<p>Remaining.</p>'''
         mod = pdoc.Module(pdoc.import_module(
             os.path.join(TESTS_BASEDIR, EXAMPLE_MODULE, '_reST_include', 'test.py')))
         html = to_html(mod.docstring, module=mod)

pdoc/test/example_pkg/_reST_include/table.md

@@ -0,0 +1,3 @@
+| Name  | Value  |
+| ----- | -----  |
+| Hello | World  |

pdoc/test/example_pkg/_reST_include/test.py

@@ -8,4 +8,8 @@
 .. include:: foo/../_include_me.py
     :start-after: =
     :end-before: 4
+
+.. include:: table.md
+
+Remaining.
 """