1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
|
"""
This file is part of alot.
Alot is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.
Notmuch is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License
along with notmuch. If not, see <http://www.gnu.org/licenses/>.
Copyright (C) 2011 Patrick Totzke <patricktotzke@gmail.com>
"""
from notmuch import Database
from datetime import datetime
import logging
import email
class DBManager:
"""
keeps track of your index parameters, can create notmuch.Query
objects from its Database on demand and implements a bunch of
database specific functions.
"""
def __init__(self, path=None, ro=False):
self.ro = ro
self.path = path
def count_messages(self, querystring):
return self.query(querystring).count_messages()
def search_thread_ids(self, querystring):
threads = self.query(querystring).search_threads()
return [thread.get_thread_id() for thread in threads]
def find_message(self, mid, writeable=False):
db = Database(path=self.path)
if writeable:
query = self.query('id:' + mid, writeable=writeable)
#TODO raise exceptions here in 0<case msgcount>1
msg = query.search_messages().next()
else:
msg = db.find_message(mid)
return msg
def get_message(self, mid):
"""returns the message with the given id and wrapps it in a Message
:param mid: the message id of the message to look up
:type mid: str.
:returns: Message -- the message.
"""
return Message(self, self.find_message(mid))
def get_thread(self, tid, writeable=False):
query = self.query('thread:' + tid, writeable=writeable)
#TODO raise exceptions here in 0<case msgcount>1
return Thread(self, query.search_threads().next())
def get_all_tags(self):
mode = Database.MODE.READ_ONLY
db = Database(path=self.path, mode=mode)
return [tag for tag in db.get_all_tags()]
def query(self, querystring, writeable=False):
"""creates notmuch.Query objects on demand
:param querystring: The query string to use for the lookup
:type query: str.
:param writeable: Try to return a writeable Query object
:type state: bool.
:returns: notmuch.Query -- the query object.
"""
if writeable:
mode = Database.MODE.READ_WRITE
else:
mode = Database.MODE.READ_ONLY
db = Database(path=self.path, mode=mode)
return db.create_query(querystring)
class Thread:
def __init__(self, dbman, thread):
self.dbman = dbman
self.tid = thread.get_thread_id()
self.strrep = str(thread)
self.total_messages = thread.get_total_messages()
self.topmessages = [m.get_message_id() for m in thread.get_toplevel_messages()]
self.authors = thread.get_authors()
self.subject = thread.get_subject()
self.oldest = datetime.fromtimestamp(thread.get_oldest_date())
self.newest = datetime.fromtimestamp(thread.get_newest_date())
self.tags = set([str(tag) for tag in thread.get_tags()])
def get_thread_id(self):
return self.tid
def get_tags(self):
return list(self.tags)
def add_tags(self, tags):
tags = filter(lambda x: x not in self.tags, tags)
if tags:
query = self.dbman.query('thread:' + self.tid, writeable=True)
for msg in query.search_messages():
msg.freeze()
for tag in tags:
msg.add_tag(tag)
msg.thaw()
for tag in tags:
self.tags.add(tag)
def remove_tags(self, tags):
tags = filter(lambda x: x in self.tags, tags)
if tags:
query = self.dbman.query('thread:' + self.tid, writeable=True)
for msg in query.search_messages():
msg.freeze()
for tag in tags:
msg.remove_tag(tag)
msg.thaw()
for tag in tags:
self.tags.remove(tag)
def set_tags(self, tags):
query = self.dbman.query('thread:' + self.tid, writeable=True)
self.tags = set()
for msg in query.search_messages():
msg.freeze()
msg.remove_all_tags()
for tag in tags:
msg.add_tag(tag)
self.tags.add(tag)
msg.thaw()
def get_authors(self):
return self.authors
def get_subject(self):
return self.subject
def _build_messages(self, acc, msg):
M = Message(self.dbman,msg)
acc[M] = {}
r = msg.get_replies()
if r is not None:
for m in r:
self._build_messages(acc[M], m)
def get_messages(self):
query = self.dbman.query('thread:' + self.tid)
thread = query.search_threads().next()
messages = {}
for m in thread.get_toplevel_messages():
self._build_messages(messages, m)
return messages
def get_newest_date(self):
return self.newest
def get_oldest_date(self):
return self.oldest
def get_total_messages(self):
return self.total_messages
class Message:
def __init__(self, dbman, msg):
self.dbman = dbman
self.mid = msg.get_message_id()
self.strrep = str(msg)
self.email = None # will be read upon first use
self.filename = msg.get_filename()
self.tags = set([str(tag) for tag in msg.get_tags()])
def __str__(self):
return self.strrep
def get_replies(self):
#this doesn't work. see Note in doc -> more work here.
return [self.dbman.find_message(mid) for mid in self.replies]
def get_tags(self):
return list(self.tags)
def get_email(self):
if not self.email:
self.email = self.read_mail(self.filename)
return self.email
def read_mail(self, filename):
try:
f_mail = open(filename)
except EnvironmentError:
eml = email.message_from_string('Unable to open the file')
else:
eml = email.message_from_file(f_mail)
f_mail.close()
return eml
def add_tags(self, tags):
msg = self.dbman.find_message(self.mid)
msg.freeze()
for tag in tags:
msg.add_tag(tag)
self.tags.add(tag)
logging.debug('tag %s' % tags)
msg.thaw()
def remove_tags(self, tags):
msg = self.dbman.find_message(self.mid, writeable=True)
msg.freeze()
for tag in tags:
msg.remove_tag(tag)
try:
self.tags.remove(tag)
except KeyError:
pass # tag not in self.tags
logging.debug('untag %s' % tags)
msg.thaw()
|