No project description provided
Project description
shtest tests shell commands in your Sphinx documentation. The shtest
directive supports the usual doctest syntax. It offers the following options:
:returncode: [integer]
specifies the expected return code (defaults to 0).adding the
:stderr:
flag compares results with thestderr
rather thanstdout
stream.:cwd: [relative path]
specifies the working directory relative to the source of the document (defaults to the directory containing the source document).:tempdir:
executes the test in a temporary directory.
Examples
# Obligatory hello world example.
$ echo hello world
hello world
:stderr:
# Read from stderr instead of stdout.
$ echo message on stderr >&2
message on stderr
:returncode: 1
# Use a non-zero expected return code.
$ false
# Run multiple tests in one directive.
$ echo hello
hello
$ echo world
world
:cwd: tests
# Run a test in a particular working directory relative to the document.
$ cat hello.txt
world
:tempdir:
# Run a test in a temporary directory.
$ echo hello > world.txt
Installation
Run pip install sphinxcontrib-shtest
to install the package and add "sphinxcontrib-shtest"
to your extensions
list in conf.py
(see here for details). Then execute sphinx-build -b shtest /path/to/source/directory /path/to/output/directory
.
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
Hashes for sphinxcontrib-shtest-0.4.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3e0e434a1e09868dddc1d67dc150873b45e693296498f47149ba901dd7b0d9d1 |
|
MD5 | a15a5fc1bcecd368a1b356cfd9b6686c |
|
BLAKE2b-256 | 4211a327669ac17a627fff032d092b92b7bd2b9fdd8c7eae9f2089931eac4862 |