The embedded 40250 script layer needs its own interpreter on five platforms. 2.7 is end-of-life, so nothing can be fetched from the target SDKs and the source is vendored (official 2.7.18 tarball, trimmed to 25MB; Lib/ stays for step 3's python27.zip). cpython-2.7.18/CMakeLists.txt builds one `mtpython` static library from exactly the 133 objects the reference libpython2.7.a contains, off by default behind -DMTGODOT_EMBED_PYTHON=ON. The source list and the built-in module table (config/config.c, 39 entries) are shared; pyconfig.h is a probe result and is not, so each platform keeps its own under config/<platform>/, regenerated by tools/py_embed/gen_pyconfig.sh and checked against the shared table. Three vendor patches, documented in docs/THIRD-PARTY.md: configure/configure.ac learn arm64 on macOS, and posixmodule.c undefines the process-control calls it hard-defines past pyconfig.h when building for iOS. macOS (ctest python.embed: every builtin imports, codecs and pickle work off the vendored Lib/), Android arm64 and iOS arm64 build. Linux needs a Linux host and Windows needs a MinGW-vs-MSVC decision; both are noted for step 4. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
83 lines
2.7 KiB
C
83 lines
2.7 KiB
C
/* Weak references objects for Python. */
|
|
|
|
#ifndef Py_WEAKREFOBJECT_H
|
|
#define Py_WEAKREFOBJECT_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
typedef struct _PyWeakReference PyWeakReference;
|
|
|
|
/* PyWeakReference is the base struct for the Python ReferenceType, ProxyType,
|
|
* and CallableProxyType.
|
|
*/
|
|
struct _PyWeakReference {
|
|
PyObject_HEAD
|
|
|
|
/* The object to which this is a weak reference, or Py_None if none.
|
|
* Note that this is a stealth reference: wr_object's refcount is
|
|
* not incremented to reflect this pointer.
|
|
*/
|
|
PyObject *wr_object;
|
|
|
|
/* A callable to invoke when wr_object dies, or NULL if none. */
|
|
PyObject *wr_callback;
|
|
|
|
/* A cache for wr_object's hash code. As usual for hashes, this is -1
|
|
* if the hash code isn't known yet.
|
|
*/
|
|
long hash;
|
|
|
|
/* If wr_object is weakly referenced, wr_object has a doubly-linked NULL-
|
|
* terminated list of weak references to it. These are the list pointers.
|
|
* If wr_object goes away, wr_object is set to Py_None, and these pointers
|
|
* have no meaning then.
|
|
*/
|
|
PyWeakReference *wr_prev;
|
|
PyWeakReference *wr_next;
|
|
};
|
|
|
|
PyAPI_DATA(PyTypeObject) _PyWeakref_RefType;
|
|
PyAPI_DATA(PyTypeObject) _PyWeakref_ProxyType;
|
|
PyAPI_DATA(PyTypeObject) _PyWeakref_CallableProxyType;
|
|
|
|
#define PyWeakref_CheckRef(op) PyObject_TypeCheck(op, &_PyWeakref_RefType)
|
|
#define PyWeakref_CheckRefExact(op) \
|
|
(Py_TYPE(op) == &_PyWeakref_RefType)
|
|
#define PyWeakref_CheckProxy(op) \
|
|
((Py_TYPE(op) == &_PyWeakref_ProxyType) || \
|
|
(Py_TYPE(op) == &_PyWeakref_CallableProxyType))
|
|
|
|
#define PyWeakref_Check(op) \
|
|
(PyWeakref_CheckRef(op) || PyWeakref_CheckProxy(op))
|
|
|
|
|
|
PyAPI_FUNC(PyObject *) PyWeakref_NewRef(PyObject *ob,
|
|
PyObject *callback);
|
|
PyAPI_FUNC(PyObject *) PyWeakref_NewProxy(PyObject *ob,
|
|
PyObject *callback);
|
|
PyAPI_FUNC(PyObject *) PyWeakref_GetObject(PyObject *ref);
|
|
|
|
PyAPI_FUNC(Py_ssize_t) _PyWeakref_GetWeakrefCount(PyWeakReference *head);
|
|
|
|
PyAPI_FUNC(void) _PyWeakref_ClearRef(PyWeakReference *self);
|
|
|
|
/* Explanation for the Py_REFCNT() check: when a weakref's target is part
|
|
of a long chain of deallocations which triggers the trashcan mechanism,
|
|
clearing the weakrefs can be delayed long after the target's refcount
|
|
has dropped to zero. In the meantime, code accessing the weakref will
|
|
be able to "see" the target object even though it is supposed to be
|
|
unreachable. See issue #16602. */
|
|
|
|
#define PyWeakref_GET_OBJECT(ref) \
|
|
(Py_REFCNT(((PyWeakReference *)(ref))->wr_object) > 0 \
|
|
? ((PyWeakReference *)(ref))->wr_object \
|
|
: Py_None)
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_WEAKREFOBJECT_H */
|