René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Deprecation of PyException_HEAD","articleBody":"## Summary\n\nThis issue proposes the depreciation of the `PyException_HEAD` macro.\n\nDuring review of PR #141522 (Document PyException_HEAD), the reviewers indicated that\nthis macro is internal, should not be documented, and should instead be deprecated.\n\n- `PyException_HEAD` is an internal macro used in CPython to define exception types.\n- It is not part of the public C API and was never intended to be used externally.\n- However, a small number of external projects have copied this pattern (for example,\n  confluent_kafka).\n- If  there are some internals change in the future (e.g. for PEP 697), this macro will\n  create a maintenance burden.\n\nThis deprecation would allow external projects time to migrate, rather than breaking\nthem immediately.\n\n## Proposed actions\n\n- Marking  the macro as deprecated in the header using `Py_DEPRECATED()` or a\n  compiler warning.\n- We can also add the documentation note stating that the macro is deprecated and may be\n  removed in a future release.\n-  We can add a NEWS entry.\n- Recommending that new code use exception creation patterns compatible with PEP 697.\n\nNo behavior change or removal is proposed at this time.\n\n## CC\n\n@ZeroIntensity\n@vstinner\n@StanFromIreland\n\n\n\n### Has this already been discussed elsewhere?\n\nThis has been discussed in one of the closed pr #141522\n\n### Links to previous discussion of this feature:\n\n\u003chttps://github.com/python/cpython/pull/141522\u003e","author":{"url":"https://github.com/Krishna-web-hub","@type":"Person","name":"Krishna-web-hub"},"datePublished":"2025-12-08T09:30:59.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":8},"url":"https://github.com/142410/cpython/issues/142410"}