Using distutils and build_clib to build a C library

README.md

Using distutils and build_clib to build a C library

This repository demonstrates how to build a C library that is included in the module distribution.

To build the C library:

python setup.py build_clib

To build the extension module (in place):

python setup.py build_ext --inplace

To test the module:

python test.py
# or
py.test test.py

demo.pxd

cdef extern from "hello.h":
    int hello()

demo.pyx

cimport demo
cpdef test():
    return hello()

hello.c

int hello(void) { return 42; }

hello.h

int hello(void);

setup.py

import sys
from distutils.core import setup
from distutils.command.build_clib import build_clib
from distutils.extension import Extension
from Cython.Distutils import build_ext

libhello = ('hello', {'sources': ['hello.c']})

ext_modules=[
    Extension("demo", ["demo.pyx"])
]

def main():
    setup(
        name = 'demo',
        libraries = [libhello],
        cmdclass = {'build_clib': build_clib, 'build_ext': build_ext},
        ext_modules = ext_modules
    )

if __name__ == '__main__':
    main()

test.py

import demo

def test_hello():
    ret = demo.test()
    assert(ret == 42)

if __name__ == '__main__':
    test_hello()