rstcheck

Checks syntax of reStructuredText and code blocks nested within it

These details have not been verified by PyPI

Project description

Checks syntax of reStructuredText and code blocks nested within it.

See the full documentation at read-the-docs

From pip

$ pip install rstcheck

To use pyproject.toml for configuration:

$ pip install rstcheck[toml]

To add sphinx support:

$ pip install rstcheck[sphinx]

With bad Python syntax:

====
Test
====

.. code:: python

    print(

$ rstcheck bad_python.rst
bad_python.rst:7: (ERROR/3) (python) unexpected EOF while parsing

With bad C++ syntax:

====
Test
====

.. code:: cpp

    int main()
    {
        return x;
    }

$ rstcheck bad_cpp.rst
bad_cpp.rst:9: (ERROR/3) (cpp) error: 'x' was not declared in this scope

With bad syntax in the reStructuredText document itself:

====
Test
===

$ rstcheck bad_rst.rst
bad_rst.rst:1: (SEVERE/4) Title overline & underline mismatch.

Algorithm	Hash digest
SHA256	`3536f87b02aee4c945d0fbcf4a2a3458341d95afc8e22fc2898bb897bbc2f5f6`
MD5	`0f58ccb169a1bedc764fd8329a658278`
BLAKE2b-256	`9fe9f002143cbdf490f0ac95715fccededfe182c76ff8ab956ff318f0c4699e0`

Algorithm	Hash digest
SHA256	`144e6fb24042f1e4b0bb875a2238deddf7536894570ba4ac1abdd52b86980b2f`
MD5	`7796a8e62fadee0d556c11754c2152b2`
BLAKE2b-256	`e303fdd291877d9d380556cf83df0b8025e47bbe12e1a1f11023673a0907f87d`