Skip to main content

This package provides convenient utilities and data to write a sphinx config file.

Project description

Intersphinx Registry

A simple utility package that provide default inter sphinx mapping for a large chunk of the python ecosystem.

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),
})

quick lookup

You can use the following to lookup target/webpages of various packages.

Call without arguments to get help:

$ python -m intersphinx_registry.lookup

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

    Example:

    $ python -m intersphinx_registry.lookup numpy,scipy array
    $ python -m intersphinx_registry.lookup ipython formatters.html

You can search multiple packages as once.

$ python -m 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, it downloads the inventory of each mentioned package every time.

Why ?

Sometime packages docs move and it's hard to keep track of. We try to keep the registry up to date, so yo 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

intersphinx_registry-0.2511.25.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

intersphinx_registry-0.2511.25-py2.py3-none-any.whl (9.1 kB view details)

Uploaded Python 2Python 3

File details

Details for the file intersphinx_registry-0.2511.25.tar.gz.

File metadata

  • Download URL: intersphinx_registry-0.2511.25.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for intersphinx_registry-0.2511.25.tar.gz
Algorithm Hash digest
SHA256 9f70f166f12515db166cebae770d8d4a60f570c4fda38fc6475b540c88941bba
MD5 fe83148497e2080a68747bc514a25084
BLAKE2b-256 877fe9c0be5cb6f619212c60b2d68796a751318b904e721ba88f1f06602e05f8

See more details on using hashes here.

Provenance

The following attestation bundles were made for intersphinx_registry-0.2511.25.tar.gz:

Publisher: publish.yml on Quansight-Labs/intersphinx_registry

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file intersphinx_registry-0.2511.25-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for intersphinx_registry-0.2511.25-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 d6974655c05ab055f7261d108f7b613a06fb4aa6b064b413d8bd02e650f64a73
MD5 e27f4ad8f3d4c4b9ad72c2f680778c46
BLAKE2b-256 d6a054cd7dd06ecb379a748c6830d1ccf4f1e1c751b025a0df4a9e3c12f8e796

See more details on using hashes here.

Provenance

The following attestation bundles were made for intersphinx_registry-0.2511.25-py2.py3-none-any.whl:

Publisher: publish.yml on Quansight-Labs/intersphinx_registry

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page