René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Argument Clinic: add support for deprecating positional use of parameters","articleBody":"**Feature or enhancement**\r\n\r\nSuggesting to add syntax for producing deprecation warnings for positional use of optional parameters.\r\n\r\nI made a [proof-of-concept patch](https://github.com/erlend-aasland/cpython/pull/37) for this where I introduced a new special symbol `x`. Example use:\r\n\r\n```c\r\n/*[clinic input]\r\nmod.func\r\n    stuff: object\r\n    /\r\n    x\r\n    optarg: int = 128\r\n```\r\n\r\nThis will then generate code that emits a DeprecationWarning if `optarg` is passed as a positional argument, but not if it is passed as a keyword.\r\n\r\nWe can use this feature to introduce deprecation warnings for parameters that will become keyword-only in future releases. When the deprecation period is done, we can simply replace the `x` with `*`, to really make the optional params keyword-only.\r\n\r\n**Pitch**\r\n\r\nQuoting @serhiy-storchaka, in issue #93057:\r\n\r\n\u003e It is recommended to make optional rarely used arguments keyword-only. I do not think it will break much code, but we need a deprecation period for this.\r\n\u003e\r\n\u003e The problem is that sqlite3.connect() was converted to Argument Clinic, and it was much easier to add deprecation warning in the old code.\r\n\r\n**Previous discussion**\r\n\r\n- #93057\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-95151\n* gh-107712\n* gh-107742\n* gh-107745\n* gh-107766\n* gh-107768\n* gh-107808\n* gh-108132\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/erlend-aasland","@type":"Person","name":"erlend-aasland"},"datePublished":"2022-07-20T19:53:46.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":24},"url":"https://github.com/95065/cpython/issues/95065"}