Usage: doccmd [OPTIONS] [DOCUMENT_PATHS]...

  Run commands against code blocks in the given documentation files.

  This works with Markdown and reStructuredText files.

Options:
  -l, --language TEXT             Run `command` against code blocks for this
                                  language. Give multiple times for multiple
                                  languages.  [required]
  -c, --command TEXT              [required]
  --temporary-file-extension TEXT
                                  The file extension to give to the temporary
                                  file made from the code block. By default, the
                                  file extension is inferred from the language,
                                  or it is '.txt' if the language is not
                                  recognized.
  --temporary-file-name-prefix TEXT
                                  The prefix to give to the temporary file made
                                  from the code block. This is useful for
                                  distinguishing files created by this tool from
                                  other files, e.g. for ignoring in linter
                                  configurations.  [default: doccmd; required]
  --skip-marker TEXT              The marker used to identify code blocks to be
                                  skipped.
                                  
                                  By default, code blocks which come just after
                                  a comment matching 'skip doccmd[all]: next'
                                  are skipped (e.g. `.. skip doccmd[all]: next`
                                  in reStructuredText, `<!--- skip doccmd[all]:
                                  next -->` in Markdown, or `% skip doccmd[all]:
                                  next` in MyST).
                                  
                                  When using this option, those, and code blocks
                                  which come just after a comment including the
                                  given marker are ignored. For example, if the
                                  given marker is 'type-check', code blocks
                                  which come just after a comment matching 'skip
                                  doccmd[type-check]: next' are also skipped.
                                  
                                  This marker is matched using a regular
                                  expression.
                                  
                                  To skip a code block for each of multiple
                                  markers, for example to skip a code block for
                                  the ``type-check`` and ``lint`` markers but
                                  not all markers, add multiple ``skip doccmd``
                                  comments above the code block.
  --pad-file / --no-pad-file      Run the command against a temporary file
                                  padded with newlines. This is useful for
                                  matching line numbers from the output to the
                                  relevant location in the document. Use --no-
                                  pad-file for formatters - they generally need
                                  to look at the file without padding.
                                  [default: pad-file]
  --version                       Show the version and exit.
  -v, --verbose                   Enable verbose output.
  --use-pty                       Use a pseudo-terminal for running commands.
                                  This can be useful e.g. to get color output,
                                  but can also break in some environments. Not
                                  supported on Windows.  [default: (--detect-
                                  use-pty)]
  --no-use-pty                    Do not use a pseudo-terminal for running
                                  commands. This is useful when ``doccmd``
                                  detects that it is running in a TTY outside of
                                  Windows but the environment does not support
                                  PTYs.  [default: (--detect-use-pty)]
  --detect-use-pty                Automatically determine whether to use a
                                  pseudo-terminal for running commands.
                                  [default: (True)]
  --rst-extension TEXT            Treat files with this extension (suffix) as
                                  reStructuredText. Give this multiple times to
                                  look for multiple extensions. To avoid
                                  considering any files, including the default,
                                  as reStructuredText files, use `--rst-
                                  extension=.`.  [default: .rst]
  --myst-extension TEXT           Treat files with this extension (suffix) as
                                  MyST. Give this multiple times to look for
                                  multiple extensions. To avoid considering any
                                  files, including the default, as MyST files,
                                  use `--myst-extension=.`.  [default: .md]
  --markdown-extension TEXT       Files with this extension (suffix) to treat as
                                  Markdown. Give this multiple times to look for
                                  multiple extensions. By default, `.md` is
                                  treated as MyST, not Markdown.
  --max-depth INTEGER RANGE       Maximum depth to search for files in
                                  directories.  [x>=1]
  --exclude TEXT                  A glob-style pattern that matches file paths
                                  to ignore while recursively discovering files
                                  in directories. This option can be used
                                  multiple times. Use forward slashes on all
                                  platforms.
  --help                          Show this message and exit.
