Fix sphinx nitpick error arising from annotations

Type annotations can use variable names in order to support easily
named constructs (e.g. `FooType = Union[int, str]; x: FooType`).
However, such variable names are then seen by sphinx autodoc, which
does not evaluate them. As a result, for such a name to avoid tripping
nitpick warnings, these names need to be resolvable.

The simplest resolution is to remove the use of any internal variables
for this purpose (at least where they would be seen by sphinx), and
use the longhand description of types in such cases.

Author: sirosen

jsonschema/_types.py

@@ -8,19 +8,24 @@
 
 from jsonschema.exceptions import UndefinedTypeCheck
 
-# internal type declarations for annotations
-_TypeCheckerFunc = typing.Callable[["TypeChecker", typing.Any], bool]
-_TypeCheckerMapping = typing.Mapping[str, _TypeCheckerFunc]
-
 
 # unfortunately, the type of pmap is generic, and if used as the attr.ib
 # converter, the generic type is presented to mypy, which then fails to match
 # the concrete type of a type checker mapping
 # this "do nothing" wrapper presents the correct information to mypy
 def _typed_pmap_converter(
-    init_val: _TypeCheckerMapping,
-) -> _TypeCheckerMapping:
-    return typing.cast(_TypeCheckerMapping, pmap(init_val))
+    init_val: typing.Mapping[
+        str,
+        typing.Callable[["TypeChecker", typing.Any], bool],
+    ],
+) -> typing.Mapping[str, typing.Callable[["TypeChecker", typing.Any], bool]]:
+    return typing.cast(
+        typing.Mapping[
+            str,
+            typing.Callable[["TypeChecker", typing.Any], bool],
+        ],
+        pmap(init_val),
+    )
 
 
 def is_array(checker, instance):
@@ -78,8 +83,11 @@ class TypeChecker(object):
             The initial mapping of types to their checking functions.
     """
 
-    _type_checkers: _TypeCheckerMapping = attr.ib(
-        default=pmap(), converter=_typed_pmap_converter,
+    _type_checkers: typing.Mapping[
+        str, typing.Callable[["TypeChecker", typing.Any], bool],
+    ] = attr.ib(
+        default=pmap(),
+        converter=_typed_pmap_converter,
     )
 
     def is_type(self, instance, type):