Skip to content
Open
12 changes: 9 additions & 3 deletions Doc/using/cmdline.rst
Original file line number Diff line number Diff line change
Expand Up @@ -302,16 +302,22 @@ Miscellaneous options

.. option:: -i

Enter interactive mode after execution.
Enter interactive mode after execution, or force interactive mode even when
:data:`sys.stdin` does not appear to be a terminal.

Using the :option:`-i` option will enter interactive mode in any of the following circumstances\:

* When a script is passed as first argument
* When the :option:`-c` option is used
* When the :option:`-m` option is used

Interactive mode will start even when :data:`sys.stdin` does not appear to be a terminal. The
:envvar:`PYTHONSTARTUP` file is not read.
In these "execute then interact" cases, Python runs the script or command
first and does not read the :envvar:`PYTHONSTARTUP` file before entering
interactive mode.

When :option:`-i` is used only to force interactive mode despite redirected
standard input (for example, ``python -i < /dev/null``), the interpreter
enters interactive mode directly and reads :envvar:`PYTHONSTARTUP` as usual.

This can be useful to inspect global variables or a stack trace when a script
raises an exception. See also :envvar:`PYTHONINSPECT`.
Expand Down
26 changes: 22 additions & 4 deletions Lib/inspect.py
Original file line number Diff line number Diff line change
Expand Up @@ -306,10 +306,28 @@ def isgeneratorfunction(obj):
_is_coroutine_mark = object()

def _has_coroutine_mark(f):
while ismethod(f):
f = f.__func__
f = functools._unwrap_partial(f)
return getattr(f, "_is_coroutine_marker", None) is _is_coroutine_mark
while True:
# Methods: unwrap first (methods cannot be coroutine-marked)
if ismethod(f):
f = f.__func__
continue

# Direct marker check
if getattr(f, "_is_coroutine_marker", None) is _is_coroutine_mark:
return True

# Functions created by partialmethod descriptors keep a __partialmethod__ reference
pm = getattr(f, "__partialmethod__", None)
if isinstance(pm, functools.partialmethod):
f = pm
continue
Comment on lines +319 to +323

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well, this can also be moved forward by one block to avoid the time spent on obtaining the attribute when it is not necessary. I hope I have not bored you with these micro-optimizations.


# partial and partialmethod share .func
if isinstance(f, (functools.partial, functools.partialmethod)):
Copy link

@x42005e1f x42005e1f Dec 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will also add, "for the record", why I do not handle partialmethod objects in this way in the code attached to the original issue. They are not callable, and therefore applying markcoroutinefunction() to them is incorrect, which means they should not be checked. Being defined as a class member, accessing the corresponding attribute will return a regular function object created by partialmethod (or a method object for such a function, if via an instance). Therefore, there is no point in unnecessary iteration, and you can go straight to pm.func (see the block above).

f = f.func
continue

return False

def markcoroutinefunction(func):
"""
Expand Down
21 changes: 21 additions & 0 deletions Lib/test/test_inspect/test_inspect.py
Original file line number Diff line number Diff line change
Expand Up @@ -380,6 +380,27 @@ def do_something_static():

coro.close(); gen_coro.close(); # silence warnings

def test_marked_partials_are_coroutinefunctions(self):
def regular_function():
pass

marked_partial = inspect.markcoroutinefunction(
functools.partial(regular_function))
self.assertTrue(inspect.iscoroutinefunction(marked_partial))
self.assertFalse(
inspect.iscoroutinefunction(functools.partial(regular_function)))

class PMClass:
def method(self, /):
pass

marked = inspect.markcoroutinefunction(
functools.partialmethod(method))
unmarked = functools.partialmethod(method)

self.assertTrue(inspect.iscoroutinefunction(PMClass.marked))
self.assertFalse(inspect.iscoroutinefunction(PMClass.unmarked))

def test_isawaitable(self):
def gen(): yield
self.assertFalse(inspect.isawaitable(gen()))
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
Fix ``inspect.iscoroutinefunction()`` incorrectly returning ``False`` for
callables wrapped in ``functools.partial`` or ``functools.partialmethod`` when
explicitly marked with ``inspect.markcoroutinefunction()``. The function now
detects coroutine markers on wrappers at each unwrap stage.
Loading