cd312649dbcde47dbc4e2f49e245c58ab1de007b
[platform/upstream/harfbuzz.git] / README.python
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   sudo apt-get install libgirepository1.0-dev
6
7 And then run autogen.sh (if building from git), and then:
8
9   ./configure --with-gobject --enable-introspection
10
11 Make sure that gobject-introspection is enabled then in the final report.
12
13 Compile and install.
14
15 Make sure you have the installation lib dir in LD_LIBRARY_PATH, as needed
16 for the linker to find the library.
17
18 Then make sure you also have GI_TYPELIB_PATH pointing to the resulting
19 $prefix/lib/girepository-* directory.
20
21 Make sure you have pygobject installed.  Then check that the following
22 import works in your Python interpretter:
23
24   from gi.repository import HarfBuzz
25
26 If it does, you are ready to call HarfBuzz from Python!  Congratulations.
27 See src/sample.py.
28
29 The Python API will change.  Let us know on the mailing list if you are
30 using it, and send lots of feedback.