Skip to main content

Checks syntax of reStructuredText and code blocks nested within it

Project description

General

Maintenance - intended License Semantic Versioning - 2.0.0

Read the Docs - Build Status (latest)

CI

Test status Documentation status QA status

PyPI

PyPI - Package latest release PyPI - Supported Python Versions PyPI - Supported Implementations

PyPI - Format PyPI - Monthly downloads

Github

Github - Latest Release GitHub - Last Commit

Github - Stars Github - Forks Github - Contributors Github - Watchers

Checks syntax of reStructuredText and code blocks nested within it.

See the full documentation at read-the-docs

Installation

From pip

$ pip install rstcheck

To use pyproject.toml for configuration:

$ pip install rstcheck[toml]

To add sphinx support:

$ pip install rstcheck[sphinx]

Supported languages in code blocks

  • Bash

  • Doctest

  • C (C99)

  • C++ (C++11)

  • JSON

  • XML

  • Python

  • reStructuredText

Examples

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rstcheck-6.0.0.post1.tar.gz (17.7 kB view details)

Uploaded Source

Built Distribution

rstcheck-6.0.0.post1-py3-none-any.whl (6.9 kB view details)

Uploaded Python 3

File details

Details for the file rstcheck-6.0.0.post1.tar.gz.

File metadata

  • Download URL: rstcheck-6.0.0.post1.tar.gz
  • Upload date:
  • Size: 17.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.8.10 Linux/5.4.0-113-generic

File hashes

Hashes for rstcheck-6.0.0.post1.tar.gz
Algorithm Hash digest
SHA256 2f69b972c682fbb6618e969273962f77c4307d6900e013b4d74f674f13fc81cb
MD5 84437b8af9705814316bba03d89d5520
BLAKE2b-256 f64311daf16186753b681648c76c1c5577576ae089c997bea644161ccc2f91e8

See more details on using hashes here.

File details

Details for the file rstcheck-6.0.0.post1-py3-none-any.whl.

File metadata

  • Download URL: rstcheck-6.0.0.post1-py3-none-any.whl
  • Upload date:
  • Size: 6.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.8.10 Linux/5.4.0-113-generic

File hashes

Hashes for rstcheck-6.0.0.post1-py3-none-any.whl
Algorithm Hash digest
SHA256 c5230cbb25d0db9c7d27a1a04e0dfe047220206f5e79e11f0110aa82f564399c
MD5 c93bfcd948c74cd5114bb75248282fc6
BLAKE2b-256 02c362f3680e18df189b9f7294582b55cfb8c27bfb4e00c67f08949b77fad79b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page