Repository files navigation

Python bindings for the Haiku API.

This lets you build apps for Haiku using the Haiku API directly from Python.

For the most part, Haiku-PyAPI tries to copy the C++ API. There are some placeswhere we have had to deviate from the C++ API, however.

Almost everything in the app and interface kits have been ported. The storagekit has mostly been ported. The support kit has only partially been ported.The other kits haven't been ported yet.

Of the kits that have been ported, many of the functions haven't been testedyet. You should, therefore, expect to encounter problems when using some of thefunctions. Besides this, you can expect memory leaks, as little work has beendone on getting memory freed correctly once it is no longer needed. And, ofcourse, you should expect many miscellaneous bugs.

Installation on Haiku is easy, just run

pkgman install haiku_pyapi_python310

or

pkgman install haiku_pyapi_python39

If you need the latest widgets and bugfixes, then you should compile from source, see below.

First, install the appropriate version of pybind11 for your CPU architecture and version of Python. For example, to install pybind11 for x86 and python3.10, run

pkgman install pybind11_x86_python310

The basic build command to build using all CPU cores is

jam -j$(nproc)

Extra build parameters can be specified, as discussed below.

The build parameters can be used to change how the build is done. This can beused to, for example, specify a different verson of python to build for. Tospecify a build parameter, add-sPARAMETER=VALUE to the build command line.

This repository containstest.py, which is a simple "Hello world" program.The matching gameBeMatchedprovides another example of the library in use.