3 # Patchwork - automated patch tracking system
4 # Copyright (C) 2008 Jeremy Kerr <jk@ozlabs.org>
6 # This file is part of the Patchwork package.
8 # Patchwork is free software; you can redistribute it and/or modify
9 # it under the terms of the GNU General Public License as published by
10 # the Free Software Foundation; either version 2 of the License, or
11 # (at your option) any later version.
13 # Patchwork is distributed in the hope that it will be useful,
14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 # GNU General Public License for more details.
18 # You should have received a copy of the GNU General Public License
19 # along with Patchwork; if not, write to the Free Software
20 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
27 from email import message_from_file
29 from email.header import Header, decode_header
30 from email.utils import parsedate_tz, mktime_tz
32 # Python 2.4 compatibility
33 from email.Header import Header, decode_header
34 from email.Utils import parsedate_tz, mktime_tz
36 from patchwork.parser import parse_patch
37 from patchwork.models import Patch, Project, Person, Comment
39 list_id_headers = ['List-ID', 'X-Mailing-List', 'X-list']
41 whitespace_re = re.compile('\s+')
42 def normalise_space(str):
43 return whitespace_re.sub(' ', str).strip()
45 def clean_header(header):
46 """ Decode (possibly non-ascii) headers """
49 (frag_str, frag_encoding) = fragment
51 return frag_str.decode(frag_encoding)
52 return frag_str.decode()
54 fragments = map(decode, decode_header(header))
56 return normalise_space(u' '.join(fragments))
58 def find_project(mail):
60 listid_res = [re.compile('.*<([^>]+)>.*', re.S),
61 re.compile('^([\S]+)$', re.S)]
63 for header in list_id_headers:
66 for listid_re in listid_res:
67 match = listid_re.match(mail.get(header))
74 listid = match.group(1)
77 project = Project.objects.get(listid = listid)
84 def find_author(mail):
86 from_header = clean_header(mail.get('From'))
87 (name, email) = (None, None)
89 # tuple of (regex, fn)
90 # - where fn returns a (name, email) tuple from the match groups resulting
91 # from re.match().groups()
93 # for "Firstname Lastname" <example@example.com> style addresses
94 (re.compile('"?(.*?)"?\s*<([^>]+)>'), (lambda g: (g[0], g[1]))),
96 # for example@example.com (Firstname Lastname) style addresses
97 (re.compile('"?(.*?)"?\s*\(([^\)]+)\)'), (lambda g: (g[1], g[0]))),
100 (re.compile('(.*)'), (lambda g: (None, g[0]))),
103 for regex, fn in from_res:
104 match = regex.match(from_header)
106 (name, email) = fn(match.groups())
110 raise Exception("Could not parse From: header")
112 email = email.strip()
119 person = Person.objects.get(email__iexact = email)
120 except Person.DoesNotExist:
121 person = Person(name = name, email = email)
124 return (person, new_person)
127 t = parsedate_tz(mail.get('Date', ''))
129 return datetime.datetime.utcnow()
130 return datetime.datetime.utcfromtimestamp(mktime_tz(t))
132 def mail_headers(mail):
133 return reduce(operator.__concat__,
134 ['%s: %s\n' % (k, Header(v, header_name = k, \
135 continuation_ws = '\t').encode()) \
136 for (k, v) in mail.items()])
138 def find_pull_request(content):
139 git_re = re.compile('^The following changes since commit .*' +
140 '^are available in the git repository at:\n'
141 '^\s*(git://[^\n]+)$',
142 re.DOTALL | re.MULTILINE)
143 match = git_re.search(content)
145 return match.group(1)
148 def find_content(project, mail):
153 for part in mail.walk():
154 if part.get_content_maintype() != 'text':
157 payload = part.get_payload(decode=True)
158 charset = part.get_content_charset()
159 subtype = part.get_content_subtype()
161 # if we don't have a charset, assume utf-8
165 if not isinstance(payload, unicode):
166 payload = unicode(payload, charset)
168 if subtype in ['x-patch', 'x-diff']:
171 elif subtype == 'plain':
175 (patchbuf, c) = parse_patch(payload)
178 pullurl = find_pull_request(payload)
181 commentbuf += c.strip() + '\n'
188 name = clean_subject(mail.get('Subject'), [project.linkname])
189 patch = Patch(name = name, content = patchbuf,
190 date = mail_date(mail), headers = mail_headers(mail))
193 name = clean_subject(mail.get('Subject'), [project.linkname])
194 patch = Patch(name = name, pull_url = pullurl,
195 date = mail_date(mail), headers = mail_headers(mail))
201 cpatch = find_patch_for_comment(project, mail)
204 comment = Comment(patch = cpatch, date = mail_date(mail),
205 content = clean_content(commentbuf),
206 headers = mail_headers(mail))
208 return (patch, comment)
210 def find_patch_for_comment(project, mail):
211 # construct a list of possible reply message ids
213 if 'In-Reply-To' in mail:
214 refs.append(mail.get('In-Reply-To'))
216 if 'References' in mail:
217 rs = mail.get('References').split()
226 # first, check for a direct reply
228 patch = Patch.objects.get(project = project, msgid = ref)
230 except Patch.DoesNotExist:
233 # see if we have comments that refer to a patch
235 comment = Comment.objects.get(patch__project = project, msgid = ref)
237 except Comment.DoesNotExist:
243 split_re = re.compile('[,\s]+')
245 def split_prefixes(prefix):
246 """ Turn a prefix string into a list of prefix tokens
248 >>> split_prefixes('PATCH')
250 >>> split_prefixes('PATCH,RFC')
252 >>> split_prefixes('')
254 >>> split_prefixes('PATCH,')
256 >>> split_prefixes('PATCH ')
258 >>> split_prefixes('PATCH,RFC')
260 >>> split_prefixes('PATCH 1/2')
263 matches = split_re.split(prefix)
264 return [ s for s in matches if s != '' ]
266 re_re = re.compile('^(re|fwd?)[:\s]\s*', re.I)
267 prefix_re = re.compile('^\[([^\]]*)\]\s*(.*)$')
269 def clean_subject(subject, drop_prefixes = None):
270 """ Clean a Subject: header from an incoming patch.
272 Removes Re: and Fwd: strings, as well as [PATCH]-style prefixes. By
273 default, only [PATCH] is removed, and we keep any other bracketed data
274 in the subject. If drop_prefixes is provided, remove those too,
275 comparing case-insensitively.
277 >>> clean_subject('meep')
279 >>> clean_subject('Re: meep')
281 >>> clean_subject('[PATCH] meep')
283 >>> clean_subject('[PATCH] meep \\n meep')
285 >>> clean_subject('[PATCH RFC] meep')
287 >>> clean_subject('[PATCH,RFC] meep')
289 >>> clean_subject('[PATCH,1/2] meep')
291 >>> clean_subject('[PATCH RFC 1/2] meep')
293 >>> clean_subject('[PATCH] [RFC] meep')
295 >>> clean_subject('[PATCH] [RFC,1/2] meep')
297 >>> clean_subject('[PATCH] [RFC] [1/2] meep')
299 >>> clean_subject('[PATCH] rewrite [a-z] regexes')
300 'rewrite [a-z] regexes'
301 >>> clean_subject('[PATCH] [RFC] rewrite [a-z] regexes')
302 '[RFC] rewrite [a-z] regexes'
303 >>> clean_subject('[foo] [bar] meep', ['foo'])
305 >>> clean_subject('[FOO] [bar] meep', ['foo'])
309 subject = clean_header(subject)
311 if drop_prefixes is None:
314 drop_prefixes = [ s.lower() for s in drop_prefixes ]
316 drop_prefixes.append('patch')
318 # remove Re:, Fwd:, etc
319 subject = re_re.sub(' ', subject)
321 subject = normalise_space(subject)
325 match = prefix_re.match(subject)
328 prefix_str = match.group(1)
329 prefixes += [ p for p in split_prefixes(prefix_str) \
330 if p.lower() not in drop_prefixes]
332 subject = match.group(2)
333 match = prefix_re.match(subject)
335 subject = normalise_space(subject)
337 subject = subject.strip()
339 subject = '[%s] %s' % (','.join(prefixes), subject)
343 sig_re = re.compile('^(-- |_+)\n.*', re.S | re.M)
344 def clean_content(str):
345 """ Try to remove signature (-- ) and list footer (_____) cruft """
346 str = sig_re.sub('', str)
349 def parse_mail(mail):
351 # some basic sanity checks
352 if 'From' not in mail:
355 if 'Subject' not in mail:
358 if 'Message-Id' not in mail:
361 hint = mail.get('X-Patchwork-Hint', '').lower()
365 project = find_project(mail)
367 print "no project found"
370 msgid = mail.get('Message-Id').strip()
372 (author, save_required) = find_author(mail)
374 (patch, comment) = find_content(project, mail)
377 # we delay the saving until we know we have a patch.
380 save_required = False
381 patch.submitter = author
383 patch.project = project
386 except Exception, ex:
392 # looks like the original constructor for Comment takes the pk
393 # when the Comment is created. reset it here.
395 comment.patch = patch
396 comment.submitter = author
397 comment.msgid = msgid
400 except Exception, ex:
406 mail = message_from_file(sys.stdin)
407 return parse_mail(mail)
409 if __name__ == '__main__':
410 sys.exit(main(sys.argv))