asyncio.iscoroutinefunction has no docstring due to misplaced import statement

[deadlovelll]

Bug report

Bug description:

In Lib/asyncio/coroutines.py, the iscoroutinefunction() function has its docstring placed after an import warnings statement, which makes the __doc__ method return None

MRE:

  >>> import asyncio
  >>> asyncio.iscoroutinefunction.__doc__ is None
  True

Expected:

  >>> asyncio.iscoroutinefunction.__doc__
  'Return True if func is a decorated coroutine function.'

Fix:
Move the import warnings statement below the docstring.

CPython versions tested on:

CPython main branch

Operating systems tested on:

macOS

Linked PRs

• gh-149694: Fix missing docstring on asyncio.iscoroutinefunction #149695
• [3.15] gh-149694: Fix missing docstring on asyncio.iscoroutinefunction #149696

[picnixz]

asyncio.iscoroutinefunction is removed now. So it would only be for previous versions. But we don't want to advertise the usage so I don't think we want to fix this.