Skip to main content
Help us improve Python packaging – donate today!

Tom's contact list

Project Description

Install Xapian and cbuh. In Arch Linux, I do this.

sudo pacman -S python2-xapian
sudo pip2 install cbuh

Save your contacts in ~/.cbuh/contacts with the following format.

name = Thomas Levine
email =
phone = +1 831 713 1131
place = Scarsdale; Ithaca; New York; Oakland, California; Berlin, Germany
6birthday = 19900330

email =
# ...

Run cbuh -h to see how to run. (Or look below.)

usage: cbuh [-h] [-s] [-m] [-c path] [-d path] [-p path] [-i]
            [[search term] [[search term] ...]]

Query the contact list.

positional arguments:
  [search term]         The search terms, if you're running a search

optional arguments:
  -h, --help            show this help message and exit
  -s, --sort            Sort the contacts file by person identifier.
  -m, --mutt            Export the contact list as a mutt alias file.
  -c path, --contacts path
                        The contacts file
  -d path, --database path
                        The database directory
  -p path, --prefixes path
                        The prefixes file
  -i, --index           Index the contact list.

Search the contact list in ~/.cbuh/contacts. The search is an ordinary Xapian
query ( with whatever prefixed terms
you like. I suggest these.

* id
* name
* email
* phone
* place

If you apply these prefixes, you search within that field only;
for example, "name:Francisco" searches for people with names like
"Francisco". Searching for simply "Francisco", on the other hand,
will also match everyone who lives in San Francisco.

Prefixes that start with digits 0 to 4 are treated as numeric values,
with the digit being the slot. For example, I use ``1want`` to
indicate how much I want to see someone, so I can search for people
I really want to see with ``want20..``.

Prefixes that start with digits 5 to 9 are treated as date values,
with the digit being the slot. For example, I use ``6born`` to indicate
when someone was born.

Release history Release notifications

This version
History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
cbuh-0.0.1.tar.gz (3.8 kB) Copy SHA256 hash SHA256 Source None Nov 23, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page