Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork32.1k
gh-121277: Raise nice error onnext
as second argument to deprecated-removed#124623
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.
By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Uh oh!
There was an error while loading.Please reload this page.
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
I left a suggestion in case you want to be more explicit, but otherwise your version works too.
if version_removed == 'next': | ||
raise ValueError( | ||
'deprecated-removed:: second argument cannot be `next`') |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
ifversion_removed=='next': | |
raiseValueError( | |
'deprecated-removed:: second argument cannot be `next`') | |
ifversion_removed=='next': | |
raiseValueError( | |
'deprecated-removed:: second argument should be the version in which ' | |
'the API will be removed, and cannot be `next`') |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
Thanks for the suggestion! But I do think it's too long, and I hope anyone who addsdeprecated-removed::
already knows what the args are. If they need this error to find that out, something's very wrong :)
e349f73
intopython:mainUh oh!
There was an error while loading.Please reload this page.
…recated-removed (pythonGH-124623)(cherry-picked frome349f73)
…124718)*gh-121277: Allow `.. versionadded:: next` in docs (GH-121278)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>(cherry picked from commit7d24ea9)*gh-121277: Raise nice error on `next` as second argument to deprecated-removed (GH-124623)(cherry-picked frome349f73)
…nGH-121278) (pythonGH-124718)*pythongh-121277: Allow `.. versionadded:: next` in docs (pythonGH-121278)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>(cherry picked from commit7d24ea9)*pythongh-121277: Raise nice error on `next` as second argument to deprecated-removed (pythonGH-124623)(cherry-picked frome349f73)(cherry picked from commitdba992b)Co-authored-by: Petr Viktorin <encukou@gmail.com>
…H-125980)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)(cherry picked from commit7d24ea9)Also backports a minor fix-up:gh-121277: Raise nice error on `next` as second argument to deprecated-removed (GH-124623)(cherry-picked from commite349f73)Co-authored-by: Petr Viktorin <encukou@gmail.com>
…nGH-121278) (python#124718)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>(cherry picked from commit7d24ea9)pythongh-121277: Raise nice error on `next` as second argument to deprecated-removed (pythonGH-124623)(cherry-picked frome349f73)
…124718) (#127827)* [3.11]gh-121277: Allow `.. versionadded:: next` in docs (GH-121278) (#124718)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>(cherry picked from commit7d24ea9)gh-121277: Raise nice error on `next` as second argument to deprecated-removed (GH-124623)(cherry-picked frome349f73)* Import VersionChangesphinx.domains.changeset.VersionChange exists at least since Sphinx 2.1,according to:https://www.sphinx-doc.org/en/master/extdev/deprecated.html* Get config from env* Use version, not arguments directly
…H-121278)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>(cherry picked from commit7d24ea9)pythongh-121277: Raise nice error on `next` as second argument to deprecated-removed (pythonGH-124623)(cherry-picked frome349f73)Updates for 3.10(cherry-picked from 3.11:f0895aa)* Use version, not arguments directly
…H-121278)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>(cherry picked from commit7d24ea9)pythongh-121277: Raise nice error on `next` as second argument to deprecated-removed (pythonGH-124623)(cherry-picked frome349f73)Updates for 3.10(cherry-picked from 3.11:f0895aa)* Use version, not arguments directly
…127867)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>(cherry picked from commit7d24ea9)gh-121277: Raise nice error on `next` as second argument to deprecated-removed (GH-124623)(cherry-picked frome349f73)Updates for 3.10(cherry-picked from 3.11:f0895aa)* Use version, not arguments directly
…-121278) (pythonGH-127867)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>(cherry picked from commit7d24ea9)pythongh-121277: Raise nice error on `next` as second argument to deprecated-removed (pythonGH-124623)(cherry-picked frome349f73)Updates for 3.9(cherry-picked from 3.11:f0895aa)(cherry-picked from 3.10:8773554)* Use version, not arguments directly
…28117)Make `versionchanged:: next`` expand to current (unreleased) version.When a new CPython release is cut, the release manager will replaceall such occurences of "next" with the just-released version.(See the issue for release-tools and devguide PRs.)Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>(cherry picked from commit7d24ea9)gh-121277: Raise nice error on `next` as second argument to deprecated-removed (GH-124623)(cherry-picked frome349f73)(cherry-picked from 3.11:f0895aa)(cherry-picked from 3.10:8773554)
Uh oh!
There was an error while loading.Please reload this page.
Using
next
as the second argument doesn't make sense, but users should get a nicer message thanValueError: invalid literal for int()
-- especially since Sphinx hides the traceback by default... versionadded:: next
in docs #121277📚 Documentation preview 📚:https://cpython-previews--124623.org.readthedocs.build/