Fix given decorator type hint when decorating async functions (#3100)

humrochagf · web-flow · commit 642f5486c276 · 2021-09-16T10:27:24.000+10:00
diff --git a/AUTHORS.rst b/AUTHORS.rst
@@ -58,6 +58,7 @@ their individual contributions.
 * `Gregory Petrosyan <https://github.com/flyingmutant>`_
 * `Grigorios Giannakopoulos <https://github.com/grigoriosgiann>`_
 * `Hugo van Kemenade <https://github.com/hugovk>`_
+* `Humberto Rocha <https://github.com/humrochagf>`_
 * `Ilya Lebedev <https://github.com/melevir>`_ (melevir@gmail.com)
 * `Israel Fruchter <https://github.com/fruch>`_
 * `Jack Massey <https://github.com/massey101>`_
diff --git a/guides/documentation.rst b/guides/documentation.rst
@@ -88,4 +88,4 @@ which should:
 - finish with a note of thanks from the maintainers:
   "Thanks to <your name> for this bug fix / feature / contribution"
   (depending on which it is).  If this is your first contribution,
-  don't forget to add yourself to contributors.rst!
+  don't forget to add yourself to AUTHORS.rst!
diff --git a/hypothesis-python/RELEASE.rst b/hypothesis-python/RELEASE.rst
@@ -0,0 +1,5 @@
+RELEASE_TYPE: patch
+
+This release fixes the type hint for the
+:func:`@given() <hypothesis.given>` decorator
+when decorating an ``async`` function (:issue:`3099`).
diff --git a/hypothesis-python/src/hypothesis/core.py b/hypothesis-python/src/hypothesis/core.py
@@ -30,7 +30,17 @@
 from collections import defaultdict
 from io import StringIO
 from random import Random
-from typing import Any, BinaryIO, Callable, Hashable, List, Optional, TypeVar, Union
+from typing import (
+    Any,
+    BinaryIO,
+    Callable,
+    Coroutine,
+    Hashable,
+    List,
+    Optional,
+    TypeVar,
+    Union,
+)
 from unittest import TestCase
 
 import attr
@@ -941,7 +951,9 @@ def fuzz_one_input(
 def given(
     *_given_arguments: Union[SearchStrategy, InferType],
     **_given_kwargs: Union[SearchStrategy, InferType],
-) -> Callable[[Callable[..., None]], Callable[..., None]]:
+) -> Callable[
+    [Callable[..., Union[None, Coroutine[Any, Any, None]]]], Callable[..., None]
+]:
     """A decorator for turning a test function that accepts arguments into a
     randomized test.
 
