Skip to main content

rstcheck

General

Maintenance - intended License Semantic Versioning - 2.0.0

Read the Docs - Build Status (latest)

CI

Test status Documentation status QA status pre-commit 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]

Pre-commit Hook with Extras

To use rstcheck in a Git pre-commit hook with optional features:

  1. Install pre-commit:

    pip install pre-commit
  2. Add to .pre-commit-config.yaml:

    - repo: https://github.com/rstcheck/rstcheck
      rev: main # should be replaced with the current verison
      hooks:
        - id: rstcheck
          additional_dependencies: ['rstcheck[sphinx,toml]']
  3. Run pre-commit install to activate.

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.

Metadata

Release files for rstcheck 6.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rstcheck 6.3.1
File Size Uploaded Provenance Actions
rstcheck-6.3.1.tar.gz 26.3 kB Without provenance Details for rstcheck-6.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for rstcheck 6.3.1
File Interpreter ABI Platform Actions
rstcheck-6.3.1-py3-none-any.whl Python 3 none any Details for rstcheck-6.3.1-py3-none-any.whl

Total release size: 35.3 kB

Release files / rstcheck-6.3.1.tar.gz

Download URL rstcheck-6.3.1.tar.gz
Size 26.3 kB
Tags Source
SHA-256 checksum
How to use checksums
89715eb0b46f22f46b877a37b404efae79aab989a26747fa892cb098760b43ac
BLAKE2b-256 checksum
How to use checksums
5cdb835f07a77064b2f3f7436f8174b8026d0d20cc2b806ffd8f17c1c9f12b2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / rstcheck-6.3.1-py3-none-any.whl

Download URL rstcheck-6.3.1-py3-none-any.whl
Size 9.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1d6db7c9461932ffa9b3fb87130f1abbbd372f2cb961091e39d3ce26b5e17e14
BLAKE2b-256 checksum
How to use checksums
3f1993b1006330aa58681bcbfdb8bdc2247eb47a14fce22d811672b7e2efb91d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for rstcheck 6.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

6.3.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page