René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"`pydoc` renders `from builtins.type` note, even if it is incorrect","articleBody":"While working on https://github.com/python/cpython/pull/97958 I've noticed that there's something strange with `help()` and `classmethod`s.\r\n\r\nTake a look at this example:\r\n\r\n```python\r\nimport pydoc\r\n\r\nclass My:\r\n    @classmethod\r\n    def __init_subclass__(cls, *args, **kwargs):\r\n        pass\r\n\r\n    @classmethod\r\n    def custom(cls):\r\n        pass\r\n\r\nprint(pydoc.plain(pydoc.render_doc(My)))\r\n```\r\n\r\nIt prints:\r\n\r\n```\r\nPython Library Documentation: class My in module __main__\r\n\r\nclass My(builtins.object)\r\n |  Class methods defined here:\r\n |\r\n |  __init_subclass__(*args, **kwargs) from builtins.type\r\n |      This method is called when a class is subclassed.\r\n |\r\n |      The default implementation does nothing. It may be\r\n |      overridden to extend subclasses.\r\n |\r\n |  custom() from builtins.type\r\n |\r\n |  ----------------------------------------------------------------------\r\n |  Data descriptors defined here:\r\n |\r\n |  __dict__\r\n |      dictionary for instance variables (if defined)\r\n |\r\n |  __weakref__\r\n |      list of weak references to the object (if defined)\r\n```\r\n\r\nTake a look at these two entries:\r\n1. `__init_subclass__(*args, **kwargs) from builtins.type`\r\n2. `custom() from builtins.type`\r\n\r\nWhile `type` has `__init_subclass__`, there's no `type.custom`. But, `help` says that there is!\r\n\r\n```python\r\n\u003e\u003e\u003e type.__init_subclass__\r\n\u003cbuilt-in method __init_subclass__ of type object at 0x10a50c360\u003e\r\n\u003e\u003e\u003e type.custom\r\nTraceback (most recent call last):\r\n  File \"\u003cstdin\u003e\", line 1, in \u003cmodule\u003e\r\nAttributeError: type object 'type' has no attribute 'custom'\r\n```\r\n\r\nI think that it is incorrect and can lead to confusion.\r\nInstead it should be:\r\n\r\n```\r\n |  __init_subclass__(*args, **kwargs) from builtins.type\r\n |      This method is called when a class is subclassed.\r\n |\r\n |      The default implementation does nothing. It may be\r\n |      overridden to extend subclasses.\r\n |\r\n |  custom()\r\n```\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-98120\n* gh-113941\n* gh-115296\n* gh-115302\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/sobolevn","@type":"Person","name":"sobolevn"},"datePublished":"2022-10-06T12:08:05.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":9},"url":"https://github.com/97959/cpython/issues/97959"}