buildman: Add an option to show which boards caused which errors
[karo-tx-uboot.git] / tools / buildman / buildman.py
1 #!/usr/bin/env python
2 #
3 # Copyright (c) 2012 The Chromium OS Authors.
4 #
5 # SPDX-License-Identifier:      GPL-2.0+
6 #
7
8 """See README for more information"""
9
10 import multiprocessing
11 from optparse import OptionParser
12 import os
13 import re
14 import sys
15 import unittest
16
17 # Bring in the patman libraries
18 our_path = os.path.dirname(os.path.realpath(__file__))
19 sys.path.append(os.path.join(our_path, '../patman'))
20
21 # Our modules
22 import board
23 import builder
24 import checkpatch
25 import command
26 import control
27 import doctest
28 import gitutil
29 import patchstream
30 import terminal
31 import toolchain
32
33 def RunTests():
34     import test
35     import doctest
36
37     result = unittest.TestResult()
38     for module in ['toolchain']:
39         suite = doctest.DocTestSuite(module)
40         suite.run(result)
41
42     # TODO: Surely we can just 'print' result?
43     print result
44     for test, err in result.errors:
45         print err
46     for test, err in result.failures:
47         print err
48
49     sys.argv = [sys.argv[0]]
50     suite = unittest.TestLoader().loadTestsFromTestCase(test.TestBuild)
51     result = unittest.TestResult()
52     suite.run(result)
53
54     # TODO: Surely we can just 'print' result?
55     print result
56     for test, err in result.errors:
57         print err
58     for test, err in result.failures:
59         print err
60
61
62 parser = OptionParser()
63 parser.add_option('-b', '--branch', type='string',
64        help='Branch name to build')
65 parser.add_option('-B', '--bloat', dest='show_bloat',
66        action='store_true', default=False,
67        help='Show changes in function code size for each board')
68 parser.add_option('-c', '--count', dest='count', type='int',
69        default=-1, help='Run build on the top n commits')
70 parser.add_option('-C', '--force-reconfig', dest='force_reconfig',
71        action='store_true', default=False,
72        help='Reconfigure for every commit (disable incremental build)')
73 parser.add_option('-d', '--detail', dest='show_detail',
74        action='store_true', default=False,
75        help='Show detailed information for each board in summary')
76 parser.add_option('-e', '--show_errors', action='store_true',
77        default=False, help='Show errors and warnings')
78 parser.add_option('-f', '--force-build', dest='force_build',
79        action='store_true', default=False,
80        help='Force build of boards even if already built')
81 parser.add_option('-F', '--force-build-failures', dest='force_build_failures',
82        action='store_true', default=False,
83        help='Force build of previously-failed build')
84 parser.add_option('-g', '--git', type='string',
85        help='Git repo containing branch to build', default='.')
86 parser.add_option('-G', '--config-file', type='string',
87        help='Path to buildman config file', default='')
88 parser.add_option('-H', '--full-help', action='store_true', dest='full_help',
89        default=False, help='Display the README file')
90 parser.add_option('-i', '--in-tree', dest='in_tree',
91        action='store_true', default=False,
92        help='Build in the source tree instead of a separate directory')
93 parser.add_option('-j', '--jobs', dest='jobs', type='int',
94        default=None, help='Number of jobs to run at once (passed to make)')
95 parser.add_option('-k', '--keep-outputs', action='store_true',
96        default=False, help='Keep all build output files (e.g. binaries)')
97 parser.add_option('-l', '--list-error-boards', action='store_true',
98        default=False, help='Show a list of boards next to each error/warning')
99 parser.add_option('--list-tool-chains', action='store_true', default=False,
100        help='List available tool chains')
101 parser.add_option('-n', '--dry-run', action='store_true', dest='dry_run',
102        default=False, help="Do a try run (describe actions, but no nothing)")
103 parser.add_option('-o', '--output-dir', type='string',
104        dest='output_dir', default='..',
105        help='Directory where all builds happen and buildman has its workspace (default is ../)')
106 parser.add_option('-Q', '--quick', action='store_true',
107        default=False, help='Do a rough build, with limited warning resolution')
108 parser.add_option('-s', '--summary', action='store_true',
109        default=False, help='Show a build summary')
110 parser.add_option('-S', '--show-sizes', action='store_true',
111        default=False, help='Show image size variation in summary')
112 parser.add_option('--step', type='int',
113        default=1, help='Only build every n commits (0=just first and last)')
114 parser.add_option('-t', '--test', action='store_true', dest='test',
115                   default=False, help='run tests')
116 parser.add_option('-T', '--threads', type='int',
117        default=None, help='Number of builder threads to use')
118 parser.add_option('-u', '--show_unknown', action='store_true',
119        default=False, help='Show boards with unknown build result')
120 parser.add_option('-v', '--verbose', action='store_true',
121        default=False, help='Show build results while the build progresses')
122 parser.add_option('-x', '--exclude', dest='exclude',
123       type='string', action='append',
124       help='Specify a list of boards to exclude, separated by comma')
125
126 parser.usage += """
127
128 Build U-Boot for all commits in a branch. Use -n to do a dry run"""
129
130 (options, args) = parser.parse_args()
131
132 # Run our meagre tests
133 if options.test:
134     RunTests()
135 elif options.full_help:
136     pager = os.getenv('PAGER')
137     if not pager:
138         pager = 'more'
139     fname = os.path.join(os.path.dirname(sys.argv[0]), 'README')
140     command.Run(pager, fname)
141
142 # Build selected commits for selected boards
143 else:
144     ret_code = control.DoBuildman(options, args)
145     sys.exit(ret_code)