Rename to PyUnstable_AssignVersionTag, move to Include/cptyhon/object…

….h, fix some newlines

Doc/c-api/type.rst

@@ -232,7 +232,7 @@ Type Objects
 
    .. versionadded:: 3.11
 
-.. c:function:: int PyType_AssignVersionTag(PyTypeObject *type)
+.. c:function:: int PyUnstable_AssignVersionTag(PyTypeObject *type)
 
    Attempt to assign a version tag to the given type.
 

Include/cpython/object.h

@@ -553,3 +553,10 @@ PyAPI_FUNC(int) PyType_AddWatcher(PyType_WatchCallback callback);
 PyAPI_FUNC(int) PyType_ClearWatcher(int watcher_id);
 PyAPI_FUNC(int) PyType_Watch(int watcher_id, PyObject *type);
 PyAPI_FUNC(int) PyType_Unwatch(int watcher_id, PyObject *type);
+
+/* Attempt to assign a version tag to the given type.
+ *
+ * Returns 1 if the type already had a valid version tag or a new one was
+ * assigned, or 0 if a new tag could not be assigned.
+ */
+PyAPI_FUNC(int) PyUnstable_AssignVersionTag(PyTypeObject *type);

Include/object.h

@@ -861,15 +861,6 @@ static inline int PyType_CheckExact(PyObject *op) {
 #  define PyType_CheckExact(op) PyType_CheckExact(_PyObject_CAST(op))
 #endif
 
-#if !defined(Py_LIMITED_API)
-/* Attempt to assign a version tag to the given type.
- *
- * Returns 1 if the type already had a valid version tag or a new one was
- * assigned, or 0 if a new tag could not be assigned.
- */
-PyAPI_FUNC(int) PyType_AssignVersionTag(PyTypeObject *type);
-#endif
-
 #ifdef __cplusplus
 }
 #endif

Lib/test/test_type_cache.py

@@ -11,6 +11,7 @@
 type_get_version = import_helper.import_module('_testcapi').type_get_version
 type_assign_version = import_helper.import_module('_testcapi').type_assign_version
 
+
 @support.cpython_only
 @unittest.skipIf(_clear_type_cache is None, "requires sys._clear_type_cache")
 class TypeCacheTests(unittest.TestCase):

Misc/NEWS.d/next/C API/2023-03-28-12-31-51.gh-issue-103091.CzZyaZ.rst

@@ -1 +1 @@
-Add a new C-API function to eagerly assign a version tag to a PyTypeObject: ``PyType_AssignVersionTag()``.
+Add a new C-API function to eagerly assign a version tag to a PyTypeObject: ``PyUnstable_AssignVersionTag()``.

Modules/_testcapimodule.c

@@ -2740,7 +2740,7 @@ type_assign_version(PyObject *self, PyObject *type)
         PyErr_SetString(PyExc_TypeError, "argument must be a type");
         return NULL;
     }
-    int res = PyType_AssignVersionTag((PyTypeObject *)type);
+    int res = PyUnstable_AssignVersionTag((PyTypeObject *)type);
     return PyLong_FromLong(res);
 }
 
@@ -3511,7 +3511,7 @@ static PyMethodDef TestMethods[] = {
     {"test_py_is_macros", test_py_is_macros, METH_NOARGS},
     {"test_py_is_funcs", test_py_is_funcs, METH_NOARGS},
     {"type_get_version", type_get_version, METH_O, PyDoc_STR("type->tp_version_tag")},
-    {"type_assign_version", type_assign_version, METH_O, PyDoc_STR("PyType_AssignVersionTag")},
+    {"type_assign_version", type_assign_version, METH_O, PyDoc_STR("PyUnstable_AssignVersionTag")},
     {"test_tstate_capi", test_tstate_capi, METH_NOARGS, NULL},
     {"frame_getlocals", frame_getlocals, METH_O, NULL},
     {"frame_getglobals", frame_getglobals, METH_O, NULL},

Objects/typeobject.c

@@ -598,11 +598,12 @@ assign_version_tag(PyTypeObject *type)
     return 1;
 }
 
-int PyType_AssignVersionTag(PyTypeObject *type)
+int PyUnstable_AssignVersionTag(PyTypeObject *type)
 {
     return assign_version_tag(type);
 }
 
+
 static PyMemberDef type_members[] = {
     {"__basicsize__", T_PYSSIZET, offsetof(PyTypeObject,tp_basicsize),READONLY},
     {"__itemsize__", T_PYSSIZET, offsetof(PyTypeObject, tp_itemsize), READONLY},