Reflect deprecation for asyncio.iscoroutinefunction

[Avasam]

#12558 by @ZeroIntensity (since the branch was deleted) but without the Python 3.16 mention

I didn't scope the deprecation to only 3.14+ because I think any non-EOL Python version has a migration path. (I don't remember if we have exact guidelines on deprecated decorator)

[github-actions]

Diff from mypy_primer, showing the effect of this PR on open source code:

aiohttp (https://github.com/aio-libs/aiohttp)
+ aiohttp/worker.py:73:44: error: overload def (func: def (*Any, **Any) -> typing.Coroutine[Any, Any, Any]) -> builtins.bool of function asyncio.coroutines.iscoroutinefunction is deprecated: Use inspect.iscoroutinefunction instead  [deprecated]
+ aiohttp/worker.py:73:44: note: See https://mypy.rtfd.io/en/stable/_refs.html#code-deprecated for more info  [deprecated]

[srittau]

If I understand it correctly, it's sometimes necessary to use this on Python < 3.11, since it supports @coroutine (removed in 3.11), which the inspect version doesn't support.

[Avasam]

I'll close this in favor of @max-muoto 's #14289 . In which the tests are also already updated to keep testing both methods.

[Avasam]

I'll close this in favor of @max-muoto 's #14289 . In which the tests are also already updated to keep testing both methods.