You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Update PEP 387 Backwards Compatibility Policy: Add Soft Deprecation #199
The PEP includes endorsements from the projects/groups/people it helps
The PEP has a CODEOWNERS entry
The rationale to add soft deprecations:
Prevent core developers to eaggerly remove soft deprecated code: soft deprecated APIs are not planned for removal
No warnings, whereas regular "hard" deprecations usually emit DeprecationWarning: soft deprecation is only in the documentation
We can more freely mark old APIs as soft deprecated to help users to choose between variants of similar APIs (which one is "the good one"?).
At the beginning, I proposed to issue a SoftDeprecationWarning warning at runtime. But warnings are calling for action, whereas a soft deprecation does not call for action: it's perfectly fine to continue using it. I updated my PR to no longer issue warnings.
Note: It was proposed to export the list of deprecated APIs as a JSON file, or a new stdlib_deprecations module: but that's not directly related to PEP 387 change. It will be discussed separately.
Activity
Yhg1s commentedon Jul 3, 2023
The SC agrees with the proposal and accepts the PEP update.
vstinner commentedon Jul 3, 2023
Thanks for investivating my case 😁