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.

Currently, Haiku-PyAPI is best suited to scripts and small, simpleapplications.

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 occasionally. Besidesthis, you can expect memory leaks, as little work has been done on gettingmemory freed correctly once it is no longer needed.

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, clone the source code, with submodules:

git clone https://github.com/coolcder613eb/Haiku-PyAPI --recursive

The basic build command to build using all CPU cores is

jam -j$(nproc)

Extra build parameters can be specified, as discussed below.

Finally, to install, simply run

jam install

Haiku-PyAPI should now be installed and ready to use.

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.