REDROOM

Create

Preview: coroutines.py Size: 3.26 KB

//lib64/python3.12/asyncio/coroutines.py

__all__ = 'iscoroutinefunction', 'iscoroutine'

import collections.abc
import inspect
import os
import sys
import types


def _is_debug_mode():
    # See: https://docs.python.org/3/library/asyncio-dev.html#asyncio-debug-mode.
    return sys.flags.dev_mode or (not sys.flags.ignore_environment and
                                  bool(os.environ.get('PYTHONASYNCIODEBUG')))


# A marker for iscoroutinefunction.
_is_coroutine = object()


def iscoroutinefunction(func):
    """Return True if func is a decorated coroutine function."""
    return (inspect.iscoroutinefunction(func) or
            getattr(func, '_is_coroutine', None) is _is_coroutine)


# Prioritize native coroutine check to speed-up
# asyncio.iscoroutine.
_COROUTINE_TYPES = (types.CoroutineType, collections.abc.Coroutine)
_iscoroutine_typecache = set()


def iscoroutine(obj):
    """Return True if obj is a coroutine object."""
    if type(obj) in _iscoroutine_typecache:
        return True

    if isinstance(obj, _COROUTINE_TYPES):
        # Just in case we don't want to cache more than 100
        # positive types.  That shouldn't ever happen, unless
        # someone stressing the system on purpose.
        if len(_iscoroutine_typecache) < 100:
            _iscoroutine_typecache.add(type(obj))
        return True
    else:
        return False


def _format_coroutine(coro):
    assert iscoroutine(coro)

    def get_name(coro):
        # Coroutines compiled with Cython sometimes don't have
        # proper __qualname__ or __name__.  While that is a bug
        # in Cython, asyncio shouldn't crash with an AttributeError
        # in its __repr__ functions.
        if hasattr(coro, '__qualname__') and coro.__qualname__:
            coro_name = coro.__qualname__
        elif hasattr(coro, '__name__') and coro.__name__:
            coro_name = coro.__name__
        else:
            # Stop masking Cython bugs, expose them in a friendly way.
            coro_name = f'<{type(coro).__name__} without __name__>'
        return f'{coro_name}()'

    def is_running(coro):
        try:
            return coro.cr_running
        except AttributeError:
            try:
                return coro.gi_running
            except AttributeError:
                return False

    coro_code = None
    if hasattr(coro, 'cr_code') and coro.cr_code:
        coro_code = coro.cr_code
    elif hasattr(coro, 'gi_code') and coro.gi_code:
        coro_code = coro.gi_code

    coro_name = get_name(coro)

    if not coro_code:
        # Built-in types might not have __qualname__ or __name__.
        if is_running(coro):
            return f'{coro_name} running'
        else:
            return coro_name

    coro_frame = None
    if hasattr(coro, 'gi_frame') and coro.gi_frame:
        coro_frame = coro.gi_frame
    elif hasattr(coro, 'cr_frame') and coro.cr_frame:
        coro_frame = coro.cr_frame

    # If Cython's coroutine has a fake code object without proper
    # co_filename -- expose that.
    filename = coro_code.co_filename or '<empty co_filename>'

    lineno = 0

    if coro_frame is not None:
        lineno = coro_frame.f_lineno
        coro_repr = f'{coro_name} running at {filename}:{lineno}'

    else:
        lineno = coro_code.co_firstlineno
        coro_repr = f'{coro_name} done, defined at {filename}:{lineno}'

    return coro_repr

Name	Size	Perms	Modified	Actions
__pycache__ DIR	-	drwxr-xr-x	2026-01-08 23:02:23	Edit Download recursive recursive
base_events.py	76.73 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
base_futures.py	1.93 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
base_subprocess.py	8.66 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
base_tasks.py	2.61 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
constants.py	1.38 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
coroutines.py	3.26 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
events.py	28.65 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
exceptions.py	1.71 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
format_helpers.py	2.35 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
futures.py	14.00 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
locks.py	18.55 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
log.py	124 B	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
mixins.py	481 B	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
proactor_events.py	32.71 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
protocols.py	6.79 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
queues.py	7.79 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
runners.py	7.06 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
selector_events.py	47.20 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
sslproto.py	31.15 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
staggered.py	6.91 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
streams.py	26.97 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
subprocess.py	7.56 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
taskgroups.py	9.33 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
tasks.py	36.49 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
threads.py	790 B	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
timeouts.py	5.20 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
transports.py	10.47 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
trsock.py	2.42 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
unix_events.py	51.88 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
windows_events.py	31.82 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
windows_utils.py	4.94 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
__init__.py	1.19 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive
__main__.py	3.41 KB	lrw-r--r--	2025-10-09 11:07:00	Edit Download recursive recursive

Directory Contents