1 # SPDX-License-Identifier: GPL-2.0+
2 # Copyright (c) 2011 The Chromium OS Authors.
7 # Separates a tag: at the beginning of the subject from the rest of it
8 re_subject_tag = re.compile('([^:\s]*):\s*(.*)')
11 """Holds information about a single commit/patch in the series.
14 hash: Commit hash (as a string)
19 tags: List of maintainer tag strings
20 changes: Dict containing a list of changes (single line strings).
21 The dict is indexed by change version (an integer)
22 cc_list: List of people to aliases/emails to cc on this commit
23 notes: List of lines in the commit (not series) notes
25 def __init__(self, hash):
31 self.signoff_set = set()
34 def AddChange(self, version, info):
35 """Add a new change line to the change list for a version.
38 version: Patch set version (integer: 1, 2, 3)
39 info: Description of change in this version
41 if not self.changes.get(version):
42 self.changes[version] = []
43 self.changes[version].append(info)
46 """Create a list of subject tags in the commit
48 Subject tags look like this:
50 propounder: fort: Change the widget to propound correctly
52 Here the tags are propounder and fort. Multiple tags are supported.
53 The list is updated in self.tag.
56 None if ok, else the name of a tag with no email alias
61 m = re_subject_tag.match(str)
68 def AddCc(self, cc_list):
69 """Add a list of people to Cc when we send this patch.
72 cc_list: List of aliases or email addresses
74 self.cc_list += cc_list
76 def CheckDuplicateSignoff(self, signoff):
77 """Check a list of signoffs we have send for this patch
82 True if this signoff is new, False if we have already seen it.
84 if signoff in self.signoff_set:
86 self.signoff_set.add(signoff)