1 /* The Ruby interface to the notmuch mail library
3 * Copyright © 2010, 2011 Ali Polatel
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 https://www.gnu.org/licenses/ .
18 * Author: Ali Polatel <alip@exherbo.org>
24 * call-seq: THREAD.destroy! => nil
26 * Destroys the thread, freeing all resources allocated for it.
29 notmuch_rb_thread_destroy (VALUE self)
31 notmuch_thread_t *thread;
33 Data_Get_Notmuch_Thread (self, thread);
35 notmuch_thread_destroy (thread);
36 DATA_PTR (self) = NULL;
42 * call-seq: THREAD.thread_id => String
44 * Returns the thread id
47 notmuch_rb_thread_get_thread_id (VALUE self)
50 notmuch_thread_t *thread;
52 Data_Get_Notmuch_Thread (self, thread);
54 tid = notmuch_thread_get_thread_id (thread);
56 return rb_str_new2 (tid);
60 * call-seq: THREAD.total_messages => fixnum
62 * Returns the number of total messages
65 notmuch_rb_thread_get_total_messages (VALUE self)
67 notmuch_thread_t *thread;
69 Data_Get_Notmuch_Thread (self, thread);
71 return INT2FIX (notmuch_thread_get_total_messages (thread));
75 * call-seq: THREAD.toplevel_messages => MESSAGES
77 * Get a Notmuch::Messages iterator for the top level messages in thread.
80 notmuch_rb_thread_get_toplevel_messages (VALUE self)
82 notmuch_messages_t *messages;
83 notmuch_thread_t *thread;
85 Data_Get_Notmuch_Thread (self, thread);
87 messages = notmuch_thread_get_toplevel_messages (thread);
89 rb_raise (notmuch_rb_eMemoryError, "Out of memory");
91 return Data_Wrap_Struct (notmuch_rb_cMessages, NULL, NULL, messages);
95 * call-seq: THREAD.messages => MESSAGES
97 * Get a Notmuch::Messages iterator for the all messages in thread.
100 notmuch_rb_thread_get_messages (VALUE self)
102 notmuch_messages_t *messages;
103 notmuch_thread_t *thread;
105 Data_Get_Notmuch_Thread (self, thread);
107 messages = notmuch_thread_get_messages (thread);
109 rb_raise (notmuch_rb_eMemoryError, "Out of memory");
111 return Data_Wrap_Struct (notmuch_rb_cMessages, NULL, NULL, messages);
115 * call-seq: THREAD.matched_messages => fixnum
117 * Get the number of messages in thread that matched the search
120 notmuch_rb_thread_get_matched_messages (VALUE self)
122 notmuch_thread_t *thread;
124 Data_Get_Notmuch_Thread (self, thread);
126 return INT2FIX (notmuch_thread_get_matched_messages (thread));
130 * call-seq: THREAD.authors => String
132 * Get a comma-separated list of the names of the authors.
135 notmuch_rb_thread_get_authors (VALUE self)
138 notmuch_thread_t *thread;
140 Data_Get_Notmuch_Thread (self, thread);
142 authors = notmuch_thread_get_authors (thread);
144 return rb_str_new2 (authors);
148 * call-seq: THREAD.subject => String
150 * Returns the subject of the thread
153 notmuch_rb_thread_get_subject (VALUE self)
156 notmuch_thread_t *thread;
158 Data_Get_Notmuch_Thread (self, thread);
160 subject = notmuch_thread_get_subject (thread);
162 return rb_str_new2 (subject);
166 * call-seq: THREAD.oldest_date => Fixnum
168 * Get the date of the oldest message in thread.
171 notmuch_rb_thread_get_oldest_date (VALUE self)
173 notmuch_thread_t *thread;
175 Data_Get_Notmuch_Thread (self, thread);
177 return UINT2NUM (notmuch_thread_get_oldest_date (thread));
181 * call-seq: THREAD.newest_date => fixnum
183 * Get the date of the newest message in thread.
186 notmuch_rb_thread_get_newest_date (VALUE self)
188 notmuch_thread_t *thread;
190 Data_Get_Notmuch_Thread (self, thread);
192 return UINT2NUM (notmuch_thread_get_newest_date (thread));
196 * call-seq: THREAD.tags => TAGS
198 * Get a Notmuch::Tags iterator for the tags of the thread
201 notmuch_rb_thread_get_tags (VALUE self)
203 notmuch_thread_t *thread;
204 notmuch_tags_t *tags;
206 Data_Get_Notmuch_Thread (self, thread);
208 tags = notmuch_thread_get_tags (thread);
210 rb_raise (notmuch_rb_eMemoryError, "Out of memory");
212 return Data_Wrap_Struct (notmuch_rb_cTags, NULL, NULL, tags);