Update Sphinx

Author: Cito

docs/conf.py

@@ -95,6 +95,10 @@
 }
 autosummary_generate = True
 
+autodoc_type_aliases = {
+    'AwaitableOrValue': 'graphql.pyutils.AwaitableOrValue'
+}
+
 # GraphQL-core top level modules with submodules that can be omitted.
 # Sometimes autodoc cannot find classes since it is looking for the
 # qualified form, but the documentation has the shorter form.
@@ -145,6 +149,14 @@ def on_missing_reference(app, env, node, contnode):
     if target in ignore_references:
         return contnode
     typ = node.get('reftype')
+    if typ == 'obj':
+        # workaround for https://github.com/sphinx-doc/sphinx/issues/8818
+        if target in ('Any', 'Optional', 'Union'):
+            return contnode
+        base_module, target = target.split('.', 1)
+        name = target.rsplit('.', 1)[-1]
+        if name in ('T', 'GT', 'GNT', 'KT', 'VT'):
+            return contnode
     if typ != 'class':
         return None
     if '.' in target:  # maybe too specific

pyproject.toml

@@ -42,7 +42,7 @@ black = "20.8b1"
 flake8 = "^3.8"
 mypy = "0.782"
 codecov = "^2"
-sphinx = "^3.2"
+sphinx = "^3.4"
 sphinx_rtd_theme = ">=0.5,<1"
 check-manifest = "0.40"
 bump2version = ">=1.0,<2"

src/graphql/pyutils/frozen_dict.py

@@ -1,15 +1,15 @@
 from copy import deepcopy
-from typing import Dict, TypeVar
+from typing import Dict, Generic, TypeVar
 
 from .frozen_error import FrozenError
 
 __all__ = ["FrozenDict"]
 
-K = TypeVar("K")
-T = TypeVar("T", covariant=True)
+KT = TypeVar("KT")
+VT = TypeVar("VT", covariant=True)
 
 
-class FrozenDict(Dict[K, T]):
+class FrozenDict(Dict[KT, VT]):
     """Dictionary that can only be read, but not changed."""
 
     def __delitem__(self, key):

src/graphql/pyutils/frozen_list.py

@@ -1,5 +1,5 @@
 from copy import deepcopy
-from typing import List, TypeVar
+from typing import Generic, List, TypeVar
 
 from .frozen_error import FrozenError
 

tox.ini

@@ -23,7 +23,7 @@ commands =
 [testenv:docs]
 basepython = python3.8
 deps =
-    sphinx>=3.2,<4
+    sphinx>=3.4,<4
     sphinx_rtd_theme>=0.5,<1
 commands =
     sphinx-build -b html -nEW docs docs/_build/html