Skip to content

stdtypes don't mention asyncio generic classes #131417

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
asvetlov opened this issue Mar 18, 2025 · 4 comments
Open

stdtypes don't mention asyncio generic classes #131417

asvetlov opened this issue Mar 18, 2025 · 4 comments
Labels
docs Documentation in the Doc dir easy topic-asyncio

Comments

@asvetlov
Copy link
Contributor

asvetlov commented Mar 18, 2025

@asvetlov asvetlov added the docs Documentation in the Doc dir label Mar 18, 2025
@github-project-automation github-project-automation bot moved this to Todo in asyncio Mar 18, 2025
@picnixz picnixz added 3.14 bugs and security fixes and removed 3.14 bugs and security fixes labels Mar 18, 2025
@JelleZijlstra
Copy link
Member

Note the list explicitly says it's not exhaustive. I don't object to adding the asyncio ones but maybe we should trim down the list to builtin types instead.

@gvanrossum
Copy link
Member

I personally think it's nuts trying to keep such a list up to date. What is it even useful for? Maybe we can just remove it?

@AA-Turner
Copy link
Member

Could we say something like?:

'Many types in the standard library can be parameterised, including each of the built-in collection types and all of the types in collections.abc. Refer to the documentation for a specific class for information on its support for parameterised generics'

I agree with Guido that having such a long list isn't very helpful, especially now that generics are so widely supported in the stdlib (I didn't even realise the list existed).

A

asvetlov added a commit that referenced this issue Mar 19, 2025
…s list (#131422)

Mention asyncio Future and Task in docs for generic classes list
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Mar 19, 2025
…classes list (pythonGH-131422)

Mention asyncio Future and Task in docs for generic classes list
(cherry picked from commit 61b4b2c)

Co-authored-by: Andrew Svetlov <[email protected]>
miss-islington pushed a commit to miss-islington/cpython that referenced this issue Mar 19, 2025
…classes list (pythonGH-131422)

Mention asyncio Future and Task in docs for generic classes list
(cherry picked from commit 61b4b2c)

Co-authored-by: Andrew Svetlov <[email protected]>
asvetlov added a commit that referenced this issue Mar 19, 2025
… classes list (GH-131422) (#131445)

gh-131417: Mention asyncio Future and Task in docs for generic classes list (GH-131422)

Mention asyncio Future and Task in docs for generic classes list
(cherry picked from commit 61b4b2c)

Co-authored-by: Andrew Svetlov <[email protected]>
asvetlov added a commit that referenced this issue Mar 19, 2025
… classes list (GH-131422) (#131446)

gh-131417: Mention asyncio Future and Task in docs for generic classes list (GH-131422)

Mention asyncio Future and Task in docs for generic classes list
(cherry picked from commit 61b4b2c)

Co-authored-by: Andrew Svetlov <[email protected]>
@asvetlov
Copy link
Contributor Author

Ok, I'll make a PR to remove the list

colesbury pushed a commit to colesbury/cpython that referenced this issue Mar 20, 2025
…classes list (python#131422)

Mention asyncio Future and Task in docs for generic classes list
seehwan pushed a commit to seehwan/cpython that referenced this issue Apr 16, 2025
…classes list (python#131422)

Mention asyncio Future and Task in docs for generic classes list
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir easy topic-asyncio
Projects
Status: Todo
Status: Todo
Development

No branches or pull requests

5 participants