sphinx-code-include 2.0.0

Include source code from any Sphinx project using only its import path

sphinx-code-include is an extension for Sphinx that lets you render source-code of any class or function directly into your Sphinx documentation using only as string.

• Free software: BSD 2-Clause License

Example

.. code-include :: :func:`os.path.join`

This code-include block renders as: (theme is sphinx_rtd_theme)

As long as the string you’ve chosen is either

• is importable

• is coming from a project that has sphinx.ext.viewcode enabled

then code-include can find it and render it in your documentation.

Installation

pip install sphinx-code-include

You can also install the in-development version with:

pip install https://github.com/ColinKennedy/sphinx-code-include/archive/master.zip

Documentation

https://sphinx-code-include.readthedocs.io/

Development

To run the all tests run:

tox

Changelog

2.0.1 (2025-01-08)

• Dropped Python 2.7-3.8 support

• Added better CI + mypy

1.4.0 (2024-03-16)

• Added better CI, updated GitHub badges, various quality of life changes

1.3.0 (2024-03-14)

• Added explicit, separate GitHub workflow actions

1.2.0 (2024-03-13)

• Added Python 3.10 support

• Added initial GitHub workflow actions

1.1.2 (2023-04-22)

• Added missing user_agent information. See https://github.com/ColinKennedy/sphinx-code-include/issues/5

1.1.1 (2019-10-26)

• Fixed the requirements of the PyPI package

1.1.0 (2019-10-26)

• Added :link-to-source: and :link-to-documentation: options

• Added support for the :obj: tag (which can be used in place of :class:, :func:, or :meth:)

1.0.0 (2019-10-20)

• First release on PyPI.