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.7.tar.gz (8.4 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.7-py2.py3-none-any.whl (9.1 kB view details)

Uploaded Python 2Python 3

File details

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

File metadata

  • Download URL: intersphinx_registry-0.2511.7.tar.gz
  • Upload date:
  • Size: 8.4 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.7.tar.gz
Algorithm Hash digest
SHA256 c13da09c7bb8b94e084680bee8d48b340ec4ba5c3aaf2012cbc36cd0184baad9
MD5 c4e856c7c0b07e55b05be75970784306
BLAKE2b-256 73e5f789ed9c3201c7d251895662543d757d71fc52a1e7f9e51b65075c4d5a34

See more details on using hashes here.

Provenance

The following attestation bundles were made for intersphinx_registry-0.2511.7.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.7-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for intersphinx_registry-0.2511.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 50005301ac7129917690cc989ab13b89b1d1c659b6700451b59700f6c6ccbd1f
MD5 13861e2ce157581884acba112800ed26
BLAKE2b-256 944fb1739beea4607f14ae20275862f339fca787bf204b095c64d1f0863d323b

See more details on using hashes here.

Provenance

The following attestation bundles were made for intersphinx_registry-0.2511.7-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