2 * Claws Mail -- a GTK+ based, lightweight, and fast e-mail client
3 * Copyright (C) 2012 the Claws Mail team
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.
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.
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/>.
22 # include "claws-features.h"
25 #include "advsearch.h"
31 #include "matcher_parser.h"
33 #include "prefs_common.h"
35 struct _AdvancedSearch {
37 AdvancedSearchType type;
41 MatcherList *predicate;
43 gboolean search_aborted;
46 gboolean (*cb)(gpointer data, guint at, guint matched, guint total);
50 void (*cb)(gpointer data);
55 void advsearch_set_on_progress_cb(AdvancedSearch *search, gboolean (*cb)(gpointer, guint, guint, guint), gpointer data)
57 search->on_progress_cb.cb = cb;
58 search->on_progress_cb.data = data;
61 void advsearch_set_on_error_cb(AdvancedSearch* search, void (*cb)(gpointer data), gpointer data)
63 search->on_error_cb.cb = cb;
64 search->on_error_cb.data = data;
67 static void prepare_matcher(AdvancedSearch *search);
68 static gboolean search_impl(MsgInfoList **messages, AdvancedSearch* search,
69 FolderItem* folderItem, gboolean recursive);
71 // --------------------------
73 AdvancedSearch* advsearch_new()
75 AdvancedSearch *result;
77 result = g_new0(AdvancedSearch, 1);
82 void advsearch_free(AdvancedSearch *search)
84 if (search->predicate != NULL)
85 matcherlist_free(search->predicate);
87 g_free(search->request.matchstring);
91 void advsearch_set(AdvancedSearch *search, AdvancedSearchType type, const gchar *matchstring)
93 cm_return_if_fail(search != NULL);
95 search->request.type = type;
97 g_free(search->request.matchstring);
98 search->request.matchstring = g_strdup(matchstring);
100 prepare_matcher(search);
103 gboolean advsearch_is_fast(AdvancedSearch *search)
105 cm_return_val_if_fail(search != NULL, FALSE);
107 return search->is_fast;
110 gboolean advsearch_has_proper_predicate(AdvancedSearch *search)
112 cm_return_val_if_fail(search != NULL, FALSE);
114 return search->predicate != NULL;
117 gboolean advsearch_search_msgs_in_folders(AdvancedSearch* search, MsgInfoList **messages,
118 FolderItem* folderItem, gboolean recursive)
120 if (search == NULL || search->predicate == NULL)
123 search->search_aborted = FALSE;
124 return search_impl(messages, search, folderItem, recursive);
127 void advsearch_abort(AdvancedSearch *search)
129 search->search_aborted = TRUE;
132 gchar *advsearch_expand_search_string(const gchar *search_string)
135 gchar term_char, save_char;
136 gchar *cmd_start, *cmd_end;
138 gchar *returnstr = NULL;
140 gboolean casesens, dontmatch, regex;
141 /* list of allowed pattern abbreviations */
143 gchar *abbreviated; /* abbreviation */
144 gchar *command; /* actual matcher command */
145 gint numparams; /* number of params for cmd */
146 gboolean qualifier; /* do we append stringmatch operations */
147 gboolean quotes; /* do we need quotes */
150 { "a", "all", 0, FALSE, FALSE },
151 { "ag", "age_greater", 1, FALSE, FALSE },
152 { "al", "age_lower", 1, FALSE, FALSE },
153 { "b", "body_part", 1, TRUE, TRUE },
154 { "B", "message", 1, TRUE, TRUE },
155 { "c", "cc", 1, TRUE, TRUE },
156 { "C", "to_or_cc", 1, TRUE, TRUE },
157 { "D", "deleted", 0, FALSE, FALSE },
158 { "e", "header \"Sender\"", 1, TRUE, TRUE },
159 { "E", "execute", 1, FALSE, TRUE },
160 { "f", "from", 1, TRUE, TRUE },
161 { "F", "forwarded", 0, FALSE, FALSE },
162 { "h", "headers_part", 1, TRUE, TRUE },
163 { "ha", "has_attachments", 0, FALSE, FALSE },
164 { "i", "header \"Message-ID\"", 1, TRUE, TRUE },
165 { "I", "inreplyto", 1, TRUE, TRUE },
166 { "k", "colorlabel", 1, FALSE, FALSE },
167 { "L", "locked", 0, FALSE, FALSE },
168 { "n", "newsgroups", 1, TRUE, TRUE },
169 { "N", "new", 0, FALSE, FALSE },
170 { "O", "~new", 0, FALSE, FALSE },
171 { "r", "replied", 0, FALSE, FALSE },
172 { "R", "~unread", 0, FALSE, FALSE },
173 { "s", "subject", 1, TRUE, TRUE },
174 { "se", "score_equal", 1, FALSE, FALSE },
175 { "sg", "score_greater", 1, FALSE, FALSE },
176 { "sl", "score_lower", 1, FALSE, FALSE },
177 { "Se", "size_equal", 1, FALSE, FALSE },
178 { "Sg", "size_greater", 1, FALSE, FALSE },
179 { "Ss", "size_smaller", 1, FALSE, FALSE },
180 { "t", "to", 1, TRUE, TRUE },
181 { "tg", "tag", 1, TRUE, TRUE },
182 { "T", "marked", 0, FALSE, FALSE },
183 { "U", "unread", 0, FALSE, FALSE },
184 { "x", "header \"References\"", 1, TRUE, TRUE },
185 { "X", "test", 1, FALSE, FALSE },
186 { "y", "header \"X-Label\"", 1, TRUE, TRUE },
187 { "&", "&", 0, FALSE, FALSE },
188 { "|", "|", 0, FALSE, FALSE },
189 { "p", "partial", 0, FALSE, FALSE },
190 { NULL, NULL, 0, FALSE, FALSE }
193 if (search_string == NULL)
196 copy_str = g_strdup(search_string);
198 matcherstr = g_string_sized_new(16);
199 cmd_start = copy_str;
200 while (cmd_start && *cmd_start) {
201 /* skip all white spaces */
202 while (*cmd_start && isspace((guchar)*cmd_start))
206 /* extract a command */
207 while (*cmd_end && !isspace((guchar)*cmd_end))
211 save_char = *cmd_end;
218 /* ~ and ! mean logical NOT */
219 if (*cmd_start == '~' || *cmd_start == '!')
224 /* % means case sensitive match */
225 if (*cmd_start == '%')
230 /* # means regex match */
231 if (*cmd_start == '#') {
236 /* find matching abbreviation */
237 for (i = 0; cmds[i].command; i++) {
238 if (!strcmp(cmd_start, cmds[i].abbreviated)) {
239 /* restore character */
240 *cmd_end = save_char;
243 if (matcherstr->len > 0) {
244 g_string_append(matcherstr, " ");
247 g_string_append(matcherstr, "~");
248 g_string_append(matcherstr, cmds[i].command);
249 g_string_append(matcherstr, " ");
251 /* stop if no params required */
252 if (cmds[i].numparams == 0)
255 /* extract a parameter, allow quotes */
256 while (*cmd_end && isspace((guchar)*cmd_end))
260 if (*cmd_start == '"') {
267 /* extract actual parameter */
268 while ((*cmd_end) && (*cmd_end != term_char))
274 save_char = *cmd_end;
277 if (cmds[i].qualifier) {
279 g_string_append(matcherstr, regex ? "regexp " : "match ");
281 g_string_append(matcherstr, regex ? "regexpcase " : "matchcase ");
284 /* do we need to add quotes ? */
285 if (cmds[i].quotes && term_char != '"')
286 g_string_append(matcherstr, "\"");
288 /* copy actual parameter */
289 g_string_append(matcherstr, cmd_start);
291 /* do we need to add quotes ? */
292 if (cmds[i].quotes && term_char != '"')
293 g_string_append(matcherstr, "\"");
295 /* restore original character */
296 *cmd_end = save_char;
309 /* return search string if no match is found to allow
310 all available filtering expressions in advanced search */
311 if (matcherstr->len > 0) returnstr = matcherstr->str;
312 else returnstr = g_strdup(search_string);
313 g_string_free(matcherstr, FALSE);
317 static void prepare_matcher_extended(AdvancedSearch *search)
319 gchar *newstr = advsearch_expand_search_string(search->request.matchstring);
321 if (newstr && newstr[0] != '\0') {
322 search->predicate = matcher_parser_get_cond(newstr, &search->is_fast);
327 #define debug_matcher_list(prefix, list) \
329 gchar *str = list ? matcherlist_to_string(list) : g_strdup("(NULL)"); \
331 debug_print("%s: %s\n", prefix, str); \
336 static void prepare_matcher_tag(AdvancedSearch *search)
338 gchar **words = search->request.matchstring
339 ? g_strsplit(search->request.matchstring, " ", -1)
343 if (search->predicate == NULL) {
344 search->predicate = g_new0(MatcherList, 1);
345 search->predicate->bool_and = FALSE;
346 search->is_fast = TRUE;
349 while (words && words[i] && *words[i]) {
350 MatcherProp *matcher;
352 g_strstrip(words[i]);
354 matcher = matcherprop_new(MATCHCRITERIA_TAG, NULL,
355 MATCHTYPE_MATCHCASE, words[i], 0);
357 search->predicate->matchers = g_slist_prepend(search->predicate->matchers, matcher);
364 static void prepare_matcher_header(AdvancedSearch *search, gint match_header)
366 MatcherProp *matcher;
368 if (search->predicate == NULL) {
369 search->predicate = g_new0(MatcherList, 1);
370 search->predicate->bool_and = FALSE;
371 search->is_fast = TRUE;
374 matcher = matcherprop_new(match_header, NULL, MATCHTYPE_MATCHCASE,
375 search->request.matchstring, 0);
377 search->predicate->matchers = g_slist_prepend(search->predicate->matchers, matcher);
380 static void prepare_matcher_mixed(AdvancedSearch *search)
382 prepare_matcher_tag(search);
383 debug_matcher_list("tag matcher list", search->predicate);
385 /* we want an OR search */
386 if (search->predicate)
387 search->predicate->bool_and = FALSE;
389 prepare_matcher_header(search, MATCHCRITERIA_SUBJECT);
390 debug_matcher_list("tag + subject matcher list", search->predicate);
391 prepare_matcher_header(search, MATCHCRITERIA_FROM);
392 debug_matcher_list("tag + subject + from matcher list", search->predicate);
393 prepare_matcher_header(search, MATCHCRITERIA_TO);
394 debug_matcher_list("tag + subject + from + to matcher list", search->predicate);
397 static void prepare_matcher(AdvancedSearch *search)
399 const gchar *search_string;
401 cm_return_if_fail(search != NULL);
403 if (search->predicate) {
404 matcherlist_free(search->predicate);
405 search->predicate = NULL;
408 search_string = search->request.matchstring;
410 if (search_string == NULL || search_string[0] == '\0')
413 switch (search->request.type) {
414 case ADVANCED_SEARCH_SUBJECT:
415 prepare_matcher_header(search, MATCHCRITERIA_SUBJECT);
416 debug_matcher_list("subject search", search->predicate);
419 case ADVANCED_SEARCH_FROM:
420 prepare_matcher_header(search, MATCHCRITERIA_FROM);
421 debug_matcher_list("from search", search->predicate);
424 case ADVANCED_SEARCH_TO:
425 prepare_matcher_header(search, MATCHCRITERIA_TO);
426 debug_matcher_list("to search", search->predicate);
429 case ADVANCED_SEARCH_TAG:
430 prepare_matcher_tag(search);
431 debug_matcher_list("tag search", search->predicate);
434 case ADVANCED_SEARCH_MIXED:
435 prepare_matcher_mixed(search);
436 debug_matcher_list("mixed search", search->predicate);
439 case ADVANCED_SEARCH_EXTENDED:
440 prepare_matcher_extended(search);
441 debug_matcher_list("extended search", search->predicate);
445 debug_print("unknown search type (%d)\n", search->request.type);
450 static gboolean search_progress_notify_cb(gpointer data, gboolean on_server, guint at,
451 guint matched, guint total)
453 AdvancedSearch *search = (AdvancedSearch*) data;
455 if (search->search_aborted)
458 if (on_server || search->on_progress_cb.cb == NULL)
461 return search->on_progress_cb.cb(search->on_progress_cb.data, at, matched, total);
464 static gboolean search_filter_folder(MsgNumberList **msgnums, AdvancedSearch *search,
465 FolderItem *folderItem, gboolean onServer)
468 gboolean tried_server = onServer;
470 matched = folder_item_search_msgs(folderItem->folder,
475 search_progress_notify_cb,
479 if (search->on_error_cb.cb != NULL)
480 search->on_error_cb.cb(search->on_error_cb.data);
484 if (folderItem->folder->klass->supports_server_search && tried_server && !onServer) {
485 return search_filter_folder(msgnums, search, folderItem, onServer);
491 static gboolean search_impl(MsgInfoList **messages, AdvancedSearch* search,
492 FolderItem* folderItem, gboolean recursive)
495 if (!search_impl(messages, search, folderItem, FALSE))
498 if (folderItem->node->children != NULL && !search->search_aborted) {
500 for (node = folderItem->node->children; node != NULL; node = node->next) {
501 FolderItem *cur = FOLDER_ITEM(node->data);
502 debug_print("in: %s\n", cur->path);
503 if (!search_impl(messages, search, cur, TRUE))
507 } else if (!folderItem->no_select) {
508 MsgNumberList *msgnums = NULL;
510 MsgInfoList *msgs = NULL;
511 gboolean can_search_on_server = folderItem->folder->klass->supports_server_search;
513 if (!search_filter_folder(&msgnums, search, folderItem,
514 can_search_on_server)) {
515 g_slist_free(msgnums);
519 for (cur = msgnums; cur != NULL; cur = cur->next) {
520 MsgInfo *msg = folder_item_get_msginfo(folderItem, GPOINTER_TO_UINT(cur->data));
522 msgs = g_slist_prepend(msgs, msg);
525 while (msgs != NULL) {
526 MsgInfoList *front = msgs;
530 front->next = *messages;
534 g_slist_free(msgnums);