| # Copyright (c) 2011 The Chromium OS Authors. |
| # |
| # See file CREDITS for list of people who contributed to this |
| # project. |
| # |
| # This program 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 2 of |
| # the License, or (at your option) any later version. |
| # |
| # This program 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 this program; if not, write to the Free Software |
| # Foundation, Inc., 59 Temple Place, Suite 330, Boston, |
| # MA 02111-1307 USA |
| # |
| |
| import itertools |
| import os |
| |
| import gitutil |
| import terminal |
| |
| # Series-xxx tags that we understand |
| valid_series = ['to', 'cc', 'version', 'changes', 'prefix', 'notes', 'name']; |
| |
| class Series(dict): |
| """Holds information about a patch series, including all tags. |
| |
| Vars: |
| cc: List of aliases/emails to Cc all patches to |
| commits: List of Commit objects, one for each patch |
| cover: List of lines in the cover letter |
| notes: List of lines in the notes |
| changes: (dict) List of changes for each version, The key is |
| the integer version number |
| """ |
| def __init__(self): |
| self.cc = [] |
| self.to = [] |
| self.commits = [] |
| self.cover = None |
| self.notes = [] |
| self.changes = {} |
| |
| # Written in MakeCcFile() |
| # key: name of patch file |
| # value: list of email addresses |
| self._generated_cc = {} |
| |
| # These make us more like a dictionary |
| def __setattr__(self, name, value): |
| self[name] = value |
| |
| def __getattr__(self, name): |
| return self[name] |
| |
| def AddTag(self, commit, line, name, value): |
| """Add a new Series-xxx tag along with its value. |
| |
| Args: |
| line: Source line containing tag (useful for debug/error messages) |
| name: Tag name (part after 'Series-') |
| value: Tag value (part after 'Series-xxx: ') |
| """ |
| # If we already have it, then add to our list |
| if name in self: |
| values = value.split(',') |
| values = [str.strip() for str in values] |
| if type(self[name]) != type([]): |
| raise ValueError("In %s: line '%s': Cannot add another value " |
| "'%s' to series '%s'" % |
| (commit.hash, line, values, self[name])) |
| self[name] += values |
| |
| # Otherwise just set the value |
| elif name in valid_series: |
| self[name] = value |
| else: |
| raise ValueError("In %s: line '%s': Unknown 'Series-%s': valid " |
| "options are %s" % (commit.hash, line, name, |
| ', '.join(valid_series))) |
| |
| def AddCommit(self, commit): |
| """Add a commit into our list of commits |
| |
| We create a list of tags in the commit subject also. |
| |
| Args: |
| commit: Commit object to add |
| """ |
| commit.CheckTags() |
| self.commits.append(commit) |
| |
| def ShowActions(self, args, cmd, process_tags): |
| """Show what actions we will/would perform |
| |
| Args: |
| args: List of patch files we created |
| cmd: The git command we would have run |
| process_tags: Process tags as if they were aliases |
| """ |
| col = terminal.Color() |
| print 'Dry run, so not doing much. But I would do this:' |
| print |
| print 'Send a total of %d patch%s with %scover letter.' % ( |
| len(args), '' if len(args) == 1 else 'es', |
| self.get('cover') and 'a ' or 'no ') |
| |
| # TODO: Colour the patches according to whether they passed checks |
| for upto in range(len(args)): |
| commit = self.commits[upto] |
| print col.Color(col.GREEN, ' %s' % args[upto]) |
| cc_list = list(self._generated_cc[commit.patch]) |
| |
| # Skip items in To list |
| if 'to' in self: |
| try: |
| map(cc_list.remove, gitutil.BuildEmailList(self.to)) |
| except ValueError: |
| pass |
| |
| for email in cc_list: |
| if email == None: |
| email = col.Color(col.YELLOW, "<alias '%s' not found>" |
| % tag) |
| if email: |
| print ' Cc: ',email |
| print |
| for item in gitutil.BuildEmailList(self.get('to', '<none>')): |
| print 'To:\t ', item |
| for item in gitutil.BuildEmailList(self.cc): |
| print 'Cc:\t ', item |
| print 'Version: ', self.get('version') |
| print 'Prefix:\t ', self.get('prefix') |
| if self.cover: |
| print 'Cover: %d lines' % len(self.cover) |
| all_ccs = itertools.chain(*self._generated_cc.values()) |
| for email in set(all_ccs): |
| print ' Cc: ',email |
| if cmd: |
| print 'Git command: %s' % cmd |
| |
| def MakeChangeLog(self, commit): |
| """Create a list of changes for each version. |
| |
| Return: |
| The change log as a list of strings, one per line |
| |
| Changes in v4: |
| - Jog the dial back closer to the widget |
| |
| Changes in v3: None |
| Changes in v2: |
| - Fix the widget |
| - Jog the dial |
| |
| etc. |
| """ |
| final = [] |
| need_blank = False |
| for change in sorted(self.changes, reverse=True): |
| out = [] |
| for this_commit, text in self.changes[change]: |
| if commit and this_commit != commit: |
| continue |
| out.append(text) |
| line = 'Changes in v%d:' % change |
| have_changes = len(out) > 0 |
| if have_changes: |
| out.insert(0, line) |
| else: |
| out = [line + ' None'] |
| if need_blank: |
| out.insert(0, '') |
| final += out |
| need_blank = have_changes |
| if self.changes: |
| final.append('') |
| return final |
| |
| def DoChecks(self): |
| """Check that each version has a change log |
| |
| Print an error if something is wrong. |
| """ |
| col = terminal.Color() |
| if self.get('version'): |
| changes_copy = dict(self.changes) |
| for version in range(1, int(self.version) + 1): |
| if self.changes.get(version): |
| del changes_copy[version] |
| else: |
| if version > 1: |
| str = 'Change log missing for v%d' % version |
| print col.Color(col.RED, str) |
| for version in changes_copy: |
| str = 'Change log for unknown version v%d' % version |
| print col.Color(col.RED, str) |
| elif self.changes: |
| str = 'Change log exists, but no version is set' |
| print col.Color(col.RED, str) |
| |
| def MakeCcFile(self, process_tags, cover_fname): |
| """Make a cc file for us to use for per-commit Cc automation |
| |
| Also stores in self._generated_cc to make ShowActions() faster. |
| |
| Args: |
| process_tags: Process tags as if they were aliases |
| cover_fname: If non-None the name of the cover letter. |
| Return: |
| Filename of temp file created |
| """ |
| # Look for commit tags (of the form 'xxx:' at the start of the subject) |
| fname = '/tmp/patman.%d' % os.getpid() |
| fd = open(fname, 'w') |
| all_ccs = [] |
| for commit in self.commits: |
| list = [] |
| if process_tags: |
| list += gitutil.BuildEmailList(commit.tags) |
| list += gitutil.BuildEmailList(commit.cc_list) |
| all_ccs += list |
| print >>fd, commit.patch, ', '.join(list) |
| self._generated_cc[commit.patch] = list |
| |
| if cover_fname: |
| print >>fd, cover_fname, ', '.join(set(all_ccs)) |
| |
| fd.close() |
| return fname |
| |
| def AddChange(self, version, commit, info): |
| """Add a new change line to a version. |
| |
| This will later appear in the change log. |
| |
| Args: |
| version: version number to add change list to |
| info: change line for this version |
| """ |
| if not self.changes.get(version): |
| self.changes[version] = [] |
| self.changes[version].append([commit, info]) |
| |
| def GetPatchPrefix(self): |
| """Get the patch version string |
| |
| Return: |
| Patch string, like 'RFC PATCH v5' or just 'PATCH' |
| """ |
| version = '' |
| if self.get('version'): |
| version = ' v%s' % self['version'] |
| |
| # Get patch name prefix |
| prefix = '' |
| if self.get('prefix'): |
| prefix = '%s ' % self['prefix'] |
| return '%sPATCH%s' % (prefix, version) |