- libgbinder
- libglibutil
- pkgconf
For development, you will also need Cython:
pip install cythonThere are two Cython files: cgbinder.pxd describing the C++ API of the libgbinder library, and gbinder.pyx describing classes that will be visible from Python user code.
The .pyx imports .pxd to learn about C functions available to be called.
There is also setup.py file.
This file describes how to build the extension module, using distutils.
In there, we specify the library to link with as libraries=['gbinder']. The gbinder stands for libgbinder.so that we previously installed.
There are two options to build the package:
- One, use Cython's
cythonize()function to generate a.cfile from the.pyxone, and then compile it against thelibgbinder.solibrary. - Two, if the
.cis already provided, just compile it - no Cython required!
For development, use option 1 by providing --cython flag:
python setup.py build_ext --inplace --cythonThe result will be a .so shared library named like gbinder.cpython-38-x86_64-linux-gnu.so.
build_ext means we're building a C++ extension. --inplace means to put it in the current directory.
If you run python from current directory, you'll be able to import gbinder.
To distribute, call sdist with --cython flag to create source distribution (unbuilt):
python setup.py sdist --cythonThe result will be a dist/ directory with a distribution named like gbinder-python-*.tar.gz inside.
The archive contains setup.py and gbinder.c, so users can build and install it without having Cython!
To publish to PyPI, run:
twine upload -r pypi dist/*To install, locate the .tar.gz distribution and run:
pip install dist/gbinder-python-*.tar.gz
