README.python.md

   1 To enable HarfBuzz bindings for Python among other languages, make sure
   2 you have latest version of gobject-introspection available.  On Ubuntu,
   3 you can install that this way:
   4
   5 ```bash
   6 sudo apt-get install libgirepository1.0-dev
   7 ```
   8
   9 And then run `autogen.sh` (if building from git), and then:
  10
  11 ```bash
  12 ./configure --with-gobject --enable-introspection
  13 ```
  14
  15 Make sure that gobject-introspection is reported enabled then in the `configure` script output.
  16
  17 Compile and install.
  18
  19 Make sure you have the installation lib dir in `LD_LIBRARY_PATH`, as needed
  20 for the linker to find the library.
  21
  22 Then make sure you also have `GI_TYPELIB_PATH` pointing to the resulting
  23 `$prefix/lib/girepository-*` directory.
  24
  25 Make sure you have pygobject installed.  Then check that the following
  26 import works in your Python interpreter:
  27
  28 ```python
  29 from gi.repository import HarfBuzz
  30 ```
  31
  32 If it does, you are ready to call HarfBuzz from Python!  Congratulations.
  33 See [`src/sample.py`](src/sample.py).
  34
  35 The Python API will change.  Let us know on the mailing list if you are
  36 using it, and send lots of feedback.