René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"`turtle.teleport` has incorrect-ish signature","articleBody":"\r\n# Bug report\r\n\r\n`turtle.teleport` added in https://github.com/python/cpython/pull/103974 seems not quite correct.\r\n\r\nWhy?\r\n1. It is produced automagically from `Turtle.teleport` instance method. It has this signature: `def teleport(self, x=None, y=None, *, fill_gap: bool = False) -\u003e None:`\r\n2. The result function `turtle.teleport` has this signature: `def teleport(x, y=None, fill_gap=None)`\r\n\r\nNotice that it is missing `x=None` default and for some reason `fill_gap` is not a kw-only anymore.\r\n\r\nThe second problem happens because inside it uses `inspect.getargs`: https://github.com/python/cpython/blob/52fbcf61b5a70993c2d32332ff0ad9f369d968d3/Lib/turtle.py#L3927 which translates kw-only to positional-or-keyword params.\r\n\r\nSo, when I try to run `turtle.teleport` I get:\r\n\r\n```python\r\nTraceback (most recent call last):\r\n  File \"/Users/sobolev/Desktop/cpython/ex.py\", line 60, in \u003cmodule\u003e\r\n    print(teleport())\r\n          ^^^^^^^^^^\r\nTypeError: teleport() missing 1 required positional argument: 'x'\r\n                     \r\n```\r\n\r\nAnd with just one arg:\r\n\r\n```python\r\nTraceback (most recent call last):\r\n  File \"/Users/sobolev/Desktop/cpython/ex.py\", line 60, in \u003cmodule\u003e\r\n    print(teleport(1))\r\n          ^^^^^^^^^^^\r\n  File \"\u003cstring\u003e\", line 4, in teleport\r\nTypeError: Turtle.teleport() takes from 1 to 3 positional arguments but 4 were given\r\n                        \r\n```\r\n\r\nAnnotations are also missing. It is not a big problem, but it is inconvenient.\r\n\r\nI propose using `inspect.signature` instead. It will allow us using pos-only and keyword-only params with ease.\r\n\r\nI have a PR ready.\r\n\r\nFound while working on https://github.com/python/typeshed/pull/10548\r\nCC @AlexWaygood and @terryjreedy \n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-107807\n* gh-108749\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/sobolevn","@type":"Person","name":"sobolevn"},"datePublished":"2023-08-09T10:34:28.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/107805/cpython/issues/107805"}