Sphinx Prompt
Table of contents
Initialise
In conf.py
add extensions += ['sphinx-prompt']
.
Syntax
A default prompt can be created using a prompt
directive:
.. prompt:: <statements>
The prompt can be further customized in one of two ways:
Using positional arguments:
.. prompt:: [<language> [<prompts> [<modifiers>]]] <statements>
Using options:
.. prompt:: :language: <language> :prompts: <prompts> :modifiers: <modifiers> <statements>
While these constructs generate the same output, the positional arguments cannot be used if you want to use a prompt that contains spaces. This is a limitation of reStructuredText.
Positional arguments can be mixed with options if they don't overlap (so if you pass prompts using options, you can only pass the language using positional arguments):
.. prompt:: bash :prompts: (cool_project) $ python3 -m pip install --upgrade sphinx-prompt
Language
Supported language:
text
(no pigments, default)bash
batch
powershell
python
scala
Prompt(s)
If modifier is auto, a comma-separated list of prompts to find in the statements.
Else the prompt to add on each statements, for Python and Bash language the end
\
is supported.
Defaults to empty, except for the shell languages listed below:
bash
-$
batch
-C:\>
powershell
-PS C:\>
Examples
See: http://sbrunner.github.io/sphinx-prompt/
Run tests and prospector
python3 -m pip install --user --upgrade poetry poetry install poetry run pytest poetry run prospector
The code should be formatted with black
add isort
.
Create new release
Update the version in setup.cfg.
python3 -m pip install --user --upgrade git-changelog git-changelog . > CHANGELOG.md git add setup.cfg CHANGELOG.md git commit -m "Do the release <version>" git tag <version> git push origin <version> git push