]> git.notmuchmail.org Git - notmuch/blobdiff - notmuch.c
cli: add standard option processing to config, help and setup
[notmuch] / notmuch.c
index 6be2881c2227a1e67d407f69c43506417ced140f..c528dce2d12100b66d9dffd00093faefd33f5965 100644 (file)
--- a/notmuch.c
+++ b/notmuch.c
@@ -1,6 +1,7 @@
 /* notmuch - Not much of an email program, (just index and search)
  *
  * Copyright © 2009 Carl Worth
+ * Copyright © 2009 Keith Packard
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see http://www.gnu.org/licenses/ .
  *
- * Author: Carl Worth <cworth@cworth.org>
+ * Authors: Carl Worth <cworth@cworth.org>
+ *         Keith Packard <keithp@keithp.com>
  */
 
-#include "notmuch.h"
+#include "notmuch-client.h"
 
-#ifndef _GNU_SOURCE
-#define _GNU_SOURCE /* for getline */
-#endif
-
-#include <stdio.h>
-#include <stdlib.h>
-#include <stddef.h>
-#include <string.h>
-#include <sys/types.h>
-#include <sys/stat.h>
-#include <sys/time.h>
-#include <unistd.h>
-#include <dirent.h>
-#include <errno.h>
-
-#include <talloc.h>
-
-#include <glib.h> /* g_strdup_printf */
-
-#define ARRAY_SIZE(arr) (sizeof (arr) / sizeof (arr[0]))
-
-typedef int (*command_function_t) (int argc, char *argv[]);
+/*
+ * Notmuch subcommand hook.
+ *
+ * The return value will be used as notmuch exit status code,
+ * preferrably EXIT_SUCCESS or EXIT_FAILURE.
+ */
+typedef int (*command_function_t) (notmuch_config_t *config, int argc, char *argv[]);
 
 typedef struct command {
     const char *name;
     command_function_t function;
-    const char *usage;
+    notmuch_bool_t create_config;
+    const char *summary;
 } command_t;
 
-typedef struct {
-    int total_messages;
-    int count;
-    struct timeval tv_start;
-} add_files_state_t;
+static int
+notmuch_help_command (notmuch_config_t *config, int argc, char *argv[]);
 
-/* Compute the number of seconds elapsed from start to end. */
-double
-tv_elapsed (struct timeval start, struct timeval end)
-{
-    return ((end.tv_sec - start.tv_sec) +
-           (end.tv_usec - start.tv_usec) / 1e6);
-}
+static int
+notmuch_command (notmuch_config_t *config, int argc, char *argv[]);
 
-void
-print_formatted_seconds (double seconds)
-{
-    int hours;
-    int minutes;
+static int
+_help_for (const char *topic);
 
-    if (seconds > 3600) {
-       hours = (int) seconds / 3600;
-       printf ("%dh ", hours);
-       seconds -= hours * 3600;
-    }
+static notmuch_bool_t print_version = FALSE, print_help = FALSE;
+
+const notmuch_opt_desc_t notmuch_shared_options [] = {
+    { NOTMUCH_OPT_BOOLEAN, &print_version, "version", 'v', 0 },
+    { NOTMUCH_OPT_BOOLEAN, &print_help, "help", 'h', 0 },
+    {0, 0, 0, 0, 0}
+};
 
-    if (seconds > 60) {
-       minutes = (int) seconds / 60;
-       printf ("%dm ", minutes);
-       seconds -= minutes * 60;
+/* any subcommand wanting to support these options should call
+ * inherit notmuch_shared_options and call
+ * notmuch_process_shared_options (subcommand_name);
+ */
+void
+notmuch_process_shared_options (const char *subcommand_name) {
+    if (print_version) {
+       printf ("notmuch " STRINGIFY(NOTMUCH_VERSION) "\n");
+       exit (EXIT_SUCCESS);
     }
 
-    printf ("%02ds", (int) seconds);
+    if (print_help) {
+       int ret = _help_for (subcommand_name);
+       exit (ret);
+    }
 }
 
-void
-add_files_print_progress (add_files_state_t *state)
+/* This is suitable for subcommands that do not actually open the
+ * database.
+ */
+int notmuch_minimal_options (const char *subcommand_name,
+                                 int argc, char **argv)
 {
-    struct timeval tv_now;
-    double elapsed_overall, rate_overall;
+    int opt_index;
 
-    gettimeofday (&tv_now, NULL);
+    notmuch_opt_desc_t options[] = {
+       { NOTMUCH_OPT_INHERIT, (void *) &notmuch_shared_options, NULL, 0, 0 },
+       { 0, 0, 0, 0, 0 }
+    };
 
-    elapsed_overall = tv_elapsed (state->tv_start, tv_now);
-    rate_overall = (state->count) / elapsed_overall;
+    opt_index = parse_arguments (argc, argv, options, 1);
 
-    printf ("Added %d of %d messages (",
-           state->count, state->total_messages);
-    print_formatted_seconds ((state->total_messages - state->count) /
-                            rate_overall);
-    printf (" remaining).\r");
+    if (opt_index < 0)
+       return -1;
 
-    fflush (stdout);
+    /* We can't use argv here as it is sometimes NULL */
+    notmuch_process_shared_options (subcommand_name);
+    return opt_index;
 }
 
-/* Recursively find all regular files in 'path' and add them to the
- * database. */
-void
-add_files (notmuch_database_t *notmuch, const char *path,
-          add_files_state_t *state)
+static command_t commands[] = {
+    { NULL, notmuch_command, TRUE,
+      "Notmuch main command." },
+    { "setup", notmuch_setup_command, TRUE,
+      "Interactively set up notmuch for first use." },
+    { "new", notmuch_new_command, FALSE,
+      "Find and import new messages to the notmuch database." },
+    { "insert", notmuch_insert_command, FALSE,
+      "Add a new message into the maildir and notmuch database." },
+    { "search", notmuch_search_command, FALSE,
+      "Search for messages matching the given search terms." },
+    { "address", notmuch_address_command, FALSE,
+      "Get addresses from messages matching the given search terms." },
+    { "show", notmuch_show_command, FALSE,
+      "Show all messages matching the search terms." },
+    { "count", notmuch_count_command, FALSE,
+      "Count messages matching the search terms." },
+    { "reply", notmuch_reply_command, FALSE,
+      "Construct a reply template for a set of messages." },
+    { "tag", notmuch_tag_command, FALSE,
+      "Add/remove tags for all messages matching the search terms." },
+    { "dump", notmuch_dump_command, FALSE,
+      "Create a plain-text dump of the tags for each message." },
+    { "restore", notmuch_restore_command, FALSE,
+      "Restore the tags from the given dump file (see 'dump')." },
+    { "compact", notmuch_compact_command, FALSE,
+      "Compact the notmuch database." },
+    { "config", notmuch_config_command, FALSE,
+      "Get or set settings in the notmuch configuration file." },
+    { "help", notmuch_help_command, TRUE, /* create but don't save config */
+      "This message, or more detailed help for the named command." }
+};
+
+typedef struct help_topic {
+    const char *name;
+    const char *summary;
+} help_topic_t;
+
+static help_topic_t help_topics[] = {
+    { "search-terms",
+      "Common search term syntax." },
+    { "hooks",
+      "Hooks that will be run before or after certain commands." },
+};
+
+static command_t *
+find_command (const char *name)
 {
-    DIR *dir;
-    struct dirent *entry, *e;
-    int entry_length;
-    int err;
-    char *next;
-    struct stat st;
-    notmuch_status_t status;
+    size_t i;
 
-    dir = opendir (path);
+    for (i = 0; i < ARRAY_SIZE (commands); i++)
+       if ((!name && !commands[i].name) ||
+           (name && commands[i].name && strcmp (name, commands[i].name) == 0))
+           return &commands[i];
 
-    if (dir == NULL) {
-       fprintf (stderr, "Warning: failed to open directory %s: %s\n",
-                path, strerror (errno));
-       return;
-    }
+    return NULL;
+}
 
-    entry_length = offsetof (struct dirent, d_name) +
-       pathconf (path, _PC_NAME_MAX) + 1;
-    entry = malloc (entry_length);
-
-    while (1) {
-       err = readdir_r (dir, entry, &e);
-       if (err) {
-           fprintf (stderr, "Error reading directory: %s\n",
-                    strerror (errno));
-           free (entry);
-           return;
-       }
+int notmuch_format_version;
 
-       if (e == NULL)
-           break;
+static void
+usage (FILE *out)
+{
+    command_t *command;
+    help_topic_t *topic;
+    unsigned int i;
 
-       /* Ignore special directories to avoid infinite recursion.
-        * Also ignore the .notmuch directory.
-        */
-       /* XXX: Eventually we'll want more sophistication to let the
-        * user specify files to be ignored. */
-       if (strcmp (entry->d_name, ".") == 0 ||
-           strcmp (entry->d_name, "..") == 0 ||
-           strcmp (entry->d_name, ".notmuch") ==0)
-       {
-           continue;
-       }
+    fprintf (out,
+            "Usage: notmuch --help\n"
+            "       notmuch --version\n"
+            "       notmuch <command> [args...]\n");
+    fprintf (out, "\n");
+    fprintf (out, "The available commands are as follows:\n");
+    fprintf (out, "\n");
 
-       next = g_strdup_printf ("%s/%s", path, entry->d_name);
-
-       stat (next, &st);
-
-       if (S_ISREG (st.st_mode)) {
-           status = notmuch_database_add_message (notmuch, next);
-           if (status == NOTMUCH_STATUS_FILE_NOT_EMAIL) {
-               fprintf (stderr, "Note: Ignoring non-mail file: %s\n",
-                        next);
-           } else {
-               state->count++;
-           }
-           if (state->count % 1000 == 0)
-               add_files_print_progress (state);
-       } else if (S_ISDIR (st.st_mode)) {
-           add_files (notmuch, next, state);
-       }
+    for (i = 0; i < ARRAY_SIZE (commands); i++) {
+       command = &commands[i];
 
-       free (next);
+       if (command->name)
+           fprintf (out, "  %-12s  %s\n", command->name, command->summary);
     }
 
-    free (entry);
+    fprintf (out, "\n");
+    fprintf (out, "Additional help topics are as follows:\n");
+    fprintf (out, "\n");
+
+    for (i = 0; i < ARRAY_SIZE (help_topics); i++) {
+       topic = &help_topics[i];
+       fprintf (out, "  %-12s  %s\n", topic->name, topic->summary);
+    }
 
-    closedir (dir);
+    fprintf (out, "\n");
+    fprintf (out,
+            "Use \"notmuch help <command or topic>\" for more details "
+            "on each command or topic.\n\n");
 }
 
-/* Recursively count all regular files in path and all sub-direcotries
- * of path.  The result is added to *count (which should be
- * initialized to zero by the top-level caller before calling
- * count_files). */
 void
-count_files (const char *path, int *count)
+notmuch_exit_if_unsupported_format (void)
 {
-    DIR *dir;
-    struct dirent *entry, *e;
-    int entry_length;
-    int err;
-    char *next;
-    struct stat st;
-
-    dir = opendir (path);
-
-    if (dir == NULL) {
-       fprintf (stderr, "Warning: failed to open directory %s: %s\n",
-                path, strerror (errno));
-       return;
+    if (notmuch_format_version > NOTMUCH_FORMAT_CUR) {
+       fprintf (stderr, "\
+A caller requested output format version %d, but the installed notmuch\n\
+CLI only supports up to format version %d.  You may need to upgrade your\n\
+notmuch CLI.\n",
+                notmuch_format_version, NOTMUCH_FORMAT_CUR);
+       exit (NOTMUCH_EXIT_FORMAT_TOO_NEW);
+    } else if (notmuch_format_version < NOTMUCH_FORMAT_MIN) {
+       fprintf (stderr, "\
+A caller requested output format version %d, which is no longer supported\n\
+by the notmuch CLI (it requires at least version %d).  You may need to\n\
+upgrade your notmuch front-end.\n",
+                notmuch_format_version, NOTMUCH_FORMAT_MIN);
+       exit (NOTMUCH_EXIT_FORMAT_TOO_OLD);
+    } else if (notmuch_format_version < NOTMUCH_FORMAT_MIN_ACTIVE) {
+       /* Warn about old version requests so compatibility issues are
+        * less likely when we drop support for a deprecated format
+        * versions. */
+       fprintf (stderr, "\
+A caller requested deprecated output format version %d, which may not\n\
+be supported in the future.\n", notmuch_format_version);
     }
+}
 
-    entry_length = offsetof (struct dirent, d_name) +
-       pathconf (path, _PC_NAME_MAX) + 1;
-    entry = malloc (entry_length);
-
-    while (1) {
-       err = readdir_r (dir, entry, &e);
-       if (err) {
-           fprintf (stderr, "Error reading directory: %s\n",
-                    strerror (errno));
-           free (entry);
-           return;
-       }
-
-       if (e == NULL)
-           break;
-
-       /* Ignore special directories to avoid infinite recursion.
-        * Also ignore the .notmuch directory.
-        */
-       /* XXX: Eventually we'll want more sophistication to let the
-        * user specify files to be ignored. */
-       if (strcmp (entry->d_name, ".") == 0 ||
-           strcmp (entry->d_name, "..") == 0 ||
-           strcmp (entry->d_name, ".notmuch") == 0)
-       {
-           continue;
-       }
-
-       next = g_strdup_printf ("%s/%s", path, entry->d_name);
-
-       stat (next, &st);
-
-       if (S_ISREG (st.st_mode)) {
-           *count = *count + 1;
-           if (*count % 1000 == 0) {
-               printf ("Found %d files so far.\r", *count);
-               fflush (stdout);
-           }
-       } else if (S_ISDIR (st.st_mode)) {
-           count_files (next, count);
-       }
-
-       free (next);
+static void
+exec_man (const char *page)
+{
+    if (execlp ("man", "man", page, (char *) NULL)) {
+       perror ("exec man");
+       exit (1);
     }
-
-    free (entry);
-
-    closedir (dir);
 }
 
-int
-setup_command (int argc, char *argv[])
+static int
+_help_for (const char *topic_name)
 {
-    notmuch_database_t *notmuch;
-    char *mail_directory, *default_path;
-    size_t line_size;
-    int count;
-    add_files_state_t add_files_state;
-    double elapsed;
-    struct timeval tv_now;
-
-    printf ("Welcome to notmuch!\n\n");
-
-    printf ("The goal of notmuch is to help you manage and search your collection of\n"
-           "email, and to efficiently keep up with the flow of email as it comes in.\n\n");
-
-    printf ("Notmuch needs to know the top-level directory of your email archive,\n"
-           "(where you already have mail stored and where messages will be delivered\n"
-           "in the future). This directory can contain any number of sub-directories\n"
-           "and primarily just files with indvidual email messages (eg. maildir or mh\n"
-           "archives are perfect). If there are other, non-email files (such as\n"
-           "indexes maintained by other email programs) then notmuch will do its\n"
-           "best to detect those and ignore them.\n\n");
-
-    printf ("Mail storage that uses mbox format, (where one mbox file contains many\n"
-           "messages), will not work with notmuch. If that's how your mail is currently\n"
-           "stored, we recommend you first convert it to maildir format with a utility\n"
-           "such as mb2md. In that case, press Control-C now and run notmuch again\n"
-           "once the conversion is complete.\n\n");
-
-
-    default_path = notmuch_database_default_path ();
-    printf ("Top-level mail directory [%s]: ", default_path);
-    fflush (stdout);
-
-    mail_directory = NULL;
-    getline (&mail_directory, &line_size, stdin);
-    printf ("\n");
-
-    if (mail_directory &&
-       mail_directory[strlen(mail_directory)-1] == '\n')
-    {
-       mail_directory[strlen(mail_directory)-1] = '\0';
-    }
+    command_t *command;
+    help_topic_t *topic;
+    unsigned int i;
 
-    if (mail_directory == NULL || strlen (mail_directory) == 0) {
-       if (mail_directory)
-           free (mail_directory);
-       mail_directory = default_path;
-    } else {
-       /* XXX: Instead of telling the user to use an environment
-        * variable here, we should really be writing out a configuration
-        * file and loading that on the next run. */
-       if (strcmp (mail_directory, default_path)) {
-           printf ("Note: Since you are not using the default path, you will want to set\n"
-                   "the NOTMUCH_BASE environment variable to %s so that\n"
-                   "future calls to notmuch commands will know where to find your mail.\n",
-                   mail_directory);
-           printf ("For example, if you are using bash for your shell, add:\n\n");
-           printf ("\texport NOTMUCH_BASE=%s\n\n", mail_directory);
-           printf ("to your ~/.bashrc file.\n\n");
-       }
-       free (default_path);
+    if (!topic_name) {
+       printf ("The notmuch mail system.\n\n");
+       usage (stdout);
+       return EXIT_SUCCESS;
     }
 
-    notmuch = notmuch_database_create (mail_directory);
-    if (notmuch == NULL) {
-       fprintf (stderr, "Failed to create new notmuch database at %s\n",
-                mail_directory);
-       free (mail_directory);
-       return 1;
+    if (strcmp (topic_name, "help") == 0) {
+       printf ("The notmuch help system.\n\n"
+               "\tNotmuch uses the man command to display help. In case\n"
+               "\tof difficulties check that MANPATH includes the pages\n"
+               "\tinstalled by notmuch.\n\n"
+               "\tTry \"notmuch help\" for a list of topics.\n");
+       return EXIT_SUCCESS;
     }
 
-    printf ("OK. Let's take a look at the mail we can find in the directory\n");
-    printf ("%s ...\n", mail_directory);
-
-    count = 0;
-    count_files (mail_directory, &count);
+    command = find_command (topic_name);
+    if (command) {
+       char *page = talloc_asprintf (NULL, "notmuch-%s", command->name);
+       exec_man (page);
+    }
 
-    printf ("Found %d total files. That's not much mail.\n\n", count);
+    for (i = 0; i < ARRAY_SIZE (help_topics); i++) {
+       topic = &help_topics[i];
+       if (strcmp (topic_name, topic->name) == 0) {
+           char *page = talloc_asprintf (NULL, "notmuch-%s", topic->name);
+           exec_man (page);
+       }
+    }
 
-    printf ("Next, we'll inspect the messages and create a database of threads:\n");
+    fprintf (stderr,
+            "\nSorry, %s is not a known command. There's not much I can do to help.\n\n",
+            topic_name);
+    return EXIT_FAILURE;
+}
 
-    add_files_state.total_messages = count;
-    add_files_state.count = 0;
-    gettimeofday (&add_files_state.tv_start, NULL);
+static int
+notmuch_help_command (unused (notmuch_config_t * config), int argc, char *argv[])
+{
+    int opt_index;
 
-    add_files (notmuch, mail_directory, &add_files_state);
+    opt_index = notmuch_minimal_options ("help", argc, argv);
+    if (opt_index < 0)
+       return EXIT_FAILURE;
 
-    gettimeofday (&tv_now, NULL);
-    elapsed = tv_elapsed (add_files_state.tv_start,
-                         tv_now);
-    printf ("Added %d total messages in ", add_files_state.count);
-    print_formatted_seconds (elapsed);
-    printf (" (%d messages/sec.).                 \n", (int) (add_files_state.count / elapsed));
+    /* skip at least subcommand argument */
+    argc-= opt_index;
+    argv+= opt_index;
 
-    notmuch_database_close (notmuch);
+    if (argc == 0) {
+       return _help_for (NULL);
+    }
 
-    free (mail_directory);
-    
-    return 0;
+    return _help_for (argv[0]);
 }
 
-int
-search_command (int argc, char *argv[])
+/* Handle the case of "notmuch" being invoked with no command
+ * argument. For now we just call notmuch_setup_command, but we plan
+ * to be more clever about this in the future.
+ */
+static int
+notmuch_command (notmuch_config_t *config,
+                unused(int argc), unused(char *argv[]))
 {
-    fprintf (stderr, "Error: search is not implemented yet.\n");
-    return 1;
-}
+    char *db_path;
+    struct stat st;
 
-int
-show_command (int argc, char *argv[])
-{
-    fprintf (stderr, "Error: show is not implemented yet.\n");
-    return 1;
+    /* If the user has never configured notmuch, then run
+     * notmuch_setup_command which will give a nice welcome message,
+     * and interactively guide the user through the configuration. */
+    if (notmuch_config_is_new (config))
+       return notmuch_setup_command (config, 0, NULL);
+
+    /* Notmuch is already configured, but is there a database? */
+    db_path = talloc_asprintf (config, "%s/%s",
+                              notmuch_config_get_database_path (config),
+                              ".notmuch");
+    if (stat (db_path, &st)) {
+       if (errno != ENOENT) {
+           fprintf (stderr, "Error looking for notmuch database at %s: %s\n",
+                    db_path, strerror (errno));
+           return EXIT_FAILURE;
+       }
+       printf ("Notmuch is configured, but there's not yet a database at\n\n\t%s\n\n",
+               db_path);
+       printf ("You probably want to run \"notmuch new\" now to create that database.\n\n"
+               "Note that the first run of \"notmuch new\" can take a very long time\n"
+               "and that the resulting database will use roughly the same amount of\n"
+               "storage space as the email being indexed.\n\n");
+       return EXIT_SUCCESS;
+    }
+
+    printf ("Notmuch is configured and appears to have a database. Excellent!\n\n"
+           "At this point you can start exploring the functionality of notmuch by\n"
+           "using commands such as:\n\n"
+           "\tnotmuch search tag:inbox\n\n"
+           "\tnotmuch search to:\"%s\"\n\n"
+           "\tnotmuch search from:\"%s\"\n\n"
+           "\tnotmuch search subject:\"my favorite things\"\n\n"
+           "See \"notmuch help search\" for more details.\n\n"
+           "You can also use \"notmuch show\" with any of the thread IDs resulting\n"
+           "from a search. Finally, you may want to explore using a more sophisticated\n"
+           "interface to notmuch such as the emacs interface implemented in notmuch.el\n"
+           "or any other interface described at http://notmuchmail.org\n\n"
+           "And don't forget to run \"notmuch new\" whenever new mail arrives.\n\n"
+           "Have fun, and may your inbox never have much mail.\n\n",
+           notmuch_config_get_user_name (config),
+           notmuch_config_get_user_primary_email (config));
+
+    return EXIT_SUCCESS;
 }
 
 int
-dump_command (int argc, char *argv[])
+main (int argc, char *argv[])
 {
-    FILE *output;
-    notmuch_database_t *notmuch = NULL;
-    notmuch_query_t *query;
-    notmuch_results_t *results;
-    notmuch_message_t *message;
-    notmuch_tags_t *tags;
-    int ret = 0;
-
-    if (argc) {
-       output = fopen (argv[0], "w");
-       if (output == NULL) {
-           fprintf (stderr, "Error opening %s for writing: %s\n",
-                    argv[1], strerror (errno));
-           ret = 1;
-           goto DONE;
-       }
-    } else {
-       output = stdout;
-    }
-
-    notmuch = notmuch_database_open (NULL);
-    if (notmuch == NULL) {
-       ret = 1;
-       goto DONE;
-    }
+    void *local;
+    char *talloc_report;
+    const char *command_name = NULL;
+    command_t *command;
+    char *config_file_name = NULL;
+    notmuch_config_t *config = NULL;
+    int opt_index;
+    int ret;
 
-    query = notmuch_query_create (notmuch, "");
-    if (query == NULL) {
-       fprintf (stderr, "Out of memory\n");
-       ret = 1;
-       goto DONE;
-    }
+    notmuch_opt_desc_t options[] = {
+       { NOTMUCH_OPT_STRING, &config_file_name, "config", 'c', 0 },
+       { NOTMUCH_OPT_INHERIT, (void *) &notmuch_shared_options, NULL, 0, 0 },
+       { 0, 0, 0, 0, 0 }
+    };
 
-    notmuch_query_set_sort (query, NOTMUCH_SORT_MESSAGE_ID);
+    talloc_enable_null_tracking ();
 
-    for (results = notmuch_query_search (query);
-        notmuch_results_has_more (results);
-        notmuch_results_advance (results))
-    {
-       message = notmuch_results_get (results);
+    local = talloc_new (NULL);
 
-       fprintf (output,
-                "%s (", notmuch_message_get_message_id (message));
+    g_mime_init (GMIME_ENABLE_RFC2047_WORKAROUNDS);
+#if !GLIB_CHECK_VERSION(2, 35, 1)
+    g_type_init ();
+#endif
 
-       for (tags = notmuch_message_get_tags (message);
-            notmuch_tags_has_more (tags);
-            notmuch_tags_advance (tags))
-       {
-           int first = 1;
+    /* Globally default to the current output format version. */
+    notmuch_format_version = NOTMUCH_FORMAT_CUR;
 
-           if (! first)
-               fprintf (output, " ");
+    opt_index = parse_arguments (argc, argv, options, 1);
+    if (opt_index < 0) {
+       ret = EXIT_FAILURE;
+       goto DONE;
+    }
 
-           fprintf (output, "%s", notmuch_tags_get (tags));
+    notmuch_process_shared_options (NULL);
 
-           first = 0;
-       }
+    if (opt_index < argc)
+       command_name = argv[opt_index];
 
-       fprintf (output, ")\n");
+    command = find_command (command_name);
+    if (!command) {
+       fprintf (stderr, "Error: Unknown command '%s' (see \"notmuch help\")\n",
+                command_name);
+       ret = EXIT_FAILURE;
+       goto DONE;
+    }
 
-       notmuch_message_destroy (message);
+    config = notmuch_config_open (local, config_file_name, command->create_config);
+    if (!config) {
+       ret = EXIT_FAILURE;
+       goto DONE;
     }
 
-    notmuch_query_destroy (query);
+    ret = (command->function)(config, argc - opt_index, argv + opt_index);
 
   DONE:
-    if (notmuch)
-       notmuch_database_close (notmuch);
-    if (output != stdout)
-       fclose (output);
-
-    return ret;
-}
-
-int
-restore_command (int argc, char *argv[])
-{
-    fprintf (stderr, "Error: restore is not implemented yet.\n");
-    return 1;
-}
-
-command_t commands[] = {
-    { "setup", setup_command,
-      "Interactively setup notmuch for first use.\n"
-      "\t\tInvoking notmuch with no command argument will run setup if\n"
-      "\t\tthe setup command has not previously been completed." },
-    { "search", search_command,
-      "<search-term> [...]\n\n"
-      "\t\tSearch for threads matching the given search terms.\n"
-      "\t\tOnce we actually implement search we'll document the\n"
-      "\t\tsyntax here." },
-    { "show", show_command,
-      "<thread-id>\n\n"
-      "\t\tShow the thread with the given thread ID (see 'search')." },
-    { "dump", dump_command,
-      "[<filename>]\n\n"
-      "\t\tCreate a plain-text dump of the tags for each message\n"
-      "\t\twriting to the given filename, if any, or to stdout.\n"
-      "\t\tThese tags are the only data in the notmuch database\n"
-      "\t\tthat can't be recreated from the messages themselves.\n"
-      "\t\tThe output of notmuch dump is therefore the only\n"
-      "\t\tcritical thing to backup (and much more friendly to\n"
-      "\t\tincremental backup than the native database files." },
-    { "restore", restore_command,
-      "<filename>\n\n"
-      "\t\tRestore the tags from the given dump file (see 'dump')." }
-};
-
-void
-usage (void)
-{
-    command_t *command;
-    int i;
-
-    fprintf (stderr, "Usage: notmuch <command> [args...]\n");
-    fprintf (stderr, "\n");
-    fprintf (stderr, "Where <command> and [args...] are as follows:\n");
-    fprintf (stderr, "\n");
-
-    for (i = 0; i < ARRAY_SIZE (commands); i++) {
-       command = &commands[i];
+    if (config)
+       notmuch_config_close (config);
 
-       fprintf (stderr, "\t%s\t%s\n\n", command->name, command->usage);
-    }
-}
-    
-int
-main (int argc, char *argv[])
-{
-    command_t *command;
-    int i;
-
-    if (argc == 1)
-       return setup_command (0, NULL);
-
-    for (i = 0; i < ARRAY_SIZE (commands); i++) {
-       command = &commands[i];
+    talloc_report = getenv ("NOTMUCH_TALLOC_REPORT");
+    if (talloc_report && strcmp (talloc_report, "") != 0) {
+       /* this relies on the previous call to
+        * talloc_enable_null_tracking
+        */
 
-       if (strcmp (argv[1], command->name) == 0)
-           return (command->function) (argc - 2, &argv[2]);
+       FILE *report = fopen (talloc_report, "w");
+       if (report) {
+           talloc_report_full (NULL, report);
+       } else {
+           ret = 1;
+           fprintf (stderr, "ERROR: unable to write talloc log. ");
+           perror (talloc_report);
+       }
     }
 
-    /* Don't complain about "help" being an unknown command when we're
-       about to provide exactly what's wanted anyway. */
-    if (strcmp (argv[1], "help") == 0 ||
-       strcmp (argv[1], "--help") == 0)
-    {
-       fprintf (stderr, "The notmuch mail system.\n\n");
-    } else {
-       fprintf (stderr, "Error: Unknown command '%s'\n\n", argv[1]);
-    }
-    usage ();
-    exit (1);
+    talloc_free (local);
 
-    return 0;
+    return ret;
 }