René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Functions that are actually classes","articleBody":"@hatal175 has been fixing several typeshed definitions and was recently looking at itertools. Many documented-as-functions in itertools are currently functions in typeshed, but actually classes at runtime, e.g. `itertools.count`. The proposed change is to make them classes.\r\n\r\nPros:\r\n1) Makes typeshed consistent with runtime (albeit undocumented facet of the runtime)\r\n2) Allows users to do things that depend on these being classes, e.g. type checkers will understand `isinstance(x, itertools.count)` (admittedly rare)\r\n\r\nCons:\r\n1) Change can cause annoying false positives because type checkers are often strict about redefinition. E.g. https://github.com/python/mypy/pull/10255\r\n\r\nMy opinion is that we do nothing (except for maybe linking this issue in the allowlists ;-) ), since I think the con has a more real impact than the pros. Curious for others' thoughts?","author":{"url":"https://github.com/hauntsaninja","@type":"Person","name":"hauntsaninja"},"datePublished":"2021-03-28T05:35:47.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":10},"url":"https://github.com/5145/typeshed/issues/5145"}