ruby: Add wrapper for notmuch_query_add_tag_exclude
[notmuch] / bindings / ruby / query.c
1 /* The Ruby interface to the notmuch mail library
2  *
3  * Copyright © 2010, 2011, 2012 Ali Polatel
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: Ali Polatel <alip@exherbo.org>
19  */
20
21 #include "defs.h"
22
23 /*
24  * call-seq: QUERY.destroy! => nil
25  *
26  * Destroys the query, freeing all resources allocated for it.
27  */
28 VALUE
29 notmuch_rb_query_destroy (VALUE self)
30 {
31     notmuch_query_t *query;
32
33     Data_Get_Notmuch_Query (self, query);
34
35     notmuch_query_destroy (query);
36     DATA_PTR (self) = NULL;
37
38     return Qnil;
39 }
40
41 /*
42  * call-seq: QUERY.sort => fixnum
43  *
44  * Get sort type of the +QUERY+
45  */
46 VALUE
47 notmuch_rb_query_get_sort (VALUE self)
48 {
49     notmuch_query_t *query;
50
51     Data_Get_Notmuch_Query (self, query);
52
53     return FIX2INT (notmuch_query_get_sort (query));
54 }
55
56 /*
57  * call-seq: QUERY.sort=(fixnum) => nil
58  *
59  * Set sort type of the +QUERY+
60  */
61 VALUE
62 notmuch_rb_query_set_sort (VALUE self, VALUE sortv)
63 {
64     notmuch_query_t *query;
65
66     Data_Get_Notmuch_Query (self, query);
67
68     if (!FIXNUM_P (sortv))
69         rb_raise (rb_eTypeError, "Not a Fixnum");
70
71     notmuch_query_set_sort (query, FIX2UINT (sortv));
72
73     return Qnil;
74 }
75
76 /*
77  * call-seq: QUERY.to_s => string
78  *
79  * Get query string of the +QUERY+
80  */
81 VALUE
82 notmuch_rb_query_get_string (VALUE self)
83 {
84     notmuch_query_t *query;
85
86     Data_Get_Notmuch_Query (self, query);
87
88     return rb_str_new2 (notmuch_query_get_query_string (query));
89 }
90
91 /*
92  * call-seq: QUERY.add_tag_exclude(tag) => nil
93  *
94  * Add a tag that will be excluded from the query results by default.
95  */
96 VALUE
97 notmuch_rb_query_add_tag_exclude (VALUE self, VALUE tagv)
98 {
99     notmuch_query_t *query;
100     const char *tag;
101
102     Data_Get_Notmuch_Query (self, query);
103     tag = RSTRING_PTR(tagv);
104
105     notmuch_query_add_tag_exclude(query, tag);
106     return Qnil;
107 }
108
109 /*
110  * call-seq: QUERY.search_threads => THREADS
111  *
112  * Search for threads
113  */
114 VALUE
115 notmuch_rb_query_search_threads (VALUE self)
116 {
117     notmuch_query_t *query;
118     notmuch_threads_t *threads;
119
120     Data_Get_Notmuch_Query (self, query);
121
122     threads = notmuch_query_search_threads (query);
123     if (!threads)
124         rb_raise (notmuch_rb_eMemoryError, "Out of memory");
125
126     return Data_Wrap_Struct (notmuch_rb_cThreads, NULL, NULL, threads);
127 }
128
129 /*
130  * call-seq: QUERY.search_messages => MESSAGES
131  *
132  * Search for messages
133  */
134 VALUE
135 notmuch_rb_query_search_messages (VALUE self)
136 {
137     notmuch_query_t *query;
138     notmuch_messages_t *messages;
139
140     Data_Get_Notmuch_Query (self, query);
141
142     messages = notmuch_query_search_messages (query);
143     if (!messages)
144         rb_raise (notmuch_rb_eMemoryError, "Out of memory");
145
146     return Data_Wrap_Struct (notmuch_rb_cMessages, NULL, NULL, messages);
147 }
148
149 /*
150  * call-seq: QUERY.count_messages => Fixnum
151  *
152  * Return an estimate of the number of messages matching a search
153  */
154 VALUE
155 notmuch_rb_query_count_messages (VALUE self)
156 {
157     notmuch_query_t *query;
158
159     Data_Get_Notmuch_Query (self, query);
160
161     /* Xapian exceptions are not handled properly.
162      * (function may return 0 after printing a message)
163      * Thus there is nothing we can do here...
164      */
165     return UINT2FIX(notmuch_query_count_messages(query));
166 }