Skip to main content

c2py23

All code in this repository was generated by DeepSeek V4 and other large language models, in collaboration with jonwright.

Wrap C99 functions as Python C extensions via the buffer protocol. One compiled .so works on Python 2.7 through 3.15 with no recompilation. Zero copies, zero allocations. No numpy required.

Install

pip install c2py23

Requires a C99 compiler (gcc, clang, or MSVC on Windows). No Python dependencies beyond stdlib.

Quick Start

Create a C function:

/* arraysum.c */
#include <stdint.h>
int array_sum(const double *a, const double *b, double *out, intptr_t n) {
    for (intptr_t i = 0; i < n; i++) out[i] = a[i] + b[i];
    return n;
}

Write the interface file:

# arraysum.c2py
{
    "module": "arraysum",
    "source": ["arraysum.c"],
    "functions": [
        {
            "py_sig": "array_sum(a: buffer, b: buffer, out: buffer) -> int",
            "checks": [
                "a.format == 'd'",
                "b.format == 'd'",
                "out.format == 'd'",
            ],
            "c_overloads": [
                {
                    "sig": "array_sum(const double *a, const double *b, double *out, intptr_t n) -> int",
                    "map": {
                        "a": "a.ptr",
                        "b": "b.ptr",
                        "out": "out.ptr",
                        "n": "a.n",
                    },
                },
            ],
        },
    ],
}

Build and use:

# Generate the wrapper
c2py23 arraysum.c2py -o arraysum_wrapper.c

# Compile (dlsym mode  --  portable, no libpython)
cc -shared -fPIC -I c2py23/runtime/ arraysum_wrapper.c arraysum.c \
   c2py23/runtime/c2py_runtime.c -ldl -lm -o arraysum.so

# Or build via setuptools
python setup.py build_ext --inplace

python3 -c "
import ctypes, sys; sys.path.insert(0, '.')
import arraysum
a = (ctypes.c_double * 4)(1, 2, 3, 4)
b = (ctypes.c_double * 4)(5, 6, 7, 8)
r = (ctypes.c_double * 4)(0, 0, 0, 0)
arraysum.array_sum(a, b, r)
print(list(r))  # [6.0, 8.0, 10.0, 12.0]
"

Usage

c2py23 file.c2py -o wrapper.c       # generate C wrapper
c2py23 file.c2py                     # print to stdout
c2py23 --version                     # print version
c2py23 file.c2py -o wrapper.c --emit-header       # also emit c2py.h alongside the wrapper
c2py23 --regenerate-header                        # regenerate c2py.h from runtime sources

# Or via python -m:
python -m c2py23 file.c2py -o wrapper.c

See c2py23/setuptools_helper.py for PythonhBuildExt setuptools helper (pythonh mode only).

Supported Platforms

Linux (x86_64, aarch64, gcc/clang/tcc/zig), macOS (aarch64, clang), Windows (x64/i386, MSVC/MinGW). Free-threaded Python 3.13+ supported.

Examples

The GitHub repository includes build examples (not in the PyPI sdist):

  • examples/kissfft_wrap/ -- real + complex FFT over float buffers
  • examples/lz4_wrap/ -- compress/decompress over byte buffers
  • examples/simd_dispatch/ -- CPU feature dispatch (SSE2/AVX2/AVX-512, NEON, Altivec)
  • examples/threading_bench/ -- GIL release, free-threading, OpenMP
  • examples/wheel_demo/ -- multi-platform wheel packaging
  • examples/cmake_demo/, examples/meson_demo/ -- build system integration

Documentation

  • c2py23 docs -- user guide, spec, examples, developer guide
  • docs/specification.md -- full .c2py grammar, supported types, architecture
  • docs/user_guide.md -- thread safety, wheel packaging, GIL release, timing
  • docs/getting_started.md -- installation and first build
  • docs/developer_guide.md -- testing with snakepit containers, CI, ABI matrix
  • AGENTS.md -- contributor guidelines for LLM agents

License

MIT. See LICENSE.

Metadata

Release files for c2py23 0.5.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for c2py23 0.5.10
File Size Uploaded Provenance Actions
c2py23-0.5.10.tar.gz 175.3 kB Without provenance Details for c2py23-0.5.10.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for c2py23 0.5.10
File Interpreter ABI Platform Actions
c2py23-0.5.10-py3-none-any.whl Python 3 none any Details for c2py23-0.5.10-py3-none-any.whl

Total release size: 298.9 kB

Release files / c2py23-0.5.10.tar.gz

Download URL c2py23-0.5.10.tar.gz
Size 175.3 kB
Tags Source
SHA-256 checksum
How to use checksums
8ccfe5f6db6b5a833cc330897c29796fcbb86474ba88f9eb896aab73ee9715fe
BLAKE2b-256 checksum
How to use checksums
b28245649e532d7808370646369a9454690487a72170dd08a958685ede36894e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / c2py23-0.5.10-py3-none-any.whl

Download URL c2py23-0.5.10-py3-none-any.whl
Size 123.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e63f83d7f5ff70e2539636f7b5be6aacafd9c8171d7bfc2104f81d02279de957
BLAKE2b-256 checksum
How to use checksums
36c38a1242c4596b177d653d1a60f6eb5f32e5023bebc294d5605a6b60e46a26
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for c2py23 0.5.10

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page