1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
#!/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
"""
Various tests for the `pygments` code highlighter.
"""
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[4]))
from docutils.core import publish_string
from docutils.utils.code_analyzer import with_pygments
unknown_language = """\
Unknown language "S-Lang".
.. code:: s-lang
% abc.sl
autoload("abc_mode", "abc");
"""
workaround = """\
Workaround to silence warning: disable code parsing with
"syntax highlight" setting or put code language in class argument:
.. code::
:class: s-lang
% abc.sl
autoload("abc_mode", "abc");
"""
settings = {'warning_stream': ''}
@unittest.skipUnless(with_pygments, 'optional module "pygments" not found')
class CodeParsingTests(unittest.TestCase):
def test_lexer_error(self):
output = publish_string(unknown_language, settings_overrides=settings)
self.assertIn(b'<system_message level="2"', output)
self.assertIn(b'Cannot analyze code. '
b'No Pygments lexer found for "s-lang".', output)
self.assertIn(b'<literal_block xml:space="preserve">', output)
def test_lexer_error_workaround(self):
output = publish_string(workaround, settings_overrides=settings)
self.assertNotIn(b'<system_message', output)
self.assertIn(b'<literal_block classes="code s-lang"', output)
self.assertIn(b'autoload("abc_mode", "abc");', output)
if __name__ == '__main__':
unittest.main()
|
