#7627·requests

`from_key_val_list` 中的 Docstring 示例展示了 3.12 之前的 OrderedDict repr

作者: pactender创建于 2026年9月17日更新于 2026年9月17日

src/requests/utils.pyfrom_key_val_list 文档说明如下:

>>> from_key_val_list([('key', 'val')])
OrderedDict([('key', 'val')])

自 Python 3.12 起,collections.OrderedDict.__repr__ 使用了普通字典的形式(cpython gh-101446),因此在当前支持的任何 Python 中,它实际上会打印为:

OrderedDict({'key': 'val'})

测试代码(Python 3.13.5,requests 2.34.2):

>>> from requests.utils import from_key_val_list
>>> from_key_val_list([('key', 'val')])
OrderedDict({'key': 'val'})
>>> from_key_val_list({'key': 'val'})
OrderedDict({'key': 'val'})

同一文档中的 ValueError 示例仍然准确。两个过时出现的位置分别在第 351 行和第 357 行,对其余包进行 grep 后,没有发现其他出现的情况。我已经准备好了一个两行的修复,如果欢迎的话,我很乐意打开一个 Pull Request。 (比较页面提到,PR 仅限于合作者,因此此问题就不需要了。)