diff --git a/docs/conf.py b/docs/conf.py index ed153d5..df6431b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -1,3 +1,6 @@ +from __future__ import annotations + + extensions = [ 'sphinx.ext.autodoc', 'jaraco.packaging.sphinx', @@ -30,6 +33,7 @@ # Be strict about any broken references nitpicky = True +nitpick_ignore: list[tuple[str, str]] = [] # Include Python intersphinx mapping to prevent failures # jaraco/skeleton#51 @@ -41,11 +45,22 @@ # Preserve authored syntax for defaults autodoc_preserve_defaults = True +# Add support for linking usernames, PyPI projects, Wikipedia pages +github_url = 'https://github.com/' +extlinks = { + 'user': (f'{github_url}%s', '@%s'), + 'pypi': ('https://pypi.org/project/%s', '%s'), + 'wiki': ('https://wikipedia.org/wiki/%s', '%s'), +} +extensions += ['sphinx.ext.extlinks'] + +# local + intersphinx_mapping.update( pytest=('https://docs.pytest.org/en/stable', None), ) -nitpick_ignore = [ +nitpick_ignore += [ ('py:class', 'Config'), ('py:class', 'Session'), ] diff --git a/mypy.ini b/mypy.ini index c9abc7e..4f2d861 100644 --- a/mypy.ini +++ b/mypy.ini @@ -10,8 +10,9 @@ enable_error_code = ignore-without-code # Support namespace packages per https://github.com/python/mypy/issues/14057 explicit_package_bases = True -# Disable overload-overlap due to many false-positives -disable_error_code = overload-overlap +disable_error_code = + # Disable due to many false positives + overload-overlap, # PyCQA/flake8#1560 [mypy-flake8.*]