René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"C API: Remove private C API functions (move them to the internal C API)","articleBody":"Over the years, we accumulated many private functions as part of the public C API header files. I propose to remove them: move them to the internal C API.\r\n\r\nIf many C extensions are affected by these removals, it's a sign that we should consider promoted used private functions as public functions: provide a better API, add error handling, write documentation, write tests.\r\n\r\n---\r\n\r\nSummary: **[My plan to clarify private vs public functions in Python 3.13](https://discuss.python.org/t/c-api-my-plan-to-clarify-private-vs-public-functions-in-python-3-13/30131)**\r\n\r\n* Private functions converted to public functions:\r\n\r\n  * PyLong_AsInt(): issue #108444\r\n  * Py_IsFinalizing(): PR #108032\r\n\r\n* Discussions:\r\n\r\n  * [(pssst) Let’s treat all API in public headers as public](https://discuss.python.org/t/pssst-lets-treat-all-api-in-public-headers-as-public/28916)\r\n  * [list of PyPI affected projects](https://github.com/python/cpython/issues/106320#issuecomment-1620773057)\r\n  * [C API: How much private is the private _Py_IDENTIFIER() API?](https://discuss.python.org/t/c-api-how-much-private-is-the-private-py-identifier-api/29190) -- ``_Py_Identifier``\r\n  * [_Py_c_xxx complex functions](https://github.com/python/cpython/issues/106320#issuecomment-1633302147) (ex: ``_Py_c_abs()``)\r\n  * PR #107139: Add _PyTupleBuilder API to the internal C API\r\n\r\n* Notes:\r\n\r\n  * While being private, [_PyBytes_Resize()](https://docs.python.org/dev/c-api/bytes.html#c._PyBytes_Resize) and [_PyTuple_Resize()](https://docs.python.org/dev/c-api/tuple.html#c._PyTuple_Resize) are documented\r\n  * The private _PyCrossInterpreterData API is used by 3rd party project on PyPI: https://github.com/python/cpython/pull/107068#issuecomment-1648594654. I closed my PR #107068.\r\n\r\n---\r\n\r\n\u003c!-- gh-linked-prs --\u003e\r\n### Linked PRs\r\n* gh-106321\r\n* gh-106324\r\n* gh-106325\r\n* gh-106335\r\n* gh-106336\r\n* gh-106339\r\n* gh-106341\r\n* gh-106342\r\n* gh-106355\r\n* gh-106356\r\n* gh-106382\r\n* gh-106383\r\n* gh-106385\r\n* gh-106386\r\n* gh-106398\r\n* gh-106399\r\n* gh-106400\r\n* gh-106417\r\n* gh-106425\r\n* gh-106434\r\n* gh-107021\r\n* gh-107026\r\n* gh-107027\r\n* gh-107030\r\n* gh-107032\r\n* gh-107034\r\n* gh-107036\r\n* gh-107041\r\n* gh-107053\r\n* gh-107064\r\n* gh-107068\r\n* gh-107070\r\n* gh-107071\r\n* gh-107142\r\n* gh-107143\r\n* gh-107144\r\n* gh-107145\r\n* gh-107147\r\n* gh-107159\r\n* gh-107185\r\n* gh-107187\r\n* gh-108313\r\n* gh-108429\r\n* gh-108430\r\n* gh-108431\r\n* gh-108433\r\n* gh-108434\r\n* gh-108449\r\n* gh-108451\r\n* gh-108452\r\n* gh-108453\r\n* gh-108499\r\n* gh-108503\r\n* gh-108505\r\n* gh-108593\r\n* gh-108597\r\n* gh-108599\r\n* gh-108600\r\n* gh-108601\r\n* gh-108602\r\n* gh-108603\r\n* gh-108604\r\n* gh-108605\r\n* gh-108606\r\n* gh-108607\r\n* gh-108609\r\n* gh-108664\r\n* gh-108712\r\n* gh-108713\r\n* gh-108720\r\n* gh-108742\r\n* gh-108743\r\n* gh-108863\r\n* gh-111162\r\n* gh-111939\r\n* gh-128787\n* gh-128788\n* gh-128837\n\u003c!-- /gh-linked-prs --\u003e\r\n","author":{"url":"https://github.com/vstinner","@type":"Person","name":"vstinner"},"datePublished":"2023-07-01T21:35:51.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":55},"url":"https://github.com/106320/cpython/issues/106320"}