summaryrefslogtreecommitdiff
path: root/Build/source/libs/harfbuzz/harfbuzz-src/README.python.md
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
committerKarl Berry <karl@freefriends.org>2021-02-25 19:22:25 +0000
commitad547a6b5986815fda458221149728d9d9ab1d87 (patch)
tree16296910eb3eca724371474ea9aea3994dc69614 /Build/source/libs/harfbuzz/harfbuzz-src/README.python.md
parent947b43de3dd21d58ccc2ffadefc4441ea1c2a813 (diff)
restore Build,TODO from r57911
git-svn-id: svn://tug.org/texlive/trunk@57915 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/libs/harfbuzz/harfbuzz-src/README.python.md')
-rw-r--r--Build/source/libs/harfbuzz/harfbuzz-src/README.python.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/Build/source/libs/harfbuzz/harfbuzz-src/README.python.md b/Build/source/libs/harfbuzz/harfbuzz-src/README.python.md
new file mode 100644
index 00000000000..7496f045ec9
--- /dev/null
+++ b/Build/source/libs/harfbuzz/harfbuzz-src/README.python.md
@@ -0,0 +1,31 @@
+To enable HarfBuzz bindings for Python among other languages, make sure
+you have latest version of gobject-introspection available. On Ubuntu,
+you can install that this way:
+
+```bash
+sudo apt-get install libgirepository1.0-dev
+```
+
+And then run `meson setup` and make sure that `Introspection` is reported
+enabled in output.
+
+Compile and install.
+
+Make sure you have the installation lib dir in `LD_LIBRARY_PATH`, as needed
+for the linker to find the library.
+
+Then make sure you also have `GI_TYPELIB_PATH` pointing to the resulting
+`$prefix/lib/girepository-*` directory.
+
+Make sure you have pygobject installed. Then check that the following
+import works in your Python interpreter:
+
+```python
+from gi.repository import HarfBuzz
+```
+
+If it does, you are ready to call HarfBuzz from Python! Congratulations.
+See [`src/sample.py`](src/sample.py).
+
+The Python API will change. Let us know on the mailing list if you are
+using it, and send lots of feedback.