Skip to content
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.

Sign up for GitHub

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

Jump to bottom

Argument Clinic: add support for deprecating keyword use of parameters #107704

Closed
erlend-aasland opened this issue Aug 7, 2023 · 3 comments
Closed

Argument Clinic: add support for deprecating keyword use of parameters #107704

erlend-aasland opened this issue Aug 7, 2023 · 3 comments
Labels
topic-argument-clinic type-feature A feature request or enhancement

Comments

@erlend-aasland
Copy link
Contributor

erlend-aasland commented Aug 7, 2023 •
edited by bedevere-bot
Loading

See #95065 (comment) by Serhiy. Quoting:

Turn positional-or-keyword parameters into positional-only parameters. A directive which means "the preceding positional-or-keyword parameters will be positional-only parameters in future".

In #95151, Argument Clinic learned how to deprecate positional use of parameters. In this issue, we propose to teach Argument Clinic how to deprecate keyword use of parameters.

Suggesting to use a similar syntax as the one introduced in #95151

func
   a: object
   / [from X.Y]

Meaning a will be positional-only from Python version X.Y. We can reuse parts of the code introduced in #95151 to implement this feature.

Linked PRs
@erlend-aasland erlend-aasland added type-feature A feature request or enhancement topic-argument-clinic labels Aug 7, 2023
@erlend-aasland
Copy link
Contributor Author

cc. @serhiy-storchaka

@serhiy-storchaka
Copy link
Member

I am working on this.

serhiy-storchaka added a commit to serhiy-storchaka/cpython that referenced this issue Aug 14, 2023
@serhiy-storchaka
WIP: pythongh-107704: Argument Clinic: add support for deprecating ke…
57d7173 
…yword use of parameters
serhiy-storchaka added a commit to serhiy-storchaka/cpython that referenced this issue Aug 15, 2023
@serhiy-storchaka
pythongh-107704: Argument Clinic: add support for deprecating keyword…
2b3c1e2 
… use of parameters

It is now possible to deprecate passing keyword arguments for
keyword-or-positional parameters with Argument Clinic, using the new
'/ [from X.Y]' syntax.
(To be read as "positional-only from Python version X.Y")
serhiy-storchaka added a commit to serhiy-storchaka/cpython that referenced this issue Aug 15, 2023
@serhiy-storchaka
pythongh-107704: Argument Clinic: add support for deprecating keyword…
059cd6a 
… use of parameters

It is now possible to deprecate passing keyword arguments for
keyword-or-positional parameters with Argument Clinic, using the new
'/ [from X.Y]' syntax.
(To be read as "positional-only from Python version X.Y")
@bedevere-bot bedevere-bot mentioned this issue Aug 15, 2023
Merged
serhiy-storchaka added a commit that referenced this issue Aug 19, 2023
@serhiy-storchaka @erlend-aasland @AlexWaygood
gh-107704: Argument Clinic: add support for deprecating keyword use o…
2f31143 
…f parameters (GH-107984)

It is now possible to deprecate passing keyword arguments for
keyword-or-positional parameters with Argument Clinic, using the new
'/ [from X.Y]' syntax.
(To be read as "positional-only from Python version X.Y")

Co-authored-by: Erlend E. Aasland <[email protected]>
Co-authored-by: Alex Waygood <[email protected]>
serhiy-storchaka added a commit to serhiy-storchaka/cpython that referenced this issue Aug 19, 2023
@serhiy-storchaka
pythongh-95065, pythongh-107704: Argument Clinic: support multiple '/…
a52192a 
… [from ...]' and '* [from ...]' markers
@serhiy-storchaka serhiy-storchaka mentioned this issue Aug 19, 2023
Merged
serhiy-storchaka added a commit that referenced this issue Aug 21, 2023
@serhiy-storchaka
gh-95065, gh-107704: Argument Clinic: support multiple '/ [from ...]'…
60942cc 
… and '* [from ...]' markers (GH-108132)
@erlend-aasland
Copy link
Contributor Author

Thanks for doing this, Serhiy.

AA-Turner pushed a commit to AA-Turner/devguide that referenced this issue Sep 26, 2023
@serhiy-storchaka @erlend-aasland @AlexWaygood
python/cpython#107704: Argument Clinic: add support for deprecating k…
3ab432c 
…eyword use of parameters (python/cpython#107984)

It is now possible to deprecate passing keyword arguments for
keyword-or-positional parameters with Argument Clinic, using the new
'/ [from X.Y]' syntax.
(To be read as "positional-only from Python version X.Y")

Co-authored-by: Erlend E. Aasland <[email protected]>
Co-authored-by: Alex Waygood <[email protected]>
erlend-aasland added a commit to python/devguide that referenced this issue Oct 1, 2023
@serhiy-storchaka @erlend-aasland @AlexWaygood
python/cpython#107704: Argument Clinic: add support for deprecating k…
30dfd7c 
…eyword use of parameters (python/cpython#107984)

It is now possible to deprecate passing keyword arguments for
keyword-or-positional parameters with Argument Clinic, using the new
'/ [from X.Y]' syntax.
(To be read as "positional-only from Python version X.Y")

Co-authored-by: Erlend E. Aasland <[email protected]>
Co-authored-by: Alex Waygood <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
topic-argument-clinic type-feature A feature request or enhancement
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@serhiy-storchaka @erlend-aasland