UG: Use latest RF lexer to gain RF 3.1 support. Fixes robotframework#3052.

pekkaklarck · pekkaklarck · commit 3bb3301a715d · 2019-01-13T02:49:54.000+02:00
diff --git a/doc/userguide/ug2html.py b/doc/userguide/ug2html.py
@@ -93,16 +93,28 @@
 from pygments import highlight, __version__ as pygments_version
 from pygments.lexers import get_lexer_by_name
 
+# Use latest version, not version bundled with Pygments
+import robotframeworklexer
 
-pygments_version = tuple(int(v) for v in pygments_version.split('.')[:2])
-if pygments_version < (2, 1):
-    sys.exit('Pygments version 2.1 or newer is required.')
+
+def too_old(version_string, minimum):
+    version = tuple(int(v) for v in version_string.split('.')[:2])
+    return version < minimum
+
+
+if too_old(getattr(robotframeworklexer, '__version__', '1.0'), (1, 1)):
+    sys.exit('robotframeworklexer >= 1.1 is required.')
+if too_old(pygments_version, (2, 1)):
+    sys.exit('Pygments >= 2.1 is required.')
 
 
 def pygments_directive(name, arguments, options, content, lineno,
                        content_offset, block_text, state, state_machine):
     try:
-        lexer = get_lexer_by_name(arguments[0])
+        if arguments[0] == 'robotframework':
+            lexer = robotframeworklexer.RobotFrameworkLexer()
+        else:
+            lexer = get_lexer_by_name(arguments[0])
     except ValueError as err:
         raise ValueError(f'Invalid syntax highlighting language "{arguments[0]}".')
     # take an arbitrary option if more than one is given
diff --git a/requirements-build.txt b/requirements-build.txt
@@ -3,3 +3,6 @@ invoke >= 0.20
 rellu >= 0.7
 twine >= 1.12
 wheel
+docutils
+pygments >= 2.1
+robotframeworklexer >= 1.1
