]>
git.ipfire.org Git - people/ms/u-boot.git/blob - tools/patman/patman.py
3 # Copyright (c) 2011 The Chromium OS Authors.
5 # SPDX-License-Identifier: GPL-2.0+
8 """See README for more information"""
10 from optparse
import OptionParser
18 from patman
import checkpatch
, command
, gitutil
, patchstream
, \
19 project
, settings
, terminal
, test
31 parser
= OptionParser()
32 parser
.add_option('-H', '--full-help', action
='store_true', dest
='full_help',
33 default
=False, help='Display the README file')
34 parser
.add_option('-c', '--count', dest
='count', type='int',
35 default
=-1, help='Automatically create patches from top n commits')
36 parser
.add_option('-i', '--ignore-errors', action
='store_true',
37 dest
='ignore_errors', default
=False,
38 help='Send patches email even if patch errors are found')
39 parser
.add_option('-m', '--no-maintainers', action
='store_false',
40 dest
='add_maintainers', default
=True,
41 help="Don't cc the file maintainers automatically")
42 parser
.add_option('-n', '--dry-run', action
='store_true', dest
='dry_run',
43 default
=False, help="Do a dry run (create but don't email patches)")
44 parser
.add_option('-p', '--project', default
=project
.DetectProject(),
45 help="Project name; affects default option values and "
46 "aliases [default: %default]")
47 parser
.add_option('-r', '--in-reply-to', type='string', action
='store',
48 help="Message ID that this series is in reply to")
49 parser
.add_option('-s', '--start', dest
='start', type='int',
50 default
=0, help='Commit to start creating patches from (0 = HEAD)')
51 parser
.add_option('-t', '--ignore-bad-tags', action
='store_true',
52 default
=False, help='Ignore bad tags / aliases')
53 parser
.add_option('--test', action
='store_true', dest
='test',
54 default
=False, help='run tests')
55 parser
.add_option('-v', '--verbose', action
='store_true', dest
='verbose',
56 default
=False, help='Verbose output of errors and warnings')
57 parser
.add_option('--cc-cmd', dest
='cc_cmd', type='string', action
='store',
58 default
=None, help='Output cc list for patch file (used by git)')
59 parser
.add_option('--no-check', action
='store_false', dest
='check_patch',
61 help="Don't check for patch compliance")
62 parser
.add_option('--no-tags', action
='store_false', dest
='process_tags',
63 default
=True, help="Don't process subject tags as aliaes")
64 parser
.add_option('-T', '--thread', action
='store_true', dest
='thread',
65 default
=False, help='Create patches as a single thread')
69 Create patches from commits in a branch, check them and email them as
70 specified by tags you place in the commits. Use -n to do a dry run first."""
73 # Parse options twice: first to get the project and second to handle
74 # defaults properly (which depends on project).
75 (options
, args
) = parser
.parse_args()
76 settings
.Setup(parser
, options
.project
, '')
77 (options
, args
) = parser
.parse_args()
79 if __name__
!= "__main__":
82 # Run our meagre tests
87 sys
.argv
= [sys
.argv
[0]]
88 result
= unittest
.TestResult()
89 for module
in (test
.TestPatch
, func_test
.TestFunctional
):
90 suite
= unittest
.TestLoader().loadTestsFromTestCase(module
)
93 for module
in ['gitutil', 'settings']:
94 suite
= doctest
.DocTestSuite(module
)
97 # TODO: Surely we can just 'print' result?
99 for test
, err
in result
.errors
:
101 for test
, err
in result
.failures
:
104 # Called from git with a patch filename as argument
105 # Printout a list of additional CC recipients for this patch
107 fd
= open(options
.cc_cmd
, 'r')
108 re_line
= re
.compile('(\S*) (.*)')
109 for line
in fd
.readlines():
110 match
= re_line
.match(line
)
111 if match
and match
.group(1) == args
[0]:
112 for cc
in match
.group(2).split(', '):
118 elif options
.full_help
:
119 pager
= os
.getenv('PAGER')
122 fname
= os
.path
.join(os
.path
.dirname(os
.path
.realpath(sys
.argv
[0])),
124 command
.Run(pager
, fname
)
126 # Process commits, produce patches files, check them, email them
130 if options
.count
== -1:
131 # Work out how many patches to send if we can
132 options
.count
= gitutil
.CountCommitsToBranch() - options
.start
134 col
= terminal
.Color()
135 if not options
.count
:
136 str = 'No commits found to process - please use -c flag'
137 sys
.exit(col
.Color(col
.RED
, str))
139 # Read the metadata from the commits
141 series
= patchstream
.GetMetaData(options
.start
, options
.count
)
142 cover_fname
, args
= gitutil
.CreatePatches(options
.start
, options
.count
,
145 # Fix up the patch files to our liking, and insert the cover letter
146 patchstream
.FixPatches(series
, args
)
147 if cover_fname
and series
.get('cover'):
148 patchstream
.InsertCoverLetter(cover_fname
, series
, options
.count
)
150 # Do a few checks on the series
153 # Check the patches, and run them through 'git am' just to be sure
154 if options
.check_patch
:
155 ok
= checkpatch
.CheckPatches(options
.verbose
, args
)
159 cc_file
= series
.MakeCcFile(options
.process_tags
, cover_fname
,
160 not options
.ignore_bad_tags
,
161 options
.add_maintainers
)
163 # Email the patches out (giving the user time to check / cancel)
165 its_a_go
= ok
or options
.ignore_errors
167 cmd
= gitutil
.EmailPatches(series
, cover_fname
, args
,
168 options
.dry_run
, not options
.ignore_bad_tags
, cc_file
,
169 in_reply_to
=options
.in_reply_to
, thread
=options
.thread
)
171 print(col
.Color(col
.RED
, "Not sending emails due to errors/warnings"))
173 # For a dry run, just show our actions as a sanity check
175 series
.ShowActions(args
, cmd
, options
.process_tags
)
177 print(col
.Color(col
.RED
, "Email would not be sent"))