Examples

ctypes Shared Library

This demo compiles a tiny C library and loads it via ctypes. It is the fastest path to understand how Python calls into native code without building a full extension.

Build the shared library and run the ctypes demo:

cd src/new_year_2026/ctypes_shared
cc -shared -fPIC -o libhello.so hello.c
python hello_ctypes.py

Note

On macOS, use libhello.dylib. On Windows, build a hello.dll with MSVC.

C/C++ Extension (pybind11)

This demo builds the main package with a compiled extension module.

Build the package and install the wheel:

python -m pip install -U pip build pybind11 wheel
python -m build
python -m pip install dist/*.whl

Use the extension:

python -c "from new_year_2026 import hello_ext; print(hello_ext.add(2, 3)); print(hello_ext.mul(3, 4))"