From 440042ff8754d03f1fbd1d714bc4f4fec987d125 Mon Sep 17 00:00:00 2001 From: Yongtao Huang Date: Thu, 18 Dec 2025 11:58:13 +0800 Subject: [PATCH] Fix Context.items/keys/values docstrings (return iterators, not lists) _contextvars.Context.items(), .keys(), and .values() return iterator objects, but their docstrings incorrectly claim they return lists. Signed-off-by: Yongtao Huang --- Python/context.c | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Python/context.c b/Python/context.c index 606ce4b1c8f..392e82b00c9 100644 --- a/Python/context.c +++ b/Python/context.c @@ -650,12 +650,12 @@ _contextvars.Context.items Return all variables and their values in the context object. -The result is returned as a list of 2-tuples (variable, value). +The result is returned as an iterator of 2-tuples (variable, value). [clinic start generated code]*/ static PyObject * _contextvars_Context_items_impl(PyContext *self) -/*[clinic end generated code: output=fa1655c8a08502af input=00db64ae379f9f42]*/ +/*[clinic end generated code: output=fa1655c8a08502af input=f9c1fe4d39962ea0]*/ { return _PyHamt_NewIterItems(self->ctx_vars); } @@ -664,12 +664,12 @@ _contextvars_Context_items_impl(PyContext *self) /*[clinic input] _contextvars.Context.keys -Return a list of all variables in the context object. +Return an iterator of all variables in the context object. [clinic start generated code]*/ static PyObject * _contextvars_Context_keys_impl(PyContext *self) -/*[clinic end generated code: output=177227c6b63ec0e2 input=114b53aebca3449c]*/ +/*[clinic end generated code: output=177227c6b63ec0e2 input=f806e4e5f77c7e7e]*/ { return _PyHamt_NewIterKeys(self->ctx_vars); } @@ -678,12 +678,12 @@ _contextvars_Context_keys_impl(PyContext *self) /*[clinic input] _contextvars.Context.values -Return a list of all variables' values in the context object. +Return an iterator of all variables' values in the context object. [clinic start generated code]*/ static PyObject * _contextvars_Context_values_impl(PyContext *self) -/*[clinic end generated code: output=d286dabfc8db6dde input=ce8075d04a6ea526]*/ +/*[clinic end generated code: output=d286dabfc8db6dde input=6f3cb30499d55021]*/ { return _PyHamt_NewIterValues(self->ctx_vars); }