Metadata-Version: 2.1
Name: intersphinx_registry
Version: 0.0.2
Summary: This package provides convenient utilities and data to write a sphinx config file.
Author-email: Matthias Bussonnier <bussonniermatthias@gmail.com>
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: MIT License
Requires-Dist: pytest>=7.0 ; extra == "tests"
Requires-Dist: pytest-xdist ; extra == "tests"
Requires-Dist: requests ; extra == "tests"
Project-URL: Home, https://github.com/Carreau/intersphinx_registry
Provides-Extra: tests

# Intersphinx Registry

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

Usage in `conf.py`

```python
from intersphinx_registry import get_intersphinx_mapping

# ...

intersphinx_mapping = get_intersphinx_mapping()
intersphinx_mapping.update({
    'overwrite': ('<url>', None),
    'my-package' : ('<url>', None),
})
```


## 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 an PR. 











