PyCyBase 0.1.8.post4__cp313-cp313-win_amd64.whl

cbase/allocator_protocol/c_shm_comp.h

@@ -0,0 +1,49 @@
+#ifndef C_SHM_COMP_H
+#define C_SHM_COMP_H
+
+/**
+ * c_shm_comp.h -- Platform-dispatch compatibility header for SHM allocators.
+ *
+ * On POSIX:   includes c_shm_allocator.h directly.
+ * On Windows: includes c_nt_shm_allocator.h and aliases nt_shm_* -> shm_*.
+ *
+ * This header exists so that Cython .pxd / .pyx files can declare SHM types
+ * via a single `cdef extern from "cbase/allocator_protocol/c_shm_comp.h"`
+ * without IF UNAME_SYSNAME branching.
+ */
+
+#ifdef _WIN32
+#include "cbase/allocator_protocol/c_nt_shm_allocator.h"
+
+typedef nt_shm_allocator     shm_allocator;
+typedef nt_shm_allocator_ctx shm_allocator_ctx;
+typedef nt_shm_page          shm_page;
+typedef nt_shm_page_ctx      shm_page_ctx;
+typedef nt_shm_memory_block  shm_memory_block;
+
+// Static inline wrappers -- visible to Cython .pxd files (unlike #define macros).
+static inline shm_allocator_ctx* c_shm_allocator_new(size_t region_size, const char* shm_prefix) {
+    return (shm_allocator_ctx*) c_nt_shm_allocator_new(region_size, shm_prefix);
+}
+static inline void c_shm_allocator_free(shm_allocator_ctx* ctx) {
+    c_nt_shm_allocator_free((nt_shm_allocator_ctx*) ctx);
+}
+static inline void* c_shm_calloc(shm_allocator_ctx* ctx, size_t size, pthread_mutex_t* lock) {
+    return c_nt_shm_calloc((nt_shm_allocator_ctx*) ctx, size, lock);
+}
+static inline void* c_shm_request(shm_allocator_ctx* ctx, size_t size, int scan_all_pages, pthread_mutex_t* lock) {
+    return c_nt_shm_request((nt_shm_allocator_ctx*) ctx, size, scan_all_pages, lock);
+}
+static inline void c_shm_free(void* ptr, pthread_mutex_t* lock) {
+    c_nt_shm_free(ptr, lock);
+}
+static inline void c_shm_reclaim(shm_allocator_ctx* ctx, pthread_mutex_t* lock) {
+    c_nt_shm_reclaim((nt_shm_allocator_ctx*) ctx, lock);
+}
+
+#else
+#include "cbase/allocator_protocol/c_shm_allocator.h"
+// Functions are already defined in c_shm_allocator.h -- no wrappers needed.
+#endif
+
+#endif  // C_SHM_COMP_H

cbase/allocator_protocol/c_shm_comp.pxd

@@ -0,0 +1,38 @@
+
+cdef extern from "cbase/allocator_protocol/c_shm_comp.h":
+    # -- Constants -----------------------------------------------------------
+
+    const size_t AP_SHM_AUTOPAGE_CAPACITY
+    const size_t AP_SHM_AUTOPAGE_CAPACITY_MAX
+    const size_t AP_SHM_AUTOPAGE_ALIGNMENT
+    const char*  AP_SHM_ALLOCATOR_PREFIX
+    const size_t AP_SHM_ALLOCATOR_DEFAULT_REGION_SIZE
+
+    # -- Types ---------------------------------------------------------------
+
+    ctypedef struct pthread_mutex_t:
+        pass
+
+    ctypedef struct shm_allocator:
+        char            shm_name[256]
+        size_t          pid
+        pthread_mutex_t lock
+        size_t          autopage_capacity
+        size_t          autopage_capacity_max
+        size_t          autopage_alignment
+        char            shm_prefix[64]
+
+    ctypedef struct shm_allocator_ctx:
+        shm_allocator* shm_allocator
+
+    # -- Functions (static inline wrappers on Windows, real on POSIX) --------
+
+    shm_allocator_ctx* c_shm_allocator_new(size_t region_size, const char* shm_prefix)
+    void               c_shm_allocator_free(shm_allocator_ctx* ctx)
+    void*              c_shm_calloc(shm_allocator_ctx* ctx, size_t size, pthread_mutex_t* lock)
+    void*              c_shm_request(shm_allocator_ctx* ctx, size_t size, int scan_all_pages, pthread_mutex_t* lock)
+    void               c_shm_free(void* ptr, pthread_mutex_t* lock)
+    void               c_shm_reclaim(shm_allocator_ctx* ctx, pthread_mutex_t* lock)
+
+
+cdef shm_allocator_ctx* C_SHM_COMP

cbase/allocator_protocol/c_shm_comp.pyx

@@ -0,0 +1 @@
+cdef shm_allocator_ctx* C_SHM_COMP = c_shm_allocator_new(AP_SHM_ALLOCATOR_DEFAULT_REGION_SIZE, AP_SHM_ALLOCATOR_PREFIX)

cbase/backports/__infra__.pxd

@@ -0,0 +1,17 @@
+from .pydict cimport BP_PyDict_Pop
+
+from .pylong cimport (
+    PyLong_FromUInt128,
+    PyLong_FromInt128,
+    PyLong_AsUInt128,
+    PyLong_AsInt128,
+
+    _UINT128_MAX,
+    _INT128_MAX,
+    _INT128_MIN,
+
+    pylong_from_uint128,
+    pylong_from_int128,
+    pylong_as_uint128,
+    pylong_as_int128,
+)

cbase/backports/__init__.pxd

@@ -0,0 +1,17 @@
+from .pydict cimport BP_PyDict_Pop
+
+from .pylong cimport (
+    PyLong_FromUInt128,
+    PyLong_FromInt128,
+    PyLong_AsUInt128,
+    PyLong_AsInt128,
+
+    _UINT128_MAX,
+    _INT128_MAX,
+    _INT128_MIN,
+
+    pylong_from_uint128,
+    pylong_from_int128,
+    pylong_as_uint128,
+    pylong_as_int128,
+)

cbase/backports/__init__.py

@@ -0,0 +1,9 @@
+from cbase.backports.pylong import (
+    pylong_from_uint128,
+    pylong_from_int128,
+    pylong_as_uint128,
+    pylong_as_int128,
+    _UINT128_MAX,
+    _INT128_MAX,
+    _INT128_MIN
+)

cbase/backports/pydict.h

@@ -0,0 +1,55 @@
+#ifndef PY_BACKPORTS_DICT_H
+#define PY_BACKPORTS_DICT_H
+
+/**
+ * dict.h -- Python C API backports for dict operations.
+ *
+ * Provides shims so that Cython extensions can call a single function
+ * regardless of the target Python version.  Each shim is exposed as a
+ * ``static inline`` function when the target Python lacks the native API,
+ * and as a thin ``#define`` alias when the native API is available.
+ */
+
+#include <Python.h>
+
+/* ===================================================================
+ * BP_PyDict_Pop  (native since Python 3.13 / PY_VERSION_HEX >= 0x030D0000)
+ * ===================================================================
+ *
+ * int BP_PyDict_Pop(PyObject *op, PyObject *key, PyObject **result)
+ *
+ * Remove *key* from dictionary *op* and return the value (a new strong
+ * reference) in **result*.
+ *
+ * Returns:  0 -- success (key found and removed)
+ *           1 -- key not present
+ *          -1 -- error (exception set, *result is NULL)
+ */
+
+#if PY_VERSION_HEX >= 0x030D0000
+#define BP_PyDict_Pop PyDict_Pop
+#else
+static inline int BP_PyDict_Pop(PyObject* op, PyObject* key, PyObject** result) {
+    PyObject* value = PyDict_GetItemWithError(op, key);
+    if (!value) {
+        /* NULL + exception -> error */
+        if (PyErr_Occurred()) {
+            *result = NULL;
+            return -1;
+        }
+        /* NULL + no exception -> key not present */
+        *result = NULL;
+        return 1;
+    }
+    Py_INCREF(value);
+    if (PyDict_DelItem(op, key) < 0) {
+        Py_DECREF(value);
+        *result = NULL;
+        return -1;
+    }
+    *result = value;
+    return 0;
+}
+#endif /* PY_VERSION_HEX >= 0x030D0000 */
+
+#endif /* PY_BACKPORTS_DICT_H */

cbase/backports/pydict.pxd

@@ -0,0 +1,5 @@
+from cpython.object cimport PyObject
+
+
+cdef extern from "cbase/backports/pydict.h":
+    int BP_PyDict_Pop(PyObject* p, PyObject* key, PyObject** result)