gh-63891: Rename Py_SAFE_DOWNCAST to _Py_DOWNCAST

[shihai1991]

https://bugs.python.org/issue19692

• Issue: Rename Py_SAFE_DOWNCAST #63891

[shihai1991]

cc @pitrou

[CuriousLearner]

Not very sure if renaming this would be a good idea and what impact it can have. 🤷‍♂

But I'd like to see the discussion on bug tracker regarding this. Overall the changes look okay to me.

[shihai1991]

Not very sure if renaming this would be a good idea and what impact it can have.

But I'd like to see the discussion on bug tracker regarding this. Overall the changes look okay to me.

Thanks for review, Sanyam. Waiting enough discussion :)

[vstinner]

You cannot remove Py_SAFE_DOWNCAST() macro which is part of the Python stable C ABI.

[bedevere-bot]

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

[shihai1991]

Py_SAFE_DOWNCAST

Hi, victor.
Make sure I understand: adding #define _Py_DOWNCAST(VALUE, WIDE, NARROW) Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) for backwards compatibility and using _Py_DOWNCAST to repalce Py_SAFE_DOWNCAST inside.

ps: docs need updated too.

[vstinner]

You PR says:

Rename :meth:Py_SAFE_DOWNCAST to :meth:_Py_DOWNCAST

So it removes Py_SAFE_DOWNCAST() macro. Compilation of any C extension using Py_SAFE_DOWNCAST() will fail with this change.

Make sure I understand: adding #define _Py_DOWNCAST(VALUE, WIDE, NARROW) Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) for backwards compatibility and using _Py_DOWNCAST to repalce Py_SAFE_DOWNCAST inside.

That would be an option.

[shihai1991]

You PR says:

Rename :meth:Py_SAFE_DOWNCAST to :meth:_Py_DOWNCAST

So it removes Py_SAFE_DOWNCAST() macro. Compilation of any C extension using Py_SAFE_DOWNCAST() will fail with this change.

Make sure I understand: adding #define _Py_DOWNCAST(VALUE, WIDE, NARROW) Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) for backwards compatibility and using _Py_DOWNCAST to repalce Py_SAFE_DOWNCAST inside.

That would be an option.

Thanks, victor. I add an alias of Py_SAFE_DOWNCAST and update the news.

[shihai1991]

Ops, catching an typo erro incidentally: #16230

[shihai1991]

I have made the requested changes; please review again

[bedevere-bot]

Thanks for making the requested changes!

@vstinner: please review the changes made to this pull request.

[methane]

I'm +0. Removed me from reviewers.

[erlend-aasland]

Closing, as the linked issue is closed.