05feed3e97a461f7201ca0b2d0664cc5e3743586
[notmuch] / notmuch-tag.c
1 /* notmuch - Not much of an email program, (just index and search)
2  *
3  * Copyright © 2009 Carl Worth
4  *
5  * This program is free software: you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation, either version 3 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program.  If not, see http://www.gnu.org/licenses/ .
17  *
18  * Author: Carl Worth <cworth@cworth.org>
19  */
20
21 #include "notmuch-client.h"
22
23 static volatile sig_atomic_t interrupted;
24
25 static void
26 handle_sigint (unused (int sig))
27 {
28     static char msg[] = "Stopping...         \n";
29
30     /* This write is "opportunistic", so it's okay to ignore the
31      * result.  It is not required for correctness, and if it does
32      * fail or produce a short write, we want to get out of the signal
33      * handler as quickly as possible, not retry it. */
34     IGNORE_RESULT (write (2, msg, sizeof(msg)-1));
35     interrupted = 1;
36 }
37
38 static char *
39 _escape_tag (char *buf, const char *tag)
40 {
41     const char *in = tag;
42     char *out = buf;
43     /* Boolean terms surrounded by double quotes can contain any
44      * character.  Double quotes are quoted by doubling them. */
45     *out++ = '"';
46     while (*in) {
47         if (*in == '"')
48             *out++ = '"';
49         *out++ = *in++;
50     }
51     *out++ = '"';
52     *out = 0;
53     return buf;
54 }
55
56 typedef struct {
57     const char *tag;
58     notmuch_bool_t remove;
59 } tag_operation_t;
60
61 static char *
62 _optimize_tag_query (void *ctx, const char *orig_query_string,
63                      const tag_operation_t *tag_ops)
64 {
65     /* This is subtler than it looks.  Xapian ignores the '-' operator
66      * at the beginning both queries and parenthesized groups and,
67      * furthermore, the presence of a '-' operator at the beginning of
68      * a group can inhibit parsing of the previous operator.  Hence,
69      * the user-provided query MUST appear first, but it is safe to
70      * parenthesize and the exclusion part of the query must not use
71      * the '-' operator (though the NOT operator is fine). */
72
73     char *escaped, *query_string;
74     const char *join = "";
75     int i;
76     unsigned int max_tag_len = 0;
77
78     /* Don't optimize if there are no tag changes. */
79     if (tag_ops[0].tag == NULL)
80         return talloc_strdup (ctx, orig_query_string);
81
82     /* Allocate a buffer for escaping tags.  This is large enough to
83      * hold a fully escaped tag with every character doubled plus
84      * enclosing quotes and a NUL. */
85     for (i = 0; tag_ops[i].tag; i++)
86         if (strlen (tag_ops[i].tag) > max_tag_len)
87             max_tag_len = strlen (tag_ops[i].tag);
88     escaped = talloc_array(ctx, char, max_tag_len * 2 + 3);
89     if (!escaped)
90         return NULL;
91
92     /* Build the new query string */
93     if (strcmp (orig_query_string, "*") == 0)
94         query_string = talloc_strdup (ctx, "(");
95     else
96         query_string = talloc_asprintf (ctx, "( %s ) and (", orig_query_string);
97
98     for (i = 0; tag_ops[i].tag && query_string; i++) {
99         query_string = talloc_asprintf_append_buffer (
100             query_string, "%s%stag:%s", join,
101             tag_ops[i].remove ? "" : "not ",
102             _escape_tag (escaped, tag_ops[i].tag));
103         join = " or ";
104     }
105
106     if (query_string)
107         query_string = talloc_strdup_append_buffer (query_string, ")");
108
109     talloc_free (escaped);
110     return query_string;
111 }
112
113 /* Tag messages matching 'query_string' according to 'tag_ops', which
114  * must be an array of tagging operations terminated with an empty
115  * element. */
116 static int
117 tag_query (void *ctx, notmuch_database_t *notmuch, const char *query_string,
118            tag_operation_t *tag_ops, notmuch_bool_t synchronize_flags)
119 {
120     notmuch_query_t *query;
121     notmuch_messages_t *messages;
122     notmuch_message_t *message;
123     int i;
124
125     /* Optimize the query so it excludes messages that already have
126      * the specified set of tags. */
127     query_string = _optimize_tag_query (ctx, query_string, tag_ops);
128     if (query_string == NULL) {
129         fprintf (stderr, "Out of memory.\n");
130         return 1;
131     }
132
133     query = notmuch_query_create (notmuch, query_string);
134     if (query == NULL) {
135         fprintf (stderr, "Out of memory.\n");
136         return 1;
137     }
138
139     /* tagging is not interested in any special sort order */
140     notmuch_query_set_sort (query, NOTMUCH_SORT_UNSORTED);
141
142     for (messages = notmuch_query_search_messages (query);
143          notmuch_messages_valid (messages) && !interrupted;
144          notmuch_messages_move_to_next (messages))
145     {
146         message = notmuch_messages_get (messages);
147
148         notmuch_message_freeze (message);
149
150         for (i = 0; tag_ops[i].tag; i++) {
151             if (tag_ops[i].remove)
152                 notmuch_message_remove_tag (message, tag_ops[i].tag);
153             else
154                 notmuch_message_add_tag (message, tag_ops[i].tag);
155         }
156
157         notmuch_message_thaw (message);
158
159         if (synchronize_flags)
160             notmuch_message_tags_to_maildir_flags (message);
161
162         notmuch_message_destroy (message);
163     }
164
165     notmuch_query_destroy (query);
166
167     return interrupted;
168 }
169
170 int
171 notmuch_tag_command (void *ctx, int argc, char *argv[])
172 {
173     tag_operation_t *tag_ops;
174     int tag_ops_count = 0;
175     char *query_string;
176     notmuch_config_t *config;
177     notmuch_database_t *notmuch;
178     struct sigaction action;
179     notmuch_bool_t synchronize_flags;
180     int i;
181     int ret;
182
183     /* Setup our handler for SIGINT */
184     memset (&action, 0, sizeof (struct sigaction));
185     action.sa_handler = handle_sigint;
186     sigemptyset (&action.sa_mask);
187     action.sa_flags = SA_RESTART;
188     sigaction (SIGINT, &action, NULL);
189
190     argc--; argv++; /* skip subcommand argument */
191
192     /* Array of tagging operations (add or remove), terminated with an
193      * empty element. */
194     tag_ops = talloc_array (ctx, tag_operation_t, argc + 1);
195     if (tag_ops == NULL) {
196         fprintf (stderr, "Out of memory.\n");
197         return 1;
198     }
199
200     for (i = 0; i < argc; i++) {
201         if (strcmp (argv[i], "--") == 0) {
202             i++;
203             break;
204         }
205         if (argv[i][0] == '+' || argv[i][0] == '-') {
206             tag_ops[tag_ops_count].tag = argv[i] + 1;
207             tag_ops[tag_ops_count].remove = (argv[i][0] == '-');
208             tag_ops_count++;
209         } else {
210             break;
211         }
212     }
213
214     tag_ops[tag_ops_count].tag = NULL;
215
216     if (tag_ops_count == 0) {
217         fprintf (stderr, "Error: 'notmuch tag' requires at least one tag to add or remove.\n");
218         return 1;
219     }
220
221     query_string = query_string_from_args (ctx, argc - i, &argv[i]);
222
223     if (*query_string == '\0') {
224         fprintf (stderr, "Error: notmuch tag requires at least one search term.\n");
225         return 1;
226     }
227
228     config = notmuch_config_open (ctx, NULL, NULL);
229     if (config == NULL)
230         return 1;
231
232     notmuch = notmuch_database_open (notmuch_config_get_database_path (config),
233                                      NOTMUCH_DATABASE_MODE_READ_WRITE);
234     if (notmuch == NULL)
235         return 1;
236
237     synchronize_flags = notmuch_config_get_maildir_synchronize_flags (config);
238
239     ret = tag_query (ctx, notmuch, query_string, tag_ops, synchronize_flags);
240
241     notmuch_database_close (notmuch);
242
243     return ret;
244 }