Intersphinx Registry

A simple utility package that provides a default intersphinx mapping for a large chunk of the Python ecosystem.

Installation

# Core package only (for use in conf.py/Sphinx projects)
pip install intersphinx_registry

# With a command-line interface
pip install intersphinx_registry[cli]
# or
uv tool install intersphinx_registry[cli]
# or
pipx install intersphinx_registry[cli]

You can also use it without installation:

uvx intersphinx-registry[cli] lookup numpy,scipy array

Usage in conf.py

from intersphinx_registry import get_intersphinx_mapping

# ...
intersphinx_mapping = get_intersphinx_mapping(
    packages={"ipython", "matplotlib", "pandas", "python"}
)
intersphinx_mapping.update({
    'overwrite': ('<url>', None),
    'my-package': ('<url>', None),
})

Command-line interface

The package provides a command-line interface for looking up intersphinx targets.

Note

The CLI requires installing the [cli] extra: pip install intersphinx_registry[cli]

$ intersphinx-registry --version
# or
$ intersphinx-registry -v

quick lookup

You can use the lookup command to search for intersphinx targets and webpages across various packages.

Call without arguments to get help:

$ intersphinx-registry lookup

Basic usage:

$ intersphinx-registry lookup <package>[,package] [search_term]

Examples:

$ intersphinx-registry lookup numpy,scipy array
$ intersphinx-registry lookup ipython formatters.html

You can search multiple packages at once:

$ intersphinx-registry lookup numpy,scipy Universal
std:label ufuncs                             NumPy 2.1    'Universal functions (ufunc)'                         https://numpy.org/doc/stable/reference/ufuncs.html#ufuncs
std:label ufuncs-basics                      NumPy 2.1    'Universal functions (ufunc) basics'                  https://numpy.org/doc/stable/user/basics.ufuncs.html#ufuncs-basics
std:label ufuncs-internals                   NumPy 2.1    'Universal functions'                                 https://numpy.org/doc/stable/dev/internals.code-explanations.html#ufuncs-internals
std:doc   reference/ufuncs                   NumPy 2.1    'Universal functions (ufunc)'                         https://numpy.org/doc/stable/reference/ufuncs.html
std:doc   user/basics.ufuncs                 NumPy 2.1    'Universal functions (ufunc) basics'                  https://numpy.org/doc/stable/user/basics.ufuncs.html
std:label non-uniform-random-number-sampling SciPy 1.14.1 'Universal Non-Uniform Random Number Sampling in SciPy' https://docs.scipy.org/doc/scipy/tutorial/stats/sampling.html#non-uniform-random-number-sampling
std:doc   tutorial/stats/sampling            SciPy 1.14.1 'Universal Non-Uniform Random Number Sampling in SciPy' https://docs.scipy.org/doc/scipy/tutorial/stats/sampling.html

Warning

There is no cache; the lookup command downloads the inventory of each mentioned package every time.

You can also use the lookup functionality via the module interface:

$ python -m intersphinx_registry.lookup <package>[,package] [search_term]

Why ?

Sometimes, packages docs move and it's hard to keep track of them. We try to keep the registry up to date, so you do not have to ask yourself questions and update your intersphinx-mapping.

You also might not want to think about adding intersphinx mapping when you refer to dependencies.

A package url is wrong !

Please send a PR updating only this package in the registry.json. We try to link only to stable package, not dev versions.

A package is missing !

We can't do all packages, but if you think a package is widely used and missing, please send a PR.