`tuple of Any(s)` creates a single length tuple type hint `tuple[Any]`

[kylejcaron]

I recently found that the docstring description "tuple of Any(s)" led to the creation of a tuple[Any] type hint in the stub file, however I was expecting the type hint to be an arbitrary length tuple, tuple[Any, ...]

I resolved this for now using the description "tuple of (Any, ...)", but given this description for containers I'd expect "tuple of Any(s)" to also work.

[lagru]

Yes, docstub doesn't yet recognize "tuple" as a special case. But I'm starting to think that it might be worth supporting special treatment if it reduces confusion.

I was and still am a bit unsure how to implement this cleanly and how docstub should behave.

• Under the hood the expression tuple of<type> is equivalent to tuple[<type>].
• We can't make tuple[<type>] auto-expand to tuple[<type>, ...], that would preclude users from actually typing a tuple with one element.
• Given that, that treating tuple of <type> different, feels a bit unexpected? But I can see why one might expect tuple of <type>(s) to indicate tuple[<type>, ...]. The (s) was added as optical sugar and doesn't have any significance yet in how types are translated.