python · gvanrossum · Mar 23, 2021 · gvanrossum · Mar 23, 2021 · jab
diff --git a/Objects/iterobject.c b/Objects/iterobject.c
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
diff --git a/Doc/glossary.rst b/Doc/glossary.rst
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
+   Return an :term:`asynchronous iterator`. This is the async variant
+   of the :func:`iter` builtin, and behaves similarly.
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
diff --git a/Include/abstract.h b/Include/abstract.h
+/* Takes an AsyncIterable object and returns an AsyncIterator for it.
+   This is typically a new iterator but if the argument is an AsyncIterator,
+   this returns itself. */
+PyAPI_FUNC(PyObject *) PyObject_GetAiter(PyObject *);
diff --git a/Include/iterobject.h b/Include/iterobject.h
@@ -7,6 +7,8 @@ extern "C" {

 PyAPI_DATA(PyTypeObject) PySeqIter_Type;
 PyAPI_DATA(PyTypeObject) PyCallIter_Type;
+PyAPI_DATA(PyTypeObject) PyAsyncCallAwaitable_Type;
diff --git a/Objects/abstract.c b/Objects/abstract.c
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
+   Equivalent to calling ``x.__aiter__()``.

-   *async_iterable* must be an :term:`asynchronous iterable`,
-   and :func:`aiter` returns an asynchronous iterator for it.
+   ``aiter(aiter(x))`` is the same as ``aiter(x)``.
+   (``aiter(x)`` itself has an ``__aiter__()`` method that returns ``self``.)

-   Unlike the :func:`iter` builtin, :func:`aiter` has no 2-argument variant.
-   Often, this variant can be replaced with assignment expressions::
+   Formally, given an :term:`asynchronous iterable`,
+   return an :term:`asynchronous iterator`.
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
		Return an :term:`asynchronous iterator`. This is the async variant
		of the :func:`iter` builtin, and behaves similarly.