CLI

This part of the documentation covers the CLI interface and is auto-generated by sphinx-click extension.

Warning

The CLI interface differs depending on the available opt-in extensions:

  • Sphinx

  • Toml

The documentation shown here uses all opt-in features.

Note

More information about the single configuration options can be found in the Configuration section

Note

If you get an exception and the pretty output makes the exception information unreadable try to run rstcheck with the environment variable _TYPER_STANDARD_TRACEBACK set to 1 like _TYPER_STANDARD_TRACEBACK=1 rstcheck somefile.rst`. Read more at typer’s docs.

rstcheck Usage: rstcheck [OPTIONS] {files}... CLI of rstcheck. Enabled features: ['Sphinx'] Pass one or more RST FILES to check. Can be files or directories if --recursive is passed too. Pass "-" if you want to read from stdin. ╭─ Options ──────────────────────────────────────────────────────────╮ --config<path>Config file to load. Can  be a INI file or          directory. If a directory is passed it will be      searched for              .rstcheck.cfg |           setup.cfg. If 'NONE' is   passed no config file is  loaded at all.            --warn-unknown-settingsLog a WARNING for unknown settings in config files. Can be hidden via         --log-level.              --recursive-rRecursively search passed directories for RST files to check.                 --report-levelLEVEL The report level of the   linting issues found.     Valid levels are: INFO |  WARNING | ERROR | SEVERE  | NONE. Defaults to INFO. Can be set in config      file.                     --log-levelLEVEL The log level of the      application for           information that is not a linting issue. Valid      levels are: DEBUG | INFO  | WARNING | ERROR |       CRITICAL. Defaults to     WARNING.                  [default: WARNING]        --ignore-directives<str>Comma-separated-list of   directives to add to the  ignore list. Can be set   in config file.           --ignore-roles<str>Comma-separated-list of   roles to add to the       ignore list. Can be set   in config file.           --ignore-substitutions<str>Comma-separated-list of   substitutions to add to   the ignore list. Can be   set in config file.       --ignore-languages<str>Comma-separated-list of   languages for code-blocks to add to the ignore      list. The code in ignored code-blocks will not be   checked for errors. Can   be set in config file.    --ignore-messagesREGEX A regular expression to   match linting issue       messages against to       ignore. Can be set in     config file.              --versionPrint versions and exit. --install-completionInstall completion for    the current shell.        --show-completionShow completion for the   current shell, to copy it or customize the          installation.             --helpShow this message and     exit.                     ╰────────────────────────────────────────────────────────────────────╯