aio-libs / yarl / 35425674919

97%

push

github

Replace most `extlinks` w/ `sphinx-issues` in Sphinx config (#1912)

Replace most `extlinks` w/ `sphinx-issues`

The `sphinx-issues` extension provides the `:issue:`, `:pr:`, `:commit:`
and `:user:` roles that were previously hand-rolled via
`sphinx.ext.extlinks`, and is more flexible about how their content is
processed; in the docs, it additionally understands cross-repository
references like `org/repo#123`.

Its default URL templates already match the ones the removed `extlinks`
entries used, including `:user:` pointing at GitHub Sponsors, so only
`issues_github_path` needs configuring. The link captions do change
slightly; `:pr:` renders as `#N` rather than `PR #N` and `:commit:` as
an `@`-prefixed abbreviated SHA, since the extension only accepts `#`,
`@` or `!` as a caption prefix.

`extlinks` is kept for the `:gh:` role, which `sphinx-issues` does not
provide.

Ported from aio-libs/propcache#307, which in turn ports
ansible/pylibssh@55f124d (PR 818).

84 of 168 branches covered (50.0%)

Branch coverage included in aggregate %.

7232 of 7336 relevant lines covered (98.58%)

0.99 hits per line