Metadata-Version: 2.1
Name: sphinx-runpython
Version: 0.1
Summary: Run python code in sphinx
Home-page: https://github.com/sdpython/sphinx-runpython
Author: Xavier Dupré
Author-email: xavier.dupre@gmail.com
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: C
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
License-File: LICENSE
Requires-Dist: sphinx

sphinx-runpython: run python code in sphinx
===========================================

.. image:: https://dev.azure.com/xavierdupre3/sphinx-runpython/_apis/build/status/sdpython.sphinx-runpython
    :target: https://dev.azure.com/xavierdupre3/sphinx-runpython/

.. image:: https://badge.fury.io/py/sphinx-runpython.svg
    :target: http://badge.fury.io/py/sphinx-runpython

.. image:: http://img.shields.io/github/issues/sdpython/sphinx-runpython.png
    :alt: GitHub Issues
    :target: https://github.com/sdpython/sphinx-runpython/issues

.. image:: https://img.shields.io/badge/license-MIT-blue.svg
    :alt: MIT License
    :target: http://opensource.org/licenses/MIT

.. image:: https://img.shields.io/github/repo-size/sdpython/sphinx-runpython
    :target: https://github.com/sdpython/sphinx-runpython/
    :alt: size

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black

**sphinx-runpython** implements sphinx extensions including one
to execute code and add the output to the documentation.
The library is released on
`pypi/sphinx-runpython <https://pypi.org/project/sphinx-runpython/>`_
and its documentation is published at
`sphinx-runpython
<http://www.xavierdupre.fr/app/sphinx-runpython/helpsphinx/index.html>`_.

epkg
++++

It implements a list of recurring urls in documentation.

**conf.py**

::

    epkg_dictionary = {'title': 'url' }

**rst**

::

    :epkg:`title`  -> `title <url>`_


runpython
+++++++++

Executes code in the documentation and adds it to documentation.

::

    .. runpython::
        :showcode:

        print("python code")

::

    <<<

    print("python code")

    >>>

    python code
