mirror of
https://github.com/python/cpython.git
synced 2025-08-04 08:59:19 +00:00
13a00078b8
Python built with "configure --with-trace-refs" (tracing references) is now ABI compatible with Python release build and debug build. Moreover, it now also supports the Limited API. Change Py_TRACE_REFS build: * Remove _PyObject_EXTRA_INIT macro. * The PyObject structure no longer has two extra members (_ob_prev and _ob_next). * Use a hash table (_Py_hashtable_t) to trace references (all objects): PyInterpreterState.object_state.refchain. * Py_TRACE_REFS build is now ABI compatible with release build and debug build. * Limited C API extensions can now be built with Py_TRACE_REFS: xxlimited, xxlimited_35, _testclinic_limited. * No longer rename PyModule_Create2() and PyModule_FromDefAndSpec2() functions to PyModule_Create2TraceRefs() and PyModule_FromDefAndSpec2TraceRefs(). * _Py_PrintReferenceAddresses() is now called before finalize_interp_delete() which deletes the refchain hash table. * test_tracemalloc find_trace() now also filters by size to ignore the memory allocated by _PyRefchain_Trace(). Test changes for Py_TRACE_REFS: * Add test.support.Py_TRACE_REFS constant. * Add test_sys.test_getobjects() to test sys.getobjects() function. * test_exceptions skips test_recursion_normalizing_with_no_memory() and test_memory_error_in_PyErr_PrintEx() if Python is built with Py_TRACE_REFS. * test_repl skips test_no_memory(). * test_capi skisp test_set_nomemory().
149 lines
5.5 KiB
C
149 lines
5.5 KiB
C
|
|
#ifndef Py_MODSUPPORT_H
|
|
#define Py_MODSUPPORT_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Module support interface */
|
|
|
|
#include <stdarg.h> // va_list
|
|
|
|
PyAPI_FUNC(int) PyArg_Parse(PyObject *, const char *, ...);
|
|
PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, const char *, ...);
|
|
PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
|
|
const char *, char **, ...);
|
|
PyAPI_FUNC(int) PyArg_VaParse(PyObject *, const char *, va_list);
|
|
PyAPI_FUNC(int) PyArg_VaParseTupleAndKeywords(PyObject *, PyObject *,
|
|
const char *, char **, va_list);
|
|
|
|
PyAPI_FUNC(int) PyArg_ValidateKeywordArguments(PyObject *);
|
|
PyAPI_FUNC(int) PyArg_UnpackTuple(PyObject *, const char *, Py_ssize_t, Py_ssize_t, ...);
|
|
PyAPI_FUNC(PyObject *) Py_BuildValue(const char *, ...);
|
|
PyAPI_FUNC(PyObject *) Py_VaBuildValue(const char *, va_list);
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x030a0000
|
|
// Add an attribute with name 'name' and value 'obj' to the module 'mod.
|
|
// On success, return 0.
|
|
// On error, raise an exception and return -1.
|
|
PyAPI_FUNC(int) PyModule_AddObjectRef(PyObject *mod, const char *name, PyObject *value);
|
|
#endif /* Py_LIMITED_API */
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x030d0000
|
|
// Similar to PyModule_AddObjectRef() but steal a reference to 'value'.
|
|
PyAPI_FUNC(int) PyModule_Add(PyObject *mod, const char *name, PyObject *value);
|
|
#endif /* Py_LIMITED_API */
|
|
|
|
// Similar to PyModule_AddObjectRef() and PyModule_Add() but steal
|
|
// a reference to 'value' on success and only on success.
|
|
// Errorprone. Should not be used in new code.
|
|
PyAPI_FUNC(int) PyModule_AddObject(PyObject *mod, const char *, PyObject *value);
|
|
|
|
PyAPI_FUNC(int) PyModule_AddIntConstant(PyObject *, const char *, long);
|
|
PyAPI_FUNC(int) PyModule_AddStringConstant(PyObject *, const char *, const char *);
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03090000
|
|
/* New in 3.9 */
|
|
PyAPI_FUNC(int) PyModule_AddType(PyObject *module, PyTypeObject *type);
|
|
#endif /* Py_LIMITED_API */
|
|
|
|
#define PyModule_AddIntMacro(m, c) PyModule_AddIntConstant((m), #c, (c))
|
|
#define PyModule_AddStringMacro(m, c) PyModule_AddStringConstant((m), #c, (c))
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03050000
|
|
/* New in 3.5 */
|
|
PyAPI_FUNC(int) PyModule_SetDocString(PyObject *, const char *);
|
|
PyAPI_FUNC(int) PyModule_AddFunctions(PyObject *, PyMethodDef *);
|
|
PyAPI_FUNC(int) PyModule_ExecDef(PyObject *module, PyModuleDef *def);
|
|
#endif
|
|
|
|
#define Py_CLEANUP_SUPPORTED 0x20000
|
|
|
|
#define PYTHON_API_VERSION 1013
|
|
#define PYTHON_API_STRING "1013"
|
|
/* The API version is maintained (independently from the Python version)
|
|
so we can detect mismatches between the interpreter and dynamically
|
|
loaded modules. These are diagnosed by an error message but
|
|
the module is still loaded (because the mismatch can only be tested
|
|
after loading the module). The error message is intended to
|
|
explain the core dump a few seconds later.
|
|
|
|
The symbol PYTHON_API_STRING defines the same value as a string
|
|
literal. *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***
|
|
|
|
Please add a line or two to the top of this log for each API
|
|
version change:
|
|
|
|
22-Feb-2006 MvL 1013 PEP 353 - long indices for sequence lengths
|
|
|
|
19-Aug-2002 GvR 1012 Changes to string object struct for
|
|
interning changes, saving 3 bytes.
|
|
|
|
17-Jul-2001 GvR 1011 Descr-branch, just to be on the safe side
|
|
|
|
25-Jan-2001 FLD 1010 Parameters added to PyCode_New() and
|
|
PyFrame_New(); Python 2.1a2
|
|
|
|
14-Mar-2000 GvR 1009 Unicode API added
|
|
|
|
3-Jan-1999 GvR 1007 Decided to change back! (Don't reuse 1008!)
|
|
|
|
3-Dec-1998 GvR 1008 Python 1.5.2b1
|
|
|
|
18-Jan-1997 GvR 1007 string interning and other speedups
|
|
|
|
11-Oct-1996 GvR renamed Py_Ellipses to Py_Ellipsis :-(
|
|
|
|
30-Jul-1996 GvR Slice and ellipses syntax added
|
|
|
|
23-Jul-1996 GvR For 1.4 -- better safe than sorry this time :-)
|
|
|
|
7-Nov-1995 GvR Keyword arguments (should've been done at 1.3 :-( )
|
|
|
|
10-Jan-1995 GvR Renamed globals to new naming scheme
|
|
|
|
9-Jan-1995 GvR Initial version (incompatible with older API)
|
|
*/
|
|
|
|
/* The PYTHON_ABI_VERSION is introduced in PEP 384. For the lifetime of
|
|
Python 3, it will stay at the value of 3; changes to the limited API
|
|
must be performed in a strictly backwards-compatible manner. */
|
|
#define PYTHON_ABI_VERSION 3
|
|
#define PYTHON_ABI_STRING "3"
|
|
|
|
PyAPI_FUNC(PyObject *) PyModule_Create2(PyModuleDef*, int apiver);
|
|
|
|
#ifdef Py_LIMITED_API
|
|
#define PyModule_Create(module) \
|
|
PyModule_Create2((module), PYTHON_ABI_VERSION)
|
|
#else
|
|
#define PyModule_Create(module) \
|
|
PyModule_Create2((module), PYTHON_API_VERSION)
|
|
#endif
|
|
|
|
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03050000
|
|
/* New in 3.5 */
|
|
PyAPI_FUNC(PyObject *) PyModule_FromDefAndSpec2(PyModuleDef *def,
|
|
PyObject *spec,
|
|
int module_api_version);
|
|
|
|
#ifdef Py_LIMITED_API
|
|
#define PyModule_FromDefAndSpec(module, spec) \
|
|
PyModule_FromDefAndSpec2((module), (spec), PYTHON_ABI_VERSION)
|
|
#else
|
|
#define PyModule_FromDefAndSpec(module, spec) \
|
|
PyModule_FromDefAndSpec2((module), (spec), PYTHON_API_VERSION)
|
|
#endif /* Py_LIMITED_API */
|
|
|
|
#endif /* New in 3.5 */
|
|
|
|
#ifndef Py_LIMITED_API
|
|
# define Py_CPYTHON_MODSUPPORT_H
|
|
# include "cpython/modsupport.h"
|
|
# undef Py_CPYTHON_MODSUPPORT_H
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_MODSUPPORT_H */
|