1 See INSTALL for instructions on configuring, building, and installing this
2 software. See TODO for the to-do list. See HACKING for information relevant
3 to anyone wanting to do development work on the bindings.
8 Most development work has been done on Linux with GCC, but the bindings should
9 work on other Unix-like platforms and with other compilers (we've heard success
10 stories for at least macOS >= 10.3, FreeBSD, NetBSD and OpenBSD).
12 The Python bindings have been successfully built on Microsoft Windows using
13 Mingw and MSVC: the PHP bindings have been successfully build on Microsoft
14 Windows using MSVC. The other bindings may need a few build tweaks to work
15 - contact us via the mailing lists if you want to get them working.
20 Bindings for the following languages should be fully functional and ready
23 C# Tested with Mono C# 3.0.6.0 and 4.2.1.0 recently. Requires
24 .NET 2 or later (because that's what SWIG supports).
26 Java Java bindings are generated with SWIG as of Xapian 1.3.0.
27 The current API should be regarded as experimental - we plan
28 to review it, possibly make some changes and then declare it
29 stable early in the 1.4.x release series. The minimum Java
30 version we aim to support is JDK 1.6 (Java 6). Recently tested
31 with OpenJDK 1.8.0_77, 1.7.0_03, and 1.6.0_38.
33 Lua Requires Lua 5.1 or later; tested with 5.1, 5.2, 5.3 and 5.4.
35 Perl These Perl bindings are generated using SWIG, and are a
36 replacement for the hand-written Search::Xapian XS bindings.
37 They are largely compatible with Search::Xapian - see the
38 "COMPATIBILITY" section in the Xapian module's POD docs for
39 details. These bindings probably need Perl 5.8.3 or later.
40 Recently tested with 5.14.2, 5.22.1 and 5.30.0.
42 PHP Requires PHP >= 8.0. If you still need support for PHP 5.x
43 or PHP 7.x, use Xapian 1.4.21.
45 Python 2.x No longer supported. Xapian 1.4.x supports Python 2.6 and 2.7
46 (for Python 2.6, use Xapian 1.4.21).
48 Python 3.x Requires Python 3.3 or later. If you still need support for
49 Python 3.2, use Xapian 1.4.21.
51 Ruby Requires Ruby 2.1 or later (older versions are no longer
52 supported by the Ruby developers - if you still need support
53 for older Ruby, Xapian 1.2.x supports Ruby 1.8 and later).
55 Tcl Requires Tcl 8.5 or later (older versions are no longer
56 supported by the Tcl developers, so it doesn't make sense for
57 us to expend effort to support them).
59 Languages Supported Elsewhere
60 -----------------------------
62 Erlang Available from:
63 https://github.com/arcusfelis/xapian-erlang-bindings/#readme
66 https://guile-xapian.systemreboot.net/
68 Node.js Available from:
69 https://github.com/mtibeica/node-xapian#readme
72 https://github.com/amandaJayanetti/RXapian#readme
74 If you're interest in getting other languages supported, see the "Adding
75 support for other programming languages" section in the file HACKING.