coleifer
coleifer

Reputation: 26235

How do I package for distribution a python module that uses a shared library?

I'm writing some bindings for a C library and am not sure how to configure all this for distribution so it is possible to pip install my package.

Let's say I have the following files:

In order for my wrapper library to work it is necessary to:

Here are the commands:

Running setup.py will also depend on the user having installed ctypesgen.

I have no idea how to get this all set up so that someone interested in the library can simply pip install library and have all this happen automagically. Anyone able to help?

Upvotes: 16

Views: 4570

Answers (1)

danny
danny

Reputation: 5270

The Extensions capability of setuptools/distutils is what you need.

Documentation has more information, in short an example setup.py to do the above would look like the below

from setuptools import setup, find_packages, Extension

extensions = [Extension("my_package.ext_library",
                       ["src/library.c"],
                       depends=["src/library.h"],
                       include_dirs=["src"],
              ),
]
setup(<..>,
     ext_modules=extensions,
)

The .so is generated automatically by setup.py when the module is built. If it needs to link to other libraries can supply a libraries argument list to the extension. See docs(1) for more info.

Since this is built in functionality of setuptools, it works fine with pip and can be distributed (as source code only) on pypi. All source files referenced by the Extension must be present in the distributed pypi archive.

If you want to build distributable binary wheels including native code see manylinux.

Upvotes: 9

Related Questions