docs and test cleanups

awaitlet/base.py

@@ -63,8 +63,8 @@ def _safe_cancel_awaitable(awaitable: Awaitable[Any]) -> None:
 def awaitlet(awaitable: Awaitable[_T]) -> _T:
     """Awaits an async function in a sync method.
 
-    The sync method must be inside a :func:`greenlet_spawn` context.
-    :func:`await_` calls cannot be nested.
+    The sync method must be inside a :func:`async_def` context.
+    :func:`awaitlet` calls cannot be nested.
 
     :param awaitable: The coroutine to call.
 
@@ -95,7 +95,7 @@ async def async_def(
 ) -> _T:
     """Runs a sync function ``fn`` in a new greenlet.
 
-    The sync function can then use :func:`await_` to wait for async
+    The sync function can then use :func:`awaitlet` to wait for async
     functions.
 
     :param fn: The sync callable to call.
@@ -106,15 +106,15 @@ async def async_def(
     result: Any
     context = _AsyncIoGreenlet(fn, greenlet.getcurrent())
     # runs the function synchronously in gl greenlet. If the execution
-    # is interrupted by await_, context is not dead and result is a
+    # is interrupted by awaitlet, context is not dead and result is a
     # coroutine to wait. If the context is dead the function has
     # returned, and its result can be returned.
     switch_occurred = False
     result = context.switch(*args, **kwargs)
     while not context.dead:
         switch_occurred = True
         try:
-            # wait for a coroutine from await_ and then return its
+            # wait for a coroutine from awaitlet and then return its
             # result back to it.
             value = await result
         except BaseException:

awaitlet/util/testing.py

@@ -9,7 +9,6 @@
 from typing import TypeVar
 from typing import Union
 
-from .langhelpers import _pytest_fn_decorator
 from .typing import Self
 
 _T = TypeVar("_T", bound=Any)
@@ -25,9 +24,8 @@ def ne_(a, b, msg=None):
     assert a != b, msg or "%r == %r" % (a, b)
 
 
-def _run_coroutine_function(fn, *args, **kwargs):
-    runner = _Runner()  # runner it lazy so it can be created here
-    return runner.run(fn(*args, **kwargs))
+def run_coroutine_function(fn, *args, **kwargs):
+    return _runner.run(fn(*args, **kwargs))
 
 
 class _Runner:
@@ -71,13 +69,10 @@ def _lazy_init(self) -> None:
             self._loop = asyncio.new_event_loop()
 
 
-def async_test(fn):
+_runner = _Runner()  # runner it lazy so it can be created here
 
-    @_pytest_fn_decorator
-    def decorate(fn, *args, **kwargs):
-        _run_coroutine_function(fn, *args, **kwargs)
 
-    return decorate(fn)
+async_test: Any = None  # assigned by conftest
 
 
 class _ErrorContainer:

pyproject.toml

@@ -12,7 +12,7 @@ keywords = ["asyncio"]
 license = {file = "LICENSE"}
 requires-python = ">=3.8"
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python",
@@ -21,7 +21,7 @@ classifiers = [
 ]
 
 dependencies = [
-    "greenlet",
+    "greenlet >= 1",
     "typing-extensions >= 4.6.0",
 ]
 
@@ -47,3 +47,6 @@ target-version = ['py38']
 [tool.pytest.ini_options]
 addopts = "--tb native -v -r sfxX -p warnings -p logging --strict-markers"
 python_files = "tests/test_*.py"
+markers = """
+  async_test: mark the given test as async
+"""