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: https://opensource.org/license/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
.. image:: https://codecov.io/github/sdpython/sphinx-runpython/branch/main/graph/badge.svg?token=CTUV6EDBB6
:target: https://codecov.io/github/sdpython/sphinx-runpython
**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
<https://sdpython.github.io/doc/sphinx-runpython/dev/>`_.
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
List of directives
++++++++++++++++++
* `blocref <https://sdpython.github.io/doc/sphinx-runpython/dev/api/blocdefs.html>`_
* `collapse <https://sdpython.github.io/doc/sphinx-runpython/dev/api/collapse.html>`_
* `docassert <https://sdpython.github.io/doc/sphinx-runpython/dev/api/docassert.html>`_
* `epkg <https://sdpython.github.io/doc/sphinx-runpython/dev/api/epkg.html>`_
* `exref <https://sdpython.github.io/doc/sphinx-runpython/dev/api/blocdefs.html>`_
* `faqref <https://sdpython.github.io/doc/sphinx-runpython/dev/api/blocdefs.html>`_
* `gdot <https://sdpython.github.io/doc/sphinx-runpython/dev/api/gdot.html>`_
* `mathdef <https://sdpython.github.io/doc/sphinx-runpython/dev/api/blocdefs.html>`_
* `runpython <https://sdpython.github.io/doc/sphinx-runpython/dev/api/runpython.html>`_
* `sphinx_rst_builder <https://sdpython.github.io/doc/sphinx-runpython/dev/api/rst_builder.html>`_
Raw data
{
"_id": null,
"home_page": "https://github.com/sdpython/sphinx-runpython",
"name": "sphinx-runpython",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Xavier Dupr\u00e9",
"author_email": "xavier.dupre@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/f8/6a/01707dec897daa96e0816f76fea67875bed571a872d2178369f3441eb38b/sphinx-runpython-0.2.0.tar.gz",
"platform": null,
"description": "sphinx-runpython: run python code in sphinx\n===========================================\n\n.. image:: https://dev.azure.com/xavierdupre3/sphinx-runpython/_apis/build/status/sdpython.sphinx-runpython\n :target: https://dev.azure.com/xavierdupre3/sphinx-runpython/\n\n.. image:: https://badge.fury.io/py/sphinx-runpython.svg\n :target: http://badge.fury.io/py/sphinx-runpython\n\n.. image:: http://img.shields.io/github/issues/sdpython/sphinx-runpython.png\n :alt: GitHub Issues\n :target: https://github.com/sdpython/sphinx-runpython/issues\n\n.. image:: https://img.shields.io/badge/license-MIT-blue.svg\n :alt: MIT License\n :target: https://opensource.org/license/MIT/\n\n.. image:: https://img.shields.io/github/repo-size/sdpython/sphinx-runpython\n :target: https://github.com/sdpython/sphinx-runpython/\n :alt: size\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n\n.. image:: https://codecov.io/github/sdpython/sphinx-runpython/branch/main/graph/badge.svg?token=CTUV6EDBB6 \n :target: https://codecov.io/github/sdpython/sphinx-runpython\n\n**sphinx-runpython** implements sphinx extensions including one\nto execute code and add the output to the documentation.\nThe library is released on\n`pypi/sphinx-runpython <https://pypi.org/project/sphinx-runpython/>`_\nand its documentation is published at\n`sphinx-runpython\n<https://sdpython.github.io/doc/sphinx-runpython/dev/>`_.\n\nepkg\n++++\n\nIt implements a list of recurring urls in documentation.\n\n**conf.py**\n\n::\n\n epkg_dictionary = {'title': 'url' }\n\n**rst**\n\n::\n\n :epkg:`title` -> `title <url>`_\n\n\nrunpython\n+++++++++\n\nExecutes code in the documentation and adds it to documentation.\n\n::\n\n .. runpython::\n :showcode:\n\n print(\"python code\")\n\n::\n\n <<<\n\n print(\"python code\")\n\n >>>\n\n python code\n\nList of directives\n++++++++++++++++++\n\n* `blocref <https://sdpython.github.io/doc/sphinx-runpython/dev/api/blocdefs.html>`_\n* `collapse <https://sdpython.github.io/doc/sphinx-runpython/dev/api/collapse.html>`_\n* `docassert <https://sdpython.github.io/doc/sphinx-runpython/dev/api/docassert.html>`_\n* `epkg <https://sdpython.github.io/doc/sphinx-runpython/dev/api/epkg.html>`_\n* `exref <https://sdpython.github.io/doc/sphinx-runpython/dev/api/blocdefs.html>`_\n* `faqref <https://sdpython.github.io/doc/sphinx-runpython/dev/api/blocdefs.html>`_\n* `gdot <https://sdpython.github.io/doc/sphinx-runpython/dev/api/gdot.html>`_\n* `mathdef <https://sdpython.github.io/doc/sphinx-runpython/dev/api/blocdefs.html>`_\n* `runpython <https://sdpython.github.io/doc/sphinx-runpython/dev/api/runpython.html>`_\n* `sphinx_rst_builder <https://sdpython.github.io/doc/sphinx-runpython/dev/api/rst_builder.html>`_\n",
"bugtrack_url": null,
"license": "",
"summary": "Run python code in sphinx",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/sdpython/sphinx-runpython"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "375736705e82e651a1e27ced56d6e022ffa2a84c043a855b897f87f3dbb999e3",
"md5": "1edd77db46d6507f06ca073fa85816c7",
"sha256": "b55ccf96e3596973216a0ad00bda615625215e614d8ea72444c6d53ea38c8d4e"
},
"downloads": -1,
"filename": "sphinx_runpython-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1edd77db46d6507f06ca073fa85816c7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 76979,
"upload_time": "2023-09-12T21:46:48",
"upload_time_iso_8601": "2023-09-12T21:46:48.943165Z",
"url": "https://files.pythonhosted.org/packages/37/57/36705e82e651a1e27ced56d6e022ffa2a84c043a855b897f87f3dbb999e3/sphinx_runpython-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f86a01707dec897daa96e0816f76fea67875bed571a872d2178369f3441eb38b",
"md5": "a1d6cc75977ee8fb62d98e5b8f66a544",
"sha256": "0711b06235d613cc9f98315d3dd913cfb5b042e621bd27358adc05e2caa56195"
},
"downloads": -1,
"filename": "sphinx-runpython-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "a1d6cc75977ee8fb62d98e5b8f66a544",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 65275,
"upload_time": "2023-09-12T21:46:50",
"upload_time_iso_8601": "2023-09-12T21:46:50.825636Z",
"url": "https://files.pythonhosted.org/packages/f8/6a/01707dec897daa96e0816f76fea67875bed571a872d2178369f3441eb38b/sphinx-runpython-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-12 21:46:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sdpython",
"github_project": "sphinx-runpython",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "sphinx",
"specs": []
}
],
"lcname": "sphinx-runpython"
}