Metadata-Version: 1.2
Name: sphinx-code-include
Version: 1.1.0
Summary: Include source code from any Sphinx project using only its import path
Home-page: https://github.com/ColinKennedy/sphinx-code-include
Author: Colin Kennedy
Author-email: colinvfx@gmail.com
License: BSD-2-Clause
Project-URL: Issue Tracker, https://github.com/ColinKennedy/sphinx-code-include/issues
Project-URL: Documentation, https://sphinx-code-include.readthedocs.io/
Project-URL: Changelog, https://sphinx-code-include.readthedocs.io/en/latest/changelog.html
Description: ========
        Overview
        ========
        
        
        
        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)
        
        .. image :: https://user-images.githubusercontent.com/10103049/67256848-f7422380-f43d-11e9-857a-434ba7bf579f.jpg
        
        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
        
        .. _sphinx.ext.viewcode: https://www.sphinx-doc.org/en/master/usage/extensions/viewcode.html
        
        
        Changelog
        =========
        
        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.
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Utilities
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
