Converting collections.deque methods to Argument Clinic

[corona10]

BPO	41361
Nosy	@rhettinger, @larryhastings, @serhiy-storchaka, @corona10, @sweeneyde
PRs	bpo-41361: Converting collections.deque methods to Argument Clinic #21584 bpo-41361: Optimized argument parsing for deque_rotate #24796

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = 'https://github.com/rhettinger'
closed_at = <Date 2020-07-22.07:19:48.773>
created_at = <Date 2020-07-21.15:26:01.614>
labels = ['type-feature', 'invalid', 'expert-argument-clinic', '3.10']
title = 'Converting collections.deque methods to Argument Clinic'
updated_at = <Date 2021-03-16.04:02:51.139>
user = 'https://github.com/corona10'

bugs.python.org fields:

activity = <Date 2021-03-16.04:02:51.139>
actor = 'rhettinger'
assignee = 'rhettinger'
closed = True
closed_date = <Date 2020-07-22.07:19:48.773>
closer = 'rhettinger'
components = ['Argument Clinic']
creation = <Date 2020-07-21.15:26:01.614>
creator = 'corona10'
dependencies = []
files = []
hgrepos = []
issue_num = 41361
keywords = ['patch']
message_count = 9.0
messages = ['374068', '374078', '374082', '374085', '374087', '388226', '388323', '388806', '388807']
nosy_count = 5.0
nosy_names = ['rhettinger', 'larry', 'serhiy.storchaka', 'corona10', 'Dennis Sweeney']
pr_nums = ['21584', '24796']
priority = 'normal'
resolution = 'not a bug'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue41361'
versions = ['Python 3.10']

[corona10]

There was no performance regressin with this change.

[serhiy-storchaka]

See also bpo-20180. collections.deque was intentionally not converted to Argument Clinic, but some of methods were made using more efficient code for parsing arguments by inlining the code generated by Argument Clinic at that time.

[corona10]

collections.deque was intentionally not converted to Argument Clinic,

Oh, I see ..

[serhiy-storchaka]

Now Argument Clinic generates more efficient (but more cumbersome) code, so there may be new reasons of using it. Please test the performance of the deque constructor (deque(), deque(()), deque((), 10), deque((), maxlen=10)), methods index() and rotate(), builtins iter() and reversed(). It is hard to test insert() because it mutates the deque and I do not expect anything beside noise for other methods.

[rhettinger]

I think we should skip applying the clinic to the code. It jumbles the code quite a bit but doesn't give any real benefit.