René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Undocumented 3.13 C API","articleBody":"The following public C API is new in 3.13 (beta 1, relative to 3.12), and as of this writing it looks either\n- undocumented, or\n- documented incorrectly. See the docs search page for what Sphinx thinks the type and fully-quilfied name of the symbol are; it should be a *C* entry without extraneous namespaces. (The details tend to matter for search, URLs, and Intersphinx links.)\n\n*See also: [3.14](https://github.com/python/cpython/issues/135755)*\n\n- [x] `PY_MACCONFIG_H` in `Include/pymacconfig.h` (header guards don't need docs)\n- [x] `PY_MONITORING_EVENT_BRANCH` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_CALL` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_C_RAISE` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_C_RETURN` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_EXCEPTION_HANDLED` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_INSTRUCTION` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_JUMP` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_LINE` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_PY_RESUME` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_PY_RETURN` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_PY_START` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_PY_THROW` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_PY_UNWIND` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_PY_YIELD` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_RAISE` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_RERAISE` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_EVENT_STOP_ITERATION` in `Include/cpython/monitoring.h`\n- [x] `PY_MONITORING_IS_INSTRUMENTED_EVENT` in `Include/cpython/monitoring.h`\n- [x] `PyCF_OPTIMIZED_AST` in `Include/cpython/compile.h`\n- [x] `PyEval_GetFrameBuiltins` in `Include/ceval.h:25`\n- [x] `PyEval_GetFrameGlobals` in `Include/ceval.h:26`\n- [x] `PyEval_GetFrameLocals` in `Include/ceval.h:27`\n- [x] `PyExc_IncompleteInputError` in `Include/pyerrors.h:111`\n- [x] `PyExc_PythonFinalizationError` in `Include/cpython/pyerrors.h:129`\n- [x] `PyFrameLocalsProxy_Check` in `Include/cpython/pyframe.h`\n- [x] `PyFrameLocalsProxy_Type` in `Include/cpython/pyframe.h:6`\n- [x] `PyMonitoring_EnterScope` in `Include/cpython/monitoring.h:44`\n- [x] `PyMonitoring_ExitScope` in `Include/cpython/monitoring.h:48`\n- [ ] `PyRefTracerEvent` in `Include/cpython/object.h:516`, `Include/cpython/object.h:519`\n- [x] `PyUnstable_AtExit` in `Include/cpython/pylifecycle.h:91`\n- [ ] `PyUnstable_CopyPerfMapFile` in `Include/cpython/sysmodule.h:20`\n- [ ] `PyUnstable_EXECUTABLE_KINDS` in `Include/cpython/pyframe.h`\n- [ ] `PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION` in `Include/cpython/pyframe.h`\n- [ ] `PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR` in `Include/cpython/pyframe.h`\n- [ ] `PyUnstable_EXECUTABLE_KIND_PY_FUNCTION` in `Include/cpython/pyframe.h`\n- [ ] `PyUnstable_EXECUTABLE_KIND_SKIP` in `Include/cpython/pyframe.h`\n- [ ] `PyUnstable_ExecutableKinds` in `Include/cpython/pyframe.h:45`\n- [x] `PyUnstable_GetExecutor` in `Include/cpython/optimizer.h:137` (now removed)\n- [x] `PyUnstable_GetOptimizer` in `Include/cpython/optimizer.h:135` (now removed)\n- [x] `PyUnstable_InterpreterState_GetMainModule` in `Include/cpython/pystate.h:11`\n- [x] `PyUnstable_Optimizer_NewCounter` in `Include/cpython/optimizer.h:145` (now removed)\n- [x] `PyUnstable_Optimizer_NewUOpOptimizer` in `Include/cpython/optimizer.h:146` (now removed)\n- [ ] `PyUnstable_PerfTrampoline_CompileCode` in `Include/cpython/sysmodule.h:21`\n- [ ] `PyUnstable_PerfTrampoline_SetPersistAfterFork` in `Include/cpython/sysmodule.h:22`\n- [x] `PyUnstable_Replace_Executor` in `Include/cpython/optimizer.h:129` (now removed)\n- [x] `PyUnstable_SetOptimizer` in `Include/cpython/optimizer.h:133` (now removed)\n- [x] `Py_ASNATIVEBYTES_BIG_ENDIAN` in `Include/cpython/longobject.h`\n- [x] `Py_ASNATIVEBYTES_DEFAULTS` in `Include/cpython/longobject.h`\n- [x] `Py_ASNATIVEBYTES_LITTLE_ENDIAN` in `Include/cpython/longobject.h`\n- [x] `Py_ASNATIVEBYTES_NATIVE_ENDIAN` in `Include/cpython/longobject.h`\n- [x] `Py_ASNATIVEBYTES_REJECT_NEGATIVE` in `Include/cpython/longobject.h`\n- [x] `Py_ASNATIVEBYTES_UNSIGNED_BUFFER` in `Include/cpython/longobject.h`\n- [x] `Py_ATOMIC_H` in `Include/pyatomic.h` (header guards don't need docs)\n- [ ] `Py_CAN_START_THREADS` in `Include/pyport.h:463`\n- [x] ~~`Py_C_RECURSION_LIMIT` in `Include/cpython/pystate.h:215`~~ (removed in 3.14)\n- [x] `Py_MOD_GIL_NOT_USED` in `Include/moduleobject.h:69`\n- [x] `Py_MOD_GIL_USED` in `Include/moduleobject.h:69`\n- [x] `Py_MONITORING_H` in `Include/monitoring.h` (header guards don't need docs)\n- [x] `Py_OPTIMIZER_H` in `Include/cpython/optimizer.h` (header guards don't need docs)\n- [ ] `Py_TPFLAGS_INLINE_VALUES` in `Include/object.h:632`\n- [x] ~~`Py_TRASHCAN_HEADROOM` in `Include/cpython/object.h:463`~~ (removed in gh-132280)\n- [ ] `CO_NO_MONITORING_EVENTS` in `Include/cpython/code.h:192`\n\nSome more are generated by configure, I guess that's low priority:\n\n- [ ] `HAVE_CLOCK_T` in `./pyconfig.h:138`\n- [ ] `HAVE_CLOSEFROM` in `./pyconfig.h:138`\n- [ ] `HAVE_GETGRENT` in `./pyconfig.h:138`\n- [ ] `HAVE_GRANTPT` in `./pyconfig.h:515`\n- [ ] `HAVE_POSIX_OPENPT` in `./pyconfig.h:849`\n- [ ] `HAVE_POSIX_SPAWN_FILE_ACTIONS_ADDCLOSEFROM_NP` in `./pyconfig.h:849`\n- [ ] `HAVE_PROCESS_VM_READV` in `./pyconfig.h:849`\n- [ ] `HAVE_PTSNAME` in `./pyconfig.h:957`\n- [ ] `HAVE_PTSNAME_R` in `./pyconfig.h:957`\n- [ ] `HAVE_SOCKLEN_T` in `./pyconfig.h:957`\n- [ ] `HAVE_SYS_TIMERFD_H` in `./pyconfig.h:1406`\n- [ ] `HAVE_TIMERFD_CREATE` in `./pyconfig.h:1406`\n- [ ] `HAVE_UNLOCKPT` in `./pyconfig.h:1406`\n- [ ] `HAVE___UINT128_T` in `./pyconfig.h:1582`\n- [ ] `WITH_MIMALLOC` in `./pyconfig.h:1867`\n\n\n\n\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-124134\n* gh-124244\n* gh-127720\n* gh-127831\n* gh-128026\n* gh-128483\n* gh-128677\n* gh-129028\n* gh-129086\n* gh-129691\n* gh-129723\n* gh-131424\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/encukou","@type":"Person","name":"encukou"},"datePublished":"2024-05-10T15:59:45.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/118915/cpython/issues/118915"}