Metadata-Version: 2.4
Name: sphinxcontrib-programoutput
Version: 0.19
Summary: Sphinx extension to include program output
Home-page: https://sphinxcontrib-programoutput.readthedocs.org/
Author: Sebastian Wiesner
Author-email: lunaryorn@gmail.com
Maintainer: Jason Madden
Maintainer-email: jason@seecoresoftware.com
License: BSD
Project-URL: Homepage, https://sphinxcontrib-programoutput.readthedocs.io/en/latest/
Project-URL: Documentation, https://sphinxcontrib-programoutput.readthedocs.io/en/latest/
Project-URL: Repository, https://github.com/OpenNTI/sphinxcontrib-programoutput/
Project-URL: Issues, https://github.com/OpenNTI/sphinxcontrib-programoutput/issues
Project-URL: Changelog, https://github.com/OpenNTI/sphinxcontrib-programoutput/blob/master/CHANGES.rst
Keywords: sphinx cli command output program example
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Documentation
Classifier: Topic :: Utilities
Classifier: Framework :: Sphinx
Classifier: Framework :: Sphinx :: Extension
Requires-Python: >=3.8
License-File: LICENSE
Requires-Dist: Sphinx>=5.0.0
Provides-Extra: test
Requires-Dist: erbsland-sphinx-ansi; python_version >= "3.10" and extra == "test"
Provides-Extra: docs
Requires-Dist: furo; extra == "docs"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: platform
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

=============================
 sphinxcontrib-programoutput
=============================


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 5.0 and Python 3.8+.

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 3.14.2

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

   .. command-output:: python -V

Output::

   $ python -V
   Python 3.14.2


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.


.. _Sphinx: http://www.sphinx-doc.org/en/stable/
.. _PyPI: http://pypi.org/project/sphinxcontrib-programoutput
.. _documentation: http://sphinxcontrib-programoutput.readthedocs.org
