aboutsummaryrefslogtreecommitdiff

guile-xapian-with-guile-2.2.svg guile-xapian-with-guile-3.0.svg guile-xapian-with-guile-3.0-latest.svg guile-xapian-website.svg

guile-xapian provides Guile bindings for Xapian, a search engine library. Xapian is a highly adaptable toolkit which allows developers to easily add advanced indexing and search facilities to their own applications. It has built-in support for several families of weighting models and also supports a rich set of boolean query operators.

Once these bindings are sufficiently mature, they will be merged with xapian-bindings. This will involve creating more complete Scheme-friendly wrapping of the Xapian library, writing test cases and documentation. When we are done, the user should not ever have to call the low level functions in (xapian wrap) and should be able to do almost everything using only the higher level Scheme-friendly functions in (xapian xapian).

There is no proper documentation yet. See the examples in the source tree. Also see Getting Started with Xapian which describes the Python bindings.

*Warning:* guile-xapian is in a very early stage of development and the high level API in (xapian xapian) is not stable. It may change at any time.

Usage

Drop into a development environment.

guix shell -Df guix.scm

Bootstrap autotools, then configure and make.

./bootstrap.sh
./configure
make

Try out the examples.

First, let's index data in examples/100-objects.sexp creating a Xapian database at /tmp/db.

./pre-inst-env guile examples/index.scm examples/100-objects.sexp /tmp/db

Then, we may run searches on the database. Shown below are a few example searches.

./pre-inst-env guile examples/search.scm /tmp/db watch
./pre-inst-env guile examples/search.scm /tmp/db Dent watch
./pre-inst-env guile examples/search.scm /tmp/db title:sunwatch
./pre-inst-env guile examples/search.scm /tmp/db description:\"leather case\" AND title:sundial

Contributing

Feedback, suggestions, feature requests and bug reports are all welcome. Please write to me at arunisaac@systemreboot.net.

Contributors

Thanks to these wonderful people! :-)

Bob131
bug reports, code, tests
Ricardo Wurmus
bug reports, ideas
Ludovic Courtès
bug reports

License

guile-xapian is free software released under the terms of the GNU General Public License, either version 2 of the License, or (at your option) any later version.