Creation of the project

Author: vstinner

.gitignore

@@ -0,0 +1,2 @@
+*.swp
+tests/build/

CODE_OF_CONDUCT.md

@@ -0,0 +1,11 @@
+# Code of Conduct
+
+Please note that all interactions on
+[Python Software Foundation](https://www.python.org/psf-landing/)-supported
+infrastructure is [covered](https://www.python.org/psf/records/board/minutes/2014-01-06/#management-of-the-psfs-web-properties)
+by the [PSF Code of Conduct](https://www.python.org/psf/codeofconduct/),
+which includes all the infrastructure used in the development of Python itself
+(e.g. mailing lists, issue trackers, GitHub, etc.).
+
+In general, this means that everyone is expected to be **open**, **considerate**, and
+**respectful** of others no matter what their position is within the project.

COPYING

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+Copyright 2016, Red Hat, Inc. and Google Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.rst

@@ -0,0 +1,75 @@
+++++++++++++++++++++++++++
+Python C API compatibility
+++++++++++++++++++++++++++
+
+Header file providing new functions of the Python C API for old Python versions.
+
+Python 3.6 to Python 3.10 are supported. It requires a subset of C99 like
+``static inline`` functions:
+see `PEP 7 <https://www.python.org/dev/peps/pep-0007/>`_.
+
+Homepage: https://github.com/pythoncapi/pythoncapi_compat
+
+This project is distributed under the MIT license.
+
+This project is covered by the `PSF Code of Conduct
+<https://www.python.org/psf/codeofconduct/>`_.
+
+This project is guided by evolution of the C API described in:
+`PEP xxx: Modify the C API to hide implementation details
+<https://github.com/vstinner/misc/blob/master/cpython/pep-opaque-c-api.rst>`_
+(draft).
+
+Usage
+=====
+
+Copy the header file in your project and include it using::
+
+    #include "pythoncapi_compat.h"
+
+Functions
+=========
+
+Python 3.9
+----------
+
+::
+
+    // PyObject
+    void Py_SET_REFCNT(PyObject *ob, Py_ssize_t refcnt)
+    void Py_SET_TYPE(PyObject *ob, PyTypeObject *type)
+    void Py_SET_SIZE(PyVarObject *ob, Py_ssize_t size)
+
+    PyObject* PyObject_CallNoArgs(PyObject *func)
+
+    // PyFrameObject
+    PyCodeObject* PyFrame_GetCode(PyFrameObject *frame)
+    PyFrameObject* PyFrame_GetBack(PyFrameObject *frame)
+
+    // PyThreadState
+    PyFrameObject* PyThreadState_GetFrame(PyThreadState *tstate)
+    PyInterpreterState* PyThreadState_GetInterpreter(PyThreadState *tstate)
+    // Availability: Python 3.7+
+    uint64_t PyThreadState_GetID(PyThreadState *tstate)
+
+    // PyInterpreterState
+    PyInterpreterState* PyInterpreterState_Get(void)
+
+    // GC protocol
+    int PyObject_GC_IsTracked(PyObject* obj)
+    int PyObject_GC_IsFinalized(PyObject *obj)
+
+    // Module helper
+    int PyModule_AddType(PyObject *module, PyTypeObject *type)
+
+
+Run tests
+=========
+
+Run the command::
+
+    python3 tests/test_matrix.py
+
+To test one specific Python executable::
+
+    python3.6 tests/run_tests.py

pythoncapi_compat.h

@@ -0,0 +1,174 @@
+/* Header file providing new functions of the Python C API
+   for old Python versions.
+
+   File distributed under the MIT license.
+   Homepage: https://github.com/pythoncapi/pythoncapi_compat.
+*/
+
+#ifndef PYTHONCAPI_COMPAT
+#define PYTHONCAPI_COMPAT
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include <Python.h>
+#include "frameobject.h"          // PyFrameObject
+
+
+// bpo-39573: Py_TYPE(), Py_REFCNT() and Py_SIZE() can no longer be used
+// as l-value in Python 3.10.
+#if PY_VERSION_HEX < 0x030900A4
+static inline void _Py_SET_REFCNT(PyObject *ob, Py_ssize_t refcnt)
+{
+    ob->ob_refcnt = refcnt;
+}
+#define Py_SET_REFCNT(ob, refcnt) _Py_SET_REFCNT((PyObject*)(ob), refcnt)
+
+
+static inline void
+_Py_SET_TYPE(PyObject *ob, PyTypeObject *type)
+{
+    ob->ob_type = type;
+}
+#define Py_SET_TYPE(ob, type) _Py_SET_TYPE((PyObject*)(ob), type)
+
+static inline void
+_Py_SET_SIZE(PyVarObject *ob, Py_ssize_t size)
+{
+    ob->ob_size = size;
+}
+#define Py_SET_SIZE(ob, size) _Py_SET_SIZE((PyVarObject*)(ob), size)
+
+#endif  // PY_VERSION_HEX < 0x030900A4
+
+
+#if PY_VERSION_HEX < 0x030900B1
+static inline PyCodeObject*
+PyFrame_GetCode(PyFrameObject *frame)
+{
+    assert(frame != NULL);
+    PyCodeObject *code = frame->f_code;
+    assert(code != NULL);
+    Py_INCREF(code);
+    return code;
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030900B1
+static inline PyFrameObject*
+PyFrame_GetBack(PyFrameObject *frame)
+{
+    assert(frame != NULL);
+    PyFrameObject *back = frame->f_back;
+    Py_XINCREF(back);
+    return back;
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030900A5
+static inline PyInterpreterState *
+PyThreadState_GetInterpreter(PyThreadState *tstate)
+{
+    assert(tstate != NULL);
+    return tstate->interp;
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030900B1
+static inline PyFrameObject*
+PyThreadState_GetFrame(PyThreadState *tstate)
+{
+    assert(tstate != NULL);
+    PyFrameObject *frame = tstate->frame;
+    Py_XINCREF(frame);
+    return frame;
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030900A5
+static inline PyInterpreterState *
+PyInterpreterState_Get(void)
+{
+    PyThreadState *tstate = PyThreadState_GET();
+    if (tstate == NULL) {
+        Py_FatalError("GIL released (tstate is NULL)");
+    }
+    PyInterpreterState *interp = tstate->interp;
+    if (interp == NULL) {
+        Py_FatalError("no current interpreter");
+    }
+    return interp;
+}
+#endif
+
+
+#if 0x030700A1 <= PY_VERSION_HEX && PY_VERSION_HEX < 0x030900A6
+static inline uint64_t
+PyThreadState_GetID(PyThreadState *tstate)
+{
+    assert(tstate != NULL);
+    return tstate->id;
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030900A1
+static inline PyObject*
+PyObject_CallNoArgs(PyObject *func)
+{
+    return PyObject_CallFunctionObjArgs(func, NULL);
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030900A5
+static inline int
+PyModule_AddType(PyObject *module, PyTypeObject *type)
+{
+    if (PyType_Ready(type) < 0) {
+        return -1;
+    }
+
+    // inline _PyType_Name()
+    const char *name = type->tp_name;
+    assert(name != NULL);
+    const char *dot = strrchr(name, '.');
+    if (dot != NULL) {
+        name = dot + 1;
+    }
+
+    Py_INCREF(type);
+    if (PyModule_AddObject(module, name, (PyObject *)type) < 0) {
+        Py_DECREF(type);
+        return -1;
+    }
+
+    return 0;
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030900A6
+static inline int
+PyObject_GC_IsTracked(PyObject* obj)
+{
+    return (PyObject_IS_GC(obj) && _PyObject_GC_IS_TRACKED(obj));
+}
+
+static inline int
+PyObject_GC_IsFinalized(PyObject *obj)
+{
+    return (PyObject_IS_GC(obj) && _PyGCHead_FINALIZED((PyGC_Head *)(obj)-1));
+}
+#endif  // PY_VERSION_HEX < 0x030900A6
+
+
+#ifdef __cplusplus
+}
+#endif
+#endif  // PYTHONCAPI_COMPAT