CLI Utility

For your convenience, we present a CLI utility rst-lint (also available as restructuredtext-lint).

$ rst-lint --help
usage: rst-lint [-h] [--format FORMAT] [--encoding ENCODING] filepath

Lint a reStructuredText file

positional arguments:
  filepath         File to lint

optional arguments:
  -h, --help            show this help message and exit
  --format FORMAT       Format of output (e.g. text, json)
  --encoding ENCODING   Encoding of the source file (e.g. utf-8)

$ rst-lint README.rst
WARNING README.rst:2 Title underline too short.

restructuredtext_lint.lint(content, filepath=None)

Lint reStructuredText and return errors

• content String - reStructuredText to be linted

• filepath String - Optional path to file, this will be returned as the source

Returns:

• errors List - List of errors

  • Each error is a class from docutils with the following attrs

    • line Integer - Line where the error occurred

    • source String - filepath provided in parameters

    • level Integer - Level of the warning

      • Levels represent ‘info’: 1, ‘warning’: 2, ‘error’: 3, ‘severe’: 4

    • type String - Noun describing the error level

      • Levels can be ‘INFO’, ‘WARNING’, ‘ERROR’, or ‘SEVERE’

    • message String - Error message

    • full_message String - Error message and source lines where the error occurred

  • It should be noted that level, type, message, and full_message are custom attrs added onto the original system_message

restructuredtext_lint.lint_file(filepath, encoding=None)

Lint a reStructuredText file and return errors

• filepath String - Path to file for linting

• encoding String - Encoding to read file in as

  • When None is provided, it will use OS default as provided by locale.getpreferredencoding

  • The list of supported encodings can be found at http://docs.python.org/2/library/codecs.html#standard-encodings

Returns: Same structure as restructuredtext_lint.lint