Skip to main content

Sphinx extension to include program output

Project description

https://secure.travis-ci.org/NextThought/sphinxcontrib-programoutput.png https://coveralls.io/repos/github/NextThought/sphinxcontrib-programoutput/badge.svg

https://sphinxcontrib-programoutput.readthedocs.org

A Sphinx extension to literally insert the output of arbitrary commands into documents, helping you to keep your command examples up to date.

Installation

Install this extension from PyPI:

pip install sphinxcontrib-programoutput

The extension requires Sphinx 1.7.0 and Python 2.7 or Python 3 (Python 3.5+ is tested) at least.

Usage

Just add this extension to extensions:

extensions = ['sphinxcontrib.programoutput']

Now you’ve two new directives program-output and command-output to insert the output of programs. The former just inserts the output:

.. program-output:: python -V

Output:

Python 2.7.1

The latter directive mimics a shell session, and is intended to show examples:

.. command-output:: python -V

Output:

$ python -V
Python 2.7.1

Please refer to the documentation for comprehensive information about usage and configuration of this extension.

Development and Support

Please refer to the documentation for information on support and the development process.

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

File details

Details for the file sphinxcontrib-programoutput2-0.17.dev14.tar.gz.

File metadata

  • Download URL: sphinxcontrib-programoutput2-0.17.dev14.tar.gz
  • Upload date:
  • Size: 24.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.8.6

File hashes

Hashes for sphinxcontrib-programoutput2-0.17.dev14.tar.gz
Algorithm Hash digest
SHA256 4fdc2def9850c8e6b1ca03043dff90976cbf67ca5f18316e0ba68e5bc8b9646b
MD5 088f569c69a1333a8ee7459a845a8144
BLAKE2b-256 762621a66a6f15b69d769f2c3af26f6a324f9fafa78f10ad022792836ffa1adf

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page