Try restructuredtext_lint -> rstcheck

Idea here is rstcheck will also validate python
blocks etc, as well as the reStructuredText via
docutils. That would need new error codes:

$ flake8 --select RST some_python.py
some_python.py:8:1: RST999 Unexpected prefix: '(python) unexpected EOF while parsing'

See GitHub issue #22, using the example there:

def some():
    """
    ====
    Test
    ====

    .. code:: python

        print(

    End.
    """
    pass

Author: peterjc

flake8_rst_docstrings.py

@@ -18,6 +18,8 @@
     from io import StringIO
     from io import TextIOWrapper
 
+import rstcheck
+
 #####################################
 # Start of backported tokenize code #
 #####################################
@@ -136,10 +138,7 @@ def tokenize_open(filename):
 # End of backported tokenize code #
 ###################################
 
-import restructuredtext_lint as rst_lint
-
-
-__version__ = "0.0.13"
+__version__ = "0.1.0"
 
 
 log = logging.getLogger(__name__)
@@ -149,6 +148,7 @@ def tokenize_open(filename):
 rst_fail_parse = 901
 rst_fail_all = 902
 rst_fail_lint = 903
+rst_unknown_prefix = 999
 
 # Level 1 - info
 code_mapping_info = {
@@ -1054,10 +1054,9 @@ def run(self):
                 # leading whitespace from each line - this avoids false
                 # positive severe error "Unexpected section title."
                 unindented = trim(dequote_docstring(definition.docstring))
-                # Off load RST validation to reStructuredText-lint
+                # Off load RST validation to rstcheck
                 # which calls docutils internally.
-                # TODO: Should we pass the Python filename as filepath?
-                rst_errors = list(rst_lint.lint(unindented))
+                rst_errors = list(rstcheck.check(unindented))
             except Exception as err:
                 # e.g. UnicodeDecodeError
                 msg = "%s%03i %s" % (
@@ -1067,10 +1066,7 @@ def run(self):
                 )
                 yield definition.start, 0, msg, type(self)
                 continue
-            for rst_error in rst_errors:
-                # TODO - make this a configuration option?
-                if rst_error.level <= 1:
-                    continue
+            for line_number, rst_error in rst_errors:
                 # Levels:
                 #
                 # 0 - debug   --> we don't receive these
@@ -1080,21 +1076,35 @@ def run(self):
                 # 4 - severe  --> RST4## codes
                 #
                 # Map the string to a unique code:
-                msg = rst_error.message.split("\n", 1)[0]
-                code = code_mapping(
-                    rst_error.level, msg, self.extra_directives, self.extra_roles
-                )
+                if rst_error.startswith("(INFO/1) "):
+                    level = 1
+                elif rst_error.startswith("(WARNING/2) "):
+                    level = 2
+                elif rst_error.startswith("(ERROR/3) "):
+                    level = 3
+                elif rst_error.startswith("(SEVERE/4) "):
+                    level = 4
+                else:
+                    msg = "%s%03i %s" % (
+                        rst_prefix,
+                        rst_unknown_prefix,
+                        "Unexpected prefix: %r" % rst_error,
+                    )
+                    yield definition.start + line_number, 0, msg, type(self)
+                    continue
+                msg = rst_error.split(None, 1)[1]
+                code = code_mapping(level, msg, self.extra_directives, self.extra_roles)
                 if not code:
                     # We ignored it, e.g. a known Sphinx role
                     continue
                 assert 0 < code < 100, code
-                code += 100 * rst_error.level
+                code += 100 * level
                 msg = "%s%03i %s" % (rst_prefix, code, msg)
 
                 # This will return the line number by combining the
                 # start of the docstring with the offet within it.
                 # We don't know the column number, leaving as zero.
-                yield definition.start + rst_error.line, 0, msg, type(self)
+                yield definition.start + line_number, 0, msg, type(self)
 
     def load_source(self):
         """Load the source for the specified file."""