#!/usr/bin/env python3
# :Copyright: © 2020 Günter Milde.
# :License: Released under the terms of the `2-Clause BSD license`_, in short:
#
# Copying and distribution of this file, with or without modification,
# are permitted in any medium without royalty provided the copyright
# notice and this notice are preserved.
# This file is offered as-is, without any warranty.
#
# .. _2-Clause BSD license: https://opensource.org/licenses/BSD-2-Clause
"""
Test for bullet lists in CommonMark parsers.
Cf. the `CommonMark Specification `__
"""
from pathlib import Path
import sys
import unittest
if __name__ == '__main__':
# prepend the "docutils root" to the Python library path
# so we import the local `docutils` package.
sys.path.insert(0, str(Path(__file__).resolve().parents[3]))
from docutils.frontend import get_default_settings
from docutils.parsers.recommonmark_wrapper import Parser
from docutils.utils import new_document
class RecommonmarkParserTestCase(unittest.TestCase):
def test_parser(self):
parser = Parser()
settings = get_default_settings(Parser)
for name, cases in totest.items():
for casenum, (case_input, case_expected) in enumerate(cases):
with self.subTest(id=f'totest[{name!r}][{casenum}]'):
document = new_document('test data', settings.copy())
parser.parse(case_input, document)
output = document.pformat()
self.assertEqual(case_expected, output)
totest = {}
totest['bullet_lists'] = [
["""\
- item
""",
"""\
item
"""],
["""\
* item 1
* item 2
""",
"""\
item 1
item 2
"""],
["""\
No blank line between:
+ item 1
+ item 2
""",
"""\
No blank line between:
item 1
item 2
"""],
["""\
- item 1, paragraph 1.
item 1, paragraph 2.
- item 2
""",
"""\
item 1, paragraph 1.
item 1, paragraph 2.
item 2
"""],
["""\
- item 1, line 1
item 1, line 2
- item 2
""",
"""\
item 1, line 1
item 1, line 2
item 2
"""],
["""\
Different bullets start different lists:
- item 1
+ item 1
* no blank line
- required between lists
""",
"""\
Different bullets start different lists:
item 1
item 1
no blank line
required between lists
"""],
["""\
- item 1
continuation of item 1
""",
"""\
item 1
continuation of item 1
"""],
["""\
-
empty item above
""",
"""\
empty item above
"""],
["""\
-
empty item above, no blank line
""",
"""\
empty item above, no blank line
"""],
["""\
Unicode bullets are not supported by CommonMark.
• BULLET
‣ TRIANGULAR BULLET
⁃ HYPHEN BULLET
""",
"""\
Unicode bullets are not supported by CommonMark.
• BULLET
‣ TRIANGULAR BULLET
⁃ HYPHEN BULLET
"""],
]
if __name__ == '__main__':
unittest.main()