blob: ebd78f225e1a5d607d0d3b12ae6703625a093fab [file] [log] [blame]
Tom Rini10e47792018-05-06 17:58:06 -04001# SPDX-License-Identifier: GPL-2.0+
Simon Glassed098bb2014-09-05 19:00:13 -06002# Copyright (c) 2014 Google, Inc
3#
Simon Glassed098bb2014-09-05 19:00:13 -06004
5import os
6import shutil
7import sys
8import tempfile
9import unittest
10
Simon Glassf0d9c102020-04-17 18:09:02 -060011from buildman import board
Simon Glass20751d62022-07-11 19:04:03 -060012from buildman import boards
Simon Glassf0d9c102020-04-17 18:09:02 -060013from buildman import bsettings
14from buildman import cmdline
15from buildman import control
16from buildman import toolchain
Simon Glassa997ea52020-04-17 18:09:04 -060017from patman import gitutil
Simon Glass131444f2023-02-23 18:18:04 -070018from u_boot_pylib import command
19from u_boot_pylib import terminal
20from u_boot_pylib import test_util
21from u_boot_pylib import tools
Simon Glassed098bb2014-09-05 19:00:13 -060022
Simon Glass5e0441d2014-09-05 19:00:15 -060023settings_data = '''
24# Buildman settings file
Tom Rini93ebd462022-11-09 19:14:53 -070025[global]
Simon Glass5e0441d2014-09-05 19:00:15 -060026
27[toolchain]
28
29[toolchain-alias]
30
31[make-flags]
32src=/home/sjg/c/src
33chroot=/home/sjg/c/chroot
Masahiro Yamada72e545a2018-08-06 20:47:38 +090034vboot=VBOOT_DEBUG=1 MAKEFLAGS_VBOOT=DEBUG=1 CFLAGS_EXTRA_VBOOT=-DUNROLL_LOOPS VBOOT_SOURCE=${src}/platform/vboot_reference
Simon Glass5e0441d2014-09-05 19:00:15 -060035chromeos_coreboot=VBOOT=${chroot}/build/link/usr ${vboot}
36chromeos_daisy=VBOOT=${chroot}/build/daisy/usr ${vboot}
37chromeos_peach=VBOOT=${chroot}/build/peach_pit/usr ${vboot}
38'''
39
Simon Glassd4c6c8a2022-07-11 19:03:58 -060040BOARDS = [
Simon Glasscbd36582014-09-05 19:00:16 -060041 ['Active', 'arm', 'armv7', '', 'Tester', 'ARM Board 1', 'board0', ''],
42 ['Active', 'arm', 'armv7', '', 'Tester', 'ARM Board 2', 'board1', ''],
43 ['Active', 'powerpc', 'powerpc', '', 'Tester', 'PowerPC board 1', 'board2', ''],
Simon Glasscbd36582014-09-05 19:00:16 -060044 ['Active', 'sandbox', 'sandbox', '', 'Tester', 'Sandbox board', 'board4', ''],
45]
46
Simon Glass8e959562014-09-05 19:00:20 -060047commit_shortlog = """4aca821 patman: Avoid changing the order of tags
4839403bb patman: Use --no-pager' to stop git from forking a pager
49db6e6f2 patman: Remove the -a option
50f2ccf03 patman: Correct unit tests to run correctly
511d097f9 patman: Fix indentation in terminal.py
52d073747 patman: Support the 'reverse' option for 'git log
53"""
54
55commit_log = ["""commit 7f6b8315d18f683c5181d0c3694818c1b2a20dcd
56Author: Masahiro Yamada <yamada.m@jp.panasonic.com>
57Date: Fri Aug 22 19:12:41 2014 +0900
58
59 buildman: refactor help message
60
61 "buildman [options]" is displayed by default.
62
63 Append the rest of help messages to parser.usage
64 instead of replacing it.
65
66 Besides, "-b <branch>" is not mandatory since commit fea5858e.
67 Drop it from the usage.
68
69 Signed-off-by: Masahiro Yamada <yamada.m@jp.panasonic.com>
70""",
71"""commit d0737479be6baf4db5e2cdbee123e96bc5ed0ba8
72Author: Simon Glass <sjg@chromium.org>
73Date: Thu Aug 14 16:48:25 2014 -0600
74
75 patman: Support the 'reverse' option for 'git log'
76
77 This option is currently not supported, but needs to be, for buildman to
78 operate as expected.
79
80 Series-changes: 7
81 - Add new patch to fix the 'reverse' bug
82
Simon Glass359b55a62014-09-05 19:00:23 -060083 Series-version: 8
Simon Glass8e959562014-09-05 19:00:20 -060084
85 Change-Id: I79078f792e8b390b8a1272a8023537821d45feda
86 Reported-by: York Sun <yorksun@freescale.com>
87 Signed-off-by: Simon Glass <sjg@chromium.org>
88
89""",
90"""commit 1d097f9ab487c5019152fd47bda126839f3bf9fc
91Author: Simon Glass <sjg@chromium.org>
92Date: Sat Aug 9 11:44:32 2014 -0600
93
94 patman: Fix indentation in terminal.py
95
96 This code came from a different project with 2-character indentation. Fix
97 it for U-Boot.
98
99 Series-changes: 6
100 - Add new patch to fix indentation in teminal.py
101
102 Change-Id: I5a74d2ebbb3cc12a665f5c725064009ac96e8a34
103 Signed-off-by: Simon Glass <sjg@chromium.org>
104
105""",
106"""commit f2ccf03869d1e152c836515a3ceb83cdfe04a105
107Author: Simon Glass <sjg@chromium.org>
108Date: Sat Aug 9 11:08:24 2014 -0600
109
110 patman: Correct unit tests to run correctly
111
112 It seems that doctest behaves differently now, and some of the unit tests
113 do not run. Adjust the tests to work correctly.
114
115 ./tools/patman/patman --test
116 <unittest.result.TestResult run=10 errors=0 failures=0>
117
118 Series-changes: 6
119 - Add new patch to fix patman unit tests
120
121 Change-Id: I3d2ca588f4933e1f9d6b1665a00e4ae58269ff3b
122
123""",
124"""commit db6e6f2f9331c5a37647d6668768d4a40b8b0d1c
125Author: Simon Glass <sjg@chromium.org>
126Date: Sat Aug 9 12:06:02 2014 -0600
127
128 patman: Remove the -a option
129
130 It seems that this is no longer needed, since checkpatch.pl will catch
131 whitespace problems in patches. Also the option is not widely used, so
132 it seems safe to just remove it.
133
134 Series-changes: 6
135 - Add new patch to remove patman's -a option
136
137 Suggested-by: Masahiro Yamada <yamada.m@jp.panasonic.com>
138 Change-Id: I5821a1c75154e532c46513486ca40b808de7e2cc
139
140""",
141"""commit 39403bb4f838153028a6f21ca30bf100f3791133
142Author: Simon Glass <sjg@chromium.org>
143Date: Thu Aug 14 21:50:52 2014 -0600
144
145 patman: Use --no-pager' to stop git from forking a pager
146
147""",
148"""commit 4aca821e27e97925c039e69fd37375b09c6f129c
149Author: Simon Glass <sjg@chromium.org>
150Date: Fri Aug 22 15:57:39 2014 -0600
151
152 patman: Avoid changing the order of tags
153
154 patman collects tags that it sees in the commit and places them nicely
155 sorted at the end of the patch. However, this is not really necessary and
156 in fact is apparently not desirable.
157
158 Series-changes: 9
159 - Add new patch to avoid changing the order of tags
160
Simon Glass359b55a62014-09-05 19:00:23 -0600161 Series-version: 9
162
Simon Glass8e959562014-09-05 19:00:20 -0600163 Suggested-by: Masahiro Yamada <yamada.m@jp.panasonic.com>
164 Change-Id: Ib1518588c1a189ad5c3198aae76f8654aed8d0db
165"""]
166
167TEST_BRANCH = '__testbranch'
168
Simon Glassed098bb2014-09-05 19:00:13 -0600169class TestFunctional(unittest.TestCase):
170 """Functional test for buildman.
171
172 This aims to test from just below the invocation of buildman (parsing
173 of arguments) to 'make' and 'git' invocation. It is not a true
174 emd-to-end test, as it mocks git, make and the tool chain. But this
175 makes it easier to detect when the builder is doing the wrong thing,
176 since in many cases this test code will fail. For example, only a
177 very limited subset of 'git' arguments is supported - anything
178 unexpected will fail.
179 """
180 def setUp(self):
181 self._base_dir = tempfile.mkdtemp()
Tom Rinie95eddc2019-10-07 17:17:36 -0400182 self._output_dir = tempfile.mkdtemp()
Simon Glassed098bb2014-09-05 19:00:13 -0600183 self._git_dir = os.path.join(self._base_dir, 'src')
184 self._buildman_pathname = sys.argv[0]
Simon Glass5d4a7872016-07-27 20:33:00 -0600185 self._buildman_dir = os.path.dirname(os.path.realpath(sys.argv[0]))
Simon Glassed098bb2014-09-05 19:00:13 -0600186 command.test_result = self._HandleCommand
Simon Glass22901f92022-01-22 05:07:31 -0700187 bsettings.Setup(None)
188 bsettings.AddFile(settings_data)
Simon Glass8e959562014-09-05 19:00:20 -0600189 self.setupToolchains()
190 self._toolchains.Add('arm-gcc', test=False)
191 self._toolchains.Add('powerpc-gcc', test=False)
Simon Glass20751d62022-07-11 19:04:03 -0600192 self._boards = boards.Boards()
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600193 for brd in BOARDS:
Simon Glass127a2392022-07-11 19:04:02 -0600194 self._boards.add_board(board.Board(*brd))
Simon Glassed098bb2014-09-05 19:00:13 -0600195
Simon Glass8e959562014-09-05 19:00:20 -0600196 # Directories where the source been cloned
197 self._clone_dirs = []
198 self._commits = len(commit_shortlog.splitlines()) + 1
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600199 self._total_builds = self._commits * len(BOARDS)
Simon Glass8e959562014-09-05 19:00:20 -0600200
201 # Number of calls to make
202 self._make_calls = 0
203
204 # Map of [board, commit] to error messages
205 self._error = {}
206
Simon Glass4aeceb92014-09-05 19:00:22 -0600207 self._test_branch = TEST_BRANCH
208
Tom Rini93ebd462022-11-09 19:14:53 -0700209 # Set to True to report missing blobs
210 self._missing = False
211
Simon Glass8e959562014-09-05 19:00:20 -0600212 # Avoid sending any output and clear all terminal output
Simon Glass02811582022-01-29 14:14:18 -0700213 terminal.set_print_test_mode()
214 terminal.get_print_test_lines()
Simon Glass8e959562014-09-05 19:00:20 -0600215
Simon Glassed098bb2014-09-05 19:00:13 -0600216 def tearDown(self):
217 shutil.rmtree(self._base_dir)
Simon Glass211c74b2022-11-09 19:14:52 -0700218 shutil.rmtree(self._output_dir)
Simon Glassed098bb2014-09-05 19:00:13 -0600219
Simon Glass8e959562014-09-05 19:00:20 -0600220 def setupToolchains(self):
221 self._toolchains = toolchain.Toolchains()
222 self._toolchains.Add('gcc', test=False)
223
Simon Glassed098bb2014-09-05 19:00:13 -0600224 def _RunBuildman(self, *args):
Simon Glass840be732022-01-29 14:14:05 -0700225 return command.run_pipe([[self._buildman_pathname] + list(args)],
Simon Glassed098bb2014-09-05 19:00:13 -0600226 capture=True, capture_stderr=True)
227
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600228 def _RunControl(self, *args, brds=None, clean_dir=False,
Simon Glass9bf9a722021-04-11 16:27:27 +1200229 test_thread_exceptions=False):
Simon Glassa29b3ea2021-04-11 16:27:25 +1200230 """Run buildman
231
232 Args:
233 args: List of arguments to pass
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600234 brds: Boards object
Simon Glassa29b3ea2021-04-11 16:27:25 +1200235 clean_dir: Used for tests only, indicates that the existing output_dir
236 should be removed before starting the build
Simon Glass9bf9a722021-04-11 16:27:27 +1200237 test_thread_exceptions: Uses for tests only, True to make the threads
238 raise an exception instead of reporting their result. This simulates
239 a failure in the code somewhere
Simon Glassa29b3ea2021-04-11 16:27:25 +1200240
241 Returns:
242 result code from buildman
243 """
Simon Glassed098bb2014-09-05 19:00:13 -0600244 sys.argv = [sys.argv[0]] + list(args)
245 options, args = cmdline.ParseArgs()
Simon Glass8e959562014-09-05 19:00:20 -0600246 result = control.DoBuildman(options, args, toolchains=self._toolchains,
Simon Glass5df45222022-07-11 19:04:00 -0600247 make_func=self._HandleMake, brds=brds or self._boards,
Simon Glass9bf9a722021-04-11 16:27:27 +1200248 clean_dir=clean_dir,
249 test_thread_exceptions=test_thread_exceptions)
Simon Glass8e959562014-09-05 19:00:20 -0600250 self._builder = control.builder
251 return result
Simon Glassed098bb2014-09-05 19:00:13 -0600252
253 def testFullHelp(self):
254 command.test_result = None
255 result = self._RunBuildman('-H')
Simon Glass79cc9be2022-11-09 19:14:43 -0700256 help_file = os.path.join(self._buildman_dir, 'README.rst')
Tom Rinic3c0b6d2018-01-16 15:29:50 -0500257 # Remove possible extraneous strings
258 extra = '::::::::::::::\n' + help_file + '\n::::::::::::::\n'
259 gothelp = result.stdout.replace(extra, '')
260 self.assertEqual(len(gothelp), os.path.getsize(help_file))
Simon Glassed098bb2014-09-05 19:00:13 -0600261 self.assertEqual(0, len(result.stderr))
262 self.assertEqual(0, result.return_code)
263
264 def testHelp(self):
265 command.test_result = None
266 result = self._RunBuildman('-h')
Simon Glass79cc9be2022-11-09 19:14:43 -0700267 help_file = os.path.join(self._buildman_dir, 'README.rst')
Simon Glassed098bb2014-09-05 19:00:13 -0600268 self.assertTrue(len(result.stdout) > 1000)
269 self.assertEqual(0, len(result.stderr))
270 self.assertEqual(0, result.return_code)
271
272 def testGitSetup(self):
273 """Test gitutils.Setup(), from outside the module itself"""
274 command.test_result = command.CommandResult(return_code=1)
Simon Glass761648b2022-01-29 14:14:11 -0700275 gitutil.setup()
Simon Glassed098bb2014-09-05 19:00:13 -0600276 self.assertEqual(gitutil.use_no_decorate, False)
277
278 command.test_result = command.CommandResult(return_code=0)
Simon Glass761648b2022-01-29 14:14:11 -0700279 gitutil.setup()
Simon Glassed098bb2014-09-05 19:00:13 -0600280 self.assertEqual(gitutil.use_no_decorate, True)
281
282 def _HandleCommandGitLog(self, args):
Simon Glass642e9a62016-03-12 18:50:31 -0700283 if args[-1] == '--':
284 args = args[:-1]
Simon Glassed098bb2014-09-05 19:00:13 -0600285 if '-n0' in args:
286 return command.CommandResult(return_code=0)
Simon Glass4aeceb92014-09-05 19:00:22 -0600287 elif args[-1] == 'upstream/master..%s' % self._test_branch:
Simon Glass8e959562014-09-05 19:00:20 -0600288 return command.CommandResult(return_code=0, stdout=commit_shortlog)
289 elif args[:3] == ['--no-color', '--no-decorate', '--reverse']:
Simon Glass4aeceb92014-09-05 19:00:22 -0600290 if args[-1] == self._test_branch:
Simon Glass8e959562014-09-05 19:00:20 -0600291 count = int(args[3][2:])
292 return command.CommandResult(return_code=0,
293 stdout=''.join(commit_log[:count]))
Simon Glassed098bb2014-09-05 19:00:13 -0600294
295 # Not handled, so abort
Simon Glassc78ed662019-10-31 07:42:53 -0600296 print('git log', args)
Simon Glassed098bb2014-09-05 19:00:13 -0600297 sys.exit(1)
298
Simon Glass8e959562014-09-05 19:00:20 -0600299 def _HandleCommandGitConfig(self, args):
300 config = args[0]
301 if config == 'sendemail.aliasesfile':
302 return command.CommandResult(return_code=0)
303 elif config.startswith('branch.badbranch'):
304 return command.CommandResult(return_code=1)
Simon Glass4aeceb92014-09-05 19:00:22 -0600305 elif config == 'branch.%s.remote' % self._test_branch:
Simon Glass8e959562014-09-05 19:00:20 -0600306 return command.CommandResult(return_code=0, stdout='upstream\n')
Simon Glass4aeceb92014-09-05 19:00:22 -0600307 elif config == 'branch.%s.merge' % self._test_branch:
Simon Glass8e959562014-09-05 19:00:20 -0600308 return command.CommandResult(return_code=0,
309 stdout='refs/heads/master\n')
310
311 # Not handled, so abort
Simon Glassc78ed662019-10-31 07:42:53 -0600312 print('git config', args)
Simon Glass8e959562014-09-05 19:00:20 -0600313 sys.exit(1)
314
Simon Glassed098bb2014-09-05 19:00:13 -0600315 def _HandleCommandGit(self, in_args):
316 """Handle execution of a git command
317
318 This uses a hacked-up parser.
319
320 Args:
321 in_args: Arguments after 'git' from the command line
322 """
323 git_args = [] # Top-level arguments to git itself
324 sub_cmd = None # Git sub-command selected
325 args = [] # Arguments to the git sub-command
326 for arg in in_args:
327 if sub_cmd:
328 args.append(arg)
329 elif arg[0] == '-':
330 git_args.append(arg)
331 else:
Simon Glass8e959562014-09-05 19:00:20 -0600332 if git_args and git_args[-1] in ['--git-dir', '--work-tree']:
333 git_args.append(arg)
334 else:
335 sub_cmd = arg
Simon Glassed098bb2014-09-05 19:00:13 -0600336 if sub_cmd == 'config':
Simon Glass8e959562014-09-05 19:00:20 -0600337 return self._HandleCommandGitConfig(args)
Simon Glassed098bb2014-09-05 19:00:13 -0600338 elif sub_cmd == 'log':
339 return self._HandleCommandGitLog(args)
Simon Glass8e959562014-09-05 19:00:20 -0600340 elif sub_cmd == 'clone':
341 return command.CommandResult(return_code=0)
342 elif sub_cmd == 'checkout':
343 return command.CommandResult(return_code=0)
Alper Nebi Yasakfede44a2020-09-03 15:51:03 +0300344 elif sub_cmd == 'worktree':
345 return command.CommandResult(return_code=0)
Simon Glassed098bb2014-09-05 19:00:13 -0600346
347 # Not handled, so abort
Simon Glassc78ed662019-10-31 07:42:53 -0600348 print('git', git_args, sub_cmd, args)
Simon Glassed098bb2014-09-05 19:00:13 -0600349 sys.exit(1)
350
351 def _HandleCommandNm(self, args):
352 return command.CommandResult(return_code=0)
353
354 def _HandleCommandObjdump(self, args):
355 return command.CommandResult(return_code=0)
356
Alex Kiernanf07ed232018-05-31 04:48:33 +0000357 def _HandleCommandObjcopy(self, args):
358 return command.CommandResult(return_code=0)
359
Simon Glassed098bb2014-09-05 19:00:13 -0600360 def _HandleCommandSize(self, args):
361 return command.CommandResult(return_code=0)
362
363 def _HandleCommand(self, **kwargs):
364 """Handle a command execution.
365
366 The command is in kwargs['pipe-list'], as a list of pipes, each a
367 list of commands. The command should be emulated as required for
368 testing purposes.
369
370 Returns:
371 A CommandResult object
372 """
373 pipe_list = kwargs['pipe_list']
Simon Glass8e959562014-09-05 19:00:20 -0600374 wc = False
Simon Glassed098bb2014-09-05 19:00:13 -0600375 if len(pipe_list) != 1:
Simon Glass8e959562014-09-05 19:00:20 -0600376 if pipe_list[1] == ['wc', '-l']:
377 wc = True
378 else:
Simon Glassc78ed662019-10-31 07:42:53 -0600379 print('invalid pipe', kwargs)
Simon Glass8e959562014-09-05 19:00:20 -0600380 sys.exit(1)
Simon Glassed098bb2014-09-05 19:00:13 -0600381 cmd = pipe_list[0][0]
382 args = pipe_list[0][1:]
Simon Glass8e959562014-09-05 19:00:20 -0600383 result = None
Simon Glassed098bb2014-09-05 19:00:13 -0600384 if cmd == 'git':
Simon Glass8e959562014-09-05 19:00:20 -0600385 result = self._HandleCommandGit(args)
Simon Glassed098bb2014-09-05 19:00:13 -0600386 elif cmd == './scripts/show-gnu-make':
387 return command.CommandResult(return_code=0, stdout='make')
Simon Glass8e959562014-09-05 19:00:20 -0600388 elif cmd.endswith('nm'):
Simon Glassed098bb2014-09-05 19:00:13 -0600389 return self._HandleCommandNm(args)
Simon Glass8e959562014-09-05 19:00:20 -0600390 elif cmd.endswith('objdump'):
Simon Glassed098bb2014-09-05 19:00:13 -0600391 return self._HandleCommandObjdump(args)
Alex Kiernanf07ed232018-05-31 04:48:33 +0000392 elif cmd.endswith('objcopy'):
393 return self._HandleCommandObjcopy(args)
Simon Glass8e959562014-09-05 19:00:20 -0600394 elif cmd.endswith( 'size'):
Simon Glassed098bb2014-09-05 19:00:13 -0600395 return self._HandleCommandSize(args)
396
Simon Glass8e959562014-09-05 19:00:20 -0600397 if not result:
398 # Not handled, so abort
Simon Glassc78ed662019-10-31 07:42:53 -0600399 print('unknown command', kwargs)
Simon Glass8e959562014-09-05 19:00:20 -0600400 sys.exit(1)
401
402 if wc:
403 result.stdout = len(result.stdout.splitlines())
404 return result
Simon Glassed098bb2014-09-05 19:00:13 -0600405
406 def _HandleMake(self, commit, brd, stage, cwd, *args, **kwargs):
407 """Handle execution of 'make'
408
409 Args:
410 commit: Commit object that is being built
411 brd: Board object that is being built
412 stage: Stage that we are at (mrproper, config, build)
413 cwd: Directory where make should be run
414 args: Arguments to pass to make
Simon Glass840be732022-01-29 14:14:05 -0700415 kwargs: Arguments to pass to command.run_pipe()
Simon Glassed098bb2014-09-05 19:00:13 -0600416 """
Simon Glass8e959562014-09-05 19:00:20 -0600417 self._make_calls += 1
Simon Glass828d70d2023-02-21 12:40:29 -0700418 out_dir = ''
419 for arg in args:
420 if arg.startswith('O='):
421 out_dir = arg[2:]
Simon Glassed098bb2014-09-05 19:00:13 -0600422 if stage == 'mrproper':
423 return command.CommandResult(return_code=0)
424 elif stage == 'config':
Simon Glass828d70d2023-02-21 12:40:29 -0700425 fname = os.path.join(cwd or '', out_dir, '.config')
426 tools.write_file(fname, b'CONFIG_SOMETHING=1')
Simon Glassed098bb2014-09-05 19:00:13 -0600427 return command.CommandResult(return_code=0,
428 combined='Test configuration complete')
429 elif stage == 'build':
Simon Glass8e959562014-09-05 19:00:20 -0600430 stderr = ''
Simon Glassb6eb8cf2020-03-18 09:42:42 -0600431 fname = os.path.join(cwd or '', out_dir, 'u-boot')
Simon Glass80025522022-01-29 14:14:04 -0700432 tools.write_file(fname, b'U-Boot')
Tom Rini93ebd462022-11-09 19:14:53 -0700433
434 # Handle missing blobs
435 if self._missing:
436 if 'BINMAN_ALLOW_MISSING=1' in args:
437 stderr = '''+Image 'main-section' is missing external blobs and is non-functional: intel-descriptor intel-ifwi intel-fsp-m intel-fsp-s intel-vbt
438Image 'main-section' has faked external blobs and is non-functional: descriptor.bin fsp_m.bin fsp_s.bin vbt.bin
439
440Some images are invalid'''
441 else:
442 stderr = "binman: Filename 'fsp.bin' not found in input path"
443 elif type(commit) is not str:
Simon Glass8e959562014-09-05 19:00:20 -0600444 stderr = self._error.get((brd.target, commit.sequence))
Tom Rini93ebd462022-11-09 19:14:53 -0700445
Simon Glass8e959562014-09-05 19:00:20 -0600446 if stderr:
Tom Rini93ebd462022-11-09 19:14:53 -0700447 return command.CommandResult(return_code=2, stderr=stderr)
Simon Glassed098bb2014-09-05 19:00:13 -0600448 return command.CommandResult(return_code=0)
449
450 # Not handled, so abort
Simon Glassc78ed662019-10-31 07:42:53 -0600451 print('make', stage)
Simon Glassed098bb2014-09-05 19:00:13 -0600452 sys.exit(1)
453
Simon Glass8e959562014-09-05 19:00:20 -0600454 # Example function to print output lines
455 def print_lines(self, lines):
Simon Glassc78ed662019-10-31 07:42:53 -0600456 print(len(lines))
Simon Glass8e959562014-09-05 19:00:20 -0600457 for line in lines:
Simon Glassc78ed662019-10-31 07:42:53 -0600458 print(line)
Simon Glass02811582022-01-29 14:14:18 -0700459 #self.print_lines(terminal.get_print_test_lines())
Simon Glass8e959562014-09-05 19:00:20 -0600460
Simon Glasscbd36582014-09-05 19:00:16 -0600461 def testNoBoards(self):
462 """Test that buildman aborts when there are no boards"""
Simon Glass20751d62022-07-11 19:04:03 -0600463 self._boards = boards.Boards()
Simon Glasscbd36582014-09-05 19:00:16 -0600464 with self.assertRaises(SystemExit):
465 self._RunControl()
466
Simon Glassed098bb2014-09-05 19:00:13 -0600467 def testCurrentSource(self):
468 """Very simple test to invoke buildman on the current source"""
Simon Glass8e959562014-09-05 19:00:20 -0600469 self.setupToolchains();
Tom Rinie95eddc2019-10-07 17:17:36 -0400470 self._RunControl('-o', self._output_dir)
Simon Glass02811582022-01-29 14:14:18 -0700471 lines = terminal.get_print_test_lines()
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600472 self.assertIn('Building current source for %d boards' % len(BOARDS),
Simon Glass8e959562014-09-05 19:00:20 -0600473 lines[0].text)
474
475 def testBadBranch(self):
476 """Test that we can detect an invalid branch"""
477 with self.assertRaises(ValueError):
478 self._RunControl('-b', 'badbranch')
479
480 def testBadToolchain(self):
481 """Test that missing toolchains are detected"""
482 self.setupToolchains();
Tom Rinie95eddc2019-10-07 17:17:36 -0400483 ret_code = self._RunControl('-b', TEST_BRANCH, '-o', self._output_dir)
Simon Glass02811582022-01-29 14:14:18 -0700484 lines = terminal.get_print_test_lines()
Simon Glass8e959562014-09-05 19:00:20 -0600485
486 # Buildman always builds the upstream commit as well
487 self.assertIn('Building %d commits for %d boards' %
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600488 (self._commits, len(BOARDS)), lines[0].text)
Simon Glass8e959562014-09-05 19:00:20 -0600489 self.assertEqual(self._builder.count, self._total_builds)
490
491 # Only sandbox should succeed, the others don't have toolchains
492 self.assertEqual(self._builder.fail,
493 self._total_builds - self._commits)
Simon Glasse4cd5062020-04-09 10:49:45 -0600494 self.assertEqual(ret_code, 100)
Simon Glass8e959562014-09-05 19:00:20 -0600495
496 for commit in range(self._commits):
Simon Glass127a2392022-07-11 19:04:02 -0600497 for brd in self._boards.get_list():
Simon Glass8132f982022-07-11 19:03:57 -0600498 if brd.arch != 'sandbox':
499 errfile = self._builder.GetErrFile(commit, brd.target)
Simon Glass8e959562014-09-05 19:00:20 -0600500 fd = open(errfile)
501 self.assertEqual(fd.readlines(),
Simon Glass8132f982022-07-11 19:03:57 -0600502 ['No tool chain for %s\n' % brd.arch])
Simon Glass8e959562014-09-05 19:00:20 -0600503 fd.close()
504
505 def testBranch(self):
506 """Test building a branch with all toolchains present"""
Tom Rinie95eddc2019-10-07 17:17:36 -0400507 self._RunControl('-b', TEST_BRANCH, '-o', self._output_dir)
Simon Glass8e959562014-09-05 19:00:20 -0600508 self.assertEqual(self._builder.count, self._total_builds)
509 self.assertEqual(self._builder.fail, 0)
510
511 def testCount(self):
512 """Test building a specific number of commitst"""
Tom Rinie95eddc2019-10-07 17:17:36 -0400513 self._RunControl('-b', TEST_BRANCH, '-c2', '-o', self._output_dir)
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600514 self.assertEqual(self._builder.count, 2 * len(BOARDS))
Simon Glass8e959562014-09-05 19:00:20 -0600515 self.assertEqual(self._builder.fail, 0)
Simon Glass6029af12020-04-09 15:08:51 -0600516 # Each board has a config, and then one make per commit
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600517 self.assertEqual(self._make_calls, len(BOARDS) * (1 + 2))
Simon Glass8e959562014-09-05 19:00:20 -0600518
519 def testIncremental(self):
520 """Test building a branch twice - the second time should do nothing"""
Tom Rinie95eddc2019-10-07 17:17:36 -0400521 self._RunControl('-b', TEST_BRANCH, '-o', self._output_dir)
Simon Glass8e959562014-09-05 19:00:20 -0600522
523 # Each board has a mrproper, config, and then one make per commit
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600524 self.assertEqual(self._make_calls, len(BOARDS) * (self._commits + 1))
Simon Glass8e959562014-09-05 19:00:20 -0600525 self._make_calls = 0
Tom Rinie95eddc2019-10-07 17:17:36 -0400526 self._RunControl('-b', TEST_BRANCH, '-o', self._output_dir, clean_dir=False)
Simon Glass8e959562014-09-05 19:00:20 -0600527 self.assertEqual(self._make_calls, 0)
528 self.assertEqual(self._builder.count, self._total_builds)
529 self.assertEqual(self._builder.fail, 0)
530
531 def testForceBuild(self):
532 """The -f flag should force a rebuild"""
Tom Rinie95eddc2019-10-07 17:17:36 -0400533 self._RunControl('-b', TEST_BRANCH, '-o', self._output_dir)
Simon Glass8e959562014-09-05 19:00:20 -0600534 self._make_calls = 0
Tom Rinie95eddc2019-10-07 17:17:36 -0400535 self._RunControl('-b', TEST_BRANCH, '-f', '-o', self._output_dir, clean_dir=False)
Simon Glass6029af12020-04-09 15:08:51 -0600536 # Each board has a config and one make per commit
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600537 self.assertEqual(self._make_calls, len(BOARDS) * (self._commits + 1))
Simon Glass8e959562014-09-05 19:00:20 -0600538
539 def testForceReconfigure(self):
540 """The -f flag should force a rebuild"""
Tom Rinie95eddc2019-10-07 17:17:36 -0400541 self._RunControl('-b', TEST_BRANCH, '-C', '-o', self._output_dir)
Simon Glass6029af12020-04-09 15:08:51 -0600542 # Each commit has a config and make
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600543 self.assertEqual(self._make_calls, len(BOARDS) * self._commits * 2)
Simon Glass6029af12020-04-09 15:08:51 -0600544
Simon Glass6029af12020-04-09 15:08:51 -0600545 def testMrproper(self):
546 """The -f flag should force a rebuild"""
547 self._RunControl('-b', TEST_BRANCH, '-m', '-o', self._output_dir)
548 # Each board has a mkproper, config and then one make per commit
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600549 self.assertEqual(self._make_calls, len(BOARDS) * (self._commits + 2))
Simon Glass8e959562014-09-05 19:00:20 -0600550
551 def testErrors(self):
552 """Test handling of build errors"""
553 self._error['board2', 1] = 'fred\n'
Tom Rinie95eddc2019-10-07 17:17:36 -0400554 self._RunControl('-b', TEST_BRANCH, '-o', self._output_dir)
Simon Glass8e959562014-09-05 19:00:20 -0600555 self.assertEqual(self._builder.count, self._total_builds)
556 self.assertEqual(self._builder.fail, 1)
557
558 # Remove the error. This should have no effect since the commit will
559 # not be rebuilt
560 del self._error['board2', 1]
561 self._make_calls = 0
Tom Rinie95eddc2019-10-07 17:17:36 -0400562 self._RunControl('-b', TEST_BRANCH, '-o', self._output_dir, clean_dir=False)
Simon Glass8e959562014-09-05 19:00:20 -0600563 self.assertEqual(self._builder.count, self._total_builds)
564 self.assertEqual(self._make_calls, 0)
565 self.assertEqual(self._builder.fail, 1)
566
567 # Now use the -F flag to force rebuild of the bad commit
Tom Rinie95eddc2019-10-07 17:17:36 -0400568 self._RunControl('-b', TEST_BRANCH, '-o', self._output_dir, '-F', clean_dir=False)
Simon Glass8e959562014-09-05 19:00:20 -0600569 self.assertEqual(self._builder.count, self._total_builds)
570 self.assertEqual(self._builder.fail, 0)
Simon Glass6029af12020-04-09 15:08:51 -0600571 self.assertEqual(self._make_calls, 2)
Simon Glass4aeceb92014-09-05 19:00:22 -0600572
573 def testBranchWithSlash(self):
574 """Test building a branch with a '/' in the name"""
575 self._test_branch = '/__dev/__testbranch'
576 self._RunControl('-b', self._test_branch, clean_dir=False)
577 self.assertEqual(self._builder.count, self._total_builds)
578 self.assertEqual(self._builder.fail, 0)
Lothar Waßmannce6df922018-04-08 05:14:11 -0600579
Simon Glassff48a212020-04-17 17:51:33 -0600580 def testEnvironment(self):
581 """Test that the done and environment files are written to out-env"""
582 self._RunControl('-o', self._output_dir)
583 board0_dir = os.path.join(self._output_dir, 'current', 'board0')
584 self.assertTrue(os.path.exists(os.path.join(board0_dir, 'done')))
585 self.assertTrue(os.path.exists(os.path.join(board0_dir, 'out-env')))
586
Simon Glass93008e22021-04-11 16:27:28 +1200587 def testEnvironmentUnicode(self):
588 """Test there are no unicode errors when the env has non-ASCII chars"""
589 try:
590 varname = b'buildman_test_var'
591 os.environb[varname] = b'strange\x80chars'
592 self.assertEqual(0, self._RunControl('-o', self._output_dir))
593 board0_dir = os.path.join(self._output_dir, 'current', 'board0')
594 self.assertTrue(os.path.exists(os.path.join(board0_dir, 'done')))
595 self.assertTrue(os.path.exists(os.path.join(board0_dir, 'out-env')))
596 finally:
597 del os.environb[varname]
598
Simon Glassb6eb8cf2020-03-18 09:42:42 -0600599 def testWorkInOutput(self):
600 """Test the -w option which should write directly to the output dir"""
Simon Glass20751d62022-07-11 19:04:03 -0600601 board_list = boards.Boards()
Simon Glass127a2392022-07-11 19:04:02 -0600602 board_list.add_board(board.Board(*BOARDS[0]))
Simon Glassb6eb8cf2020-03-18 09:42:42 -0600603 self._RunControl('-o', self._output_dir, '-w', clean_dir=False,
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600604 brds=board_list)
Simon Glassb6eb8cf2020-03-18 09:42:42 -0600605 self.assertTrue(
606 os.path.exists(os.path.join(self._output_dir, 'u-boot')))
Simon Glasse3c85ab2020-04-17 17:51:34 -0600607 self.assertTrue(
608 os.path.exists(os.path.join(self._output_dir, 'done')))
609 self.assertTrue(
610 os.path.exists(os.path.join(self._output_dir, 'out-env')))
Simon Glassb6eb8cf2020-03-18 09:42:42 -0600611
612 def testWorkInOutputFail(self):
613 """Test the -w option failures"""
614 with self.assertRaises(SystemExit) as e:
615 self._RunControl('-o', self._output_dir, '-w', clean_dir=False)
616 self.assertIn("single board", str(e.exception))
617 self.assertFalse(
618 os.path.exists(os.path.join(self._output_dir, 'u-boot')))
619
Simon Glass20751d62022-07-11 19:04:03 -0600620 board_list = boards.Boards()
Simon Glass127a2392022-07-11 19:04:02 -0600621 board_list.add_board(board.Board(*BOARDS[0]))
Simon Glassb6eb8cf2020-03-18 09:42:42 -0600622 with self.assertRaises(SystemExit) as e:
623 self._RunControl('-b', self._test_branch, '-o', self._output_dir,
Simon Glassd4c6c8a2022-07-11 19:03:58 -0600624 '-w', clean_dir=False, brds=board_list)
Simon Glassb6eb8cf2020-03-18 09:42:42 -0600625 self.assertIn("single commit", str(e.exception))
Simon Glassd9c98632020-04-17 17:51:32 -0600626
Simon Glass20751d62022-07-11 19:04:03 -0600627 board_list = boards.Boards()
Simon Glass127a2392022-07-11 19:04:02 -0600628 board_list.add_board(board.Board(*BOARDS[0]))
Simon Glassd9c98632020-04-17 17:51:32 -0600629 with self.assertRaises(SystemExit) as e:
630 self._RunControl('-w', clean_dir=False)
631 self.assertIn("specify -o", str(e.exception))
Simon Glass9bf9a722021-04-11 16:27:27 +1200632
633 def testThreadExceptions(self):
634 """Test that exceptions in threads are reported"""
635 with test_util.capture_sys_output() as (stdout, stderr):
636 self.assertEqual(102, self._RunControl('-o', self._output_dir,
637 test_thread_exceptions=True))
Simon Glass9bac1672022-01-22 05:07:32 -0700638 self.assertIn(
639 'Thread exception (use -T0 to run without threads): test exception',
640 stdout.getvalue())
Tom Rini93ebd462022-11-09 19:14:53 -0700641
642 def testBlobs(self):
643 """Test handling of missing blobs"""
644 self._missing = True
645
646 board0_dir = os.path.join(self._output_dir, 'current', 'board0')
647 errfile = os.path.join(board0_dir, 'err')
648 logfile = os.path.join(board0_dir, 'log')
649
650 # We expect failure when there are missing blobs
651 result = self._RunControl('board0', '-o', self._output_dir)
652 self.assertEqual(100, result)
653 self.assertTrue(os.path.exists(os.path.join(board0_dir, 'done')))
654 self.assertTrue(os.path.exists(errfile))
655 self.assertIn(b"Filename 'fsp.bin' not found in input path",
656 tools.read_file(errfile))
657
658 def testBlobsAllowMissing(self):
659 """Allow missing blobs - still failure but a different exit code"""
660 self._missing = True
661 result = self._RunControl('board0', '-o', self._output_dir, '-M',
662 clean_dir=True)
663 self.assertEqual(101, result)
664 board0_dir = os.path.join(self._output_dir, 'current', 'board0')
665 errfile = os.path.join(board0_dir, 'err')
666 self.assertTrue(os.path.exists(errfile))
667 self.assertIn(b'Some images are invalid', tools.read_file(errfile))
668
669 def testBlobsWarning(self):
670 """Allow missing blobs and ignore warnings"""
671 self._missing = True
672 result = self._RunControl('board0', '-o', self._output_dir, '-MW')
673 self.assertEqual(0, result)
674 board0_dir = os.path.join(self._output_dir, 'current', 'board0')
675 errfile = os.path.join(board0_dir, 'err')
676 self.assertIn(b'Some images are invalid', tools.read_file(errfile))
677
678 def testBlobSettings(self):
679 """Test with no settings"""
680 self.assertEqual(False,
681 control.get_allow_missing(False, False, 1, False))
682 self.assertEqual(True,
683 control.get_allow_missing(True, False, 1, False))
684 self.assertEqual(False,
685 control.get_allow_missing(True, True, 1, False))
686
687 def testBlobSettingsAlways(self):
688 """Test the 'always' policy"""
689 bsettings.SetItem('global', 'allow-missing', 'always')
690 self.assertEqual(True,
691 control.get_allow_missing(False, False, 1, False))
692 self.assertEqual(False,
693 control.get_allow_missing(False, True, 1, False))
694
695 def testBlobSettingsBranch(self):
696 """Test the 'branch' policy"""
697 bsettings.SetItem('global', 'allow-missing', 'branch')
698 self.assertEqual(False,
699 control.get_allow_missing(False, False, 1, False))
700 self.assertEqual(True,
701 control.get_allow_missing(False, False, 1, True))
702 self.assertEqual(False,
703 control.get_allow_missing(False, True, 1, True))
704
705 def testBlobSettingsMultiple(self):
706 """Test the 'multiple' policy"""
707 bsettings.SetItem('global', 'allow-missing', 'multiple')
708 self.assertEqual(False,
709 control.get_allow_missing(False, False, 1, False))
710 self.assertEqual(True,
711 control.get_allow_missing(False, False, 2, False))
712 self.assertEqual(False,
713 control.get_allow_missing(False, True, 2, False))
714
715 def testBlobSettingsBranchMultiple(self):
716 """Test the 'branch multiple' policy"""
717 bsettings.SetItem('global', 'allow-missing', 'branch multiple')
718 self.assertEqual(False,
719 control.get_allow_missing(False, False, 1, False))
720 self.assertEqual(True,
721 control.get_allow_missing(False, False, 1, True))
722 self.assertEqual(True,
723 control.get_allow_missing(False, False, 2, False))
724 self.assertEqual(True,
725 control.get_allow_missing(False, False, 2, True))
726 self.assertEqual(False,
727 control.get_allow_missing(False, True, 2, True))
Simon Glass1382b1d2023-02-21 12:40:27 -0700728
Simon Glassf6bfcca2023-02-21 12:40:28 -0700729 def check_command(self, *extra_args):
730 """Run a command with the extra arguments and return the commands used
731
732 Args:
733 extra_args (list of str): List of extra arguments
734
735 Returns:
736 list of str: Lines returned in the out-cmd file
737 """
738 self._RunControl('-o', self._output_dir, *extra_args)
Simon Glass1382b1d2023-02-21 12:40:27 -0700739 board0_dir = os.path.join(self._output_dir, 'current', 'board0')
740 self.assertTrue(os.path.exists(os.path.join(board0_dir, 'done')))
741 cmd_fname = os.path.join(board0_dir, 'out-cmd')
742 self.assertTrue(os.path.exists(cmd_fname))
743 data = tools.read_file(cmd_fname)
Simon Glass828d70d2023-02-21 12:40:29 -0700744
745 config_fname = os.path.join(board0_dir, '.config')
746 self.assertTrue(os.path.exists(config_fname))
747 cfg_data = tools.read_file(config_fname)
748
749 return data.splitlines(), cfg_data
Simon Glassf6bfcca2023-02-21 12:40:28 -0700750
751 def testCmdFile(self):
752 """Test that the -cmd-out file is produced"""
Simon Glass828d70d2023-02-21 12:40:29 -0700753 lines = self.check_command()[0]
Simon Glass1382b1d2023-02-21 12:40:27 -0700754 self.assertEqual(2, len(lines))
755 self.assertRegex(lines[0], b'make O=/.*board0_defconfig')
756 self.assertRegex(lines[0], b'make O=/.*-s.*')
Simon Glassf6bfcca2023-02-21 12:40:28 -0700757
758 def testNoLto(self):
759 """Test that the --no-lto flag works"""
Simon Glass828d70d2023-02-21 12:40:29 -0700760 lines = self.check_command('-L')[0]
Simon Glassf6bfcca2023-02-21 12:40:28 -0700761 self.assertIn(b'NO_LTO=1', lines[0])
762
Simon Glass828d70d2023-02-21 12:40:29 -0700763 def testReproducible(self):
764 """Test that the -r flag works"""
765 lines, cfg_data = self.check_command('-r')
766 self.assertIn(b'SOURCE_DATE_EPOCH=0', lines[0])
767
768 # We should see CONFIG_LOCALVERSION_AUTO unset
769 self.assertEqual(b'''CONFIG_SOMETHING=1
770# CONFIG_LOCALVERSION_AUTO is not set
771''', cfg_data)
772
773 with test_util.capture_sys_output() as (stdout, stderr):
774 lines, cfg_data = self.check_command('-r', '-a', 'LOCALVERSION')
775 self.assertIn(b'SOURCE_DATE_EPOCH=0', lines[0])
776
777 # We should see CONFIG_LOCALVERSION_AUTO unset
778 self.assertEqual(b'''CONFIG_SOMETHING=1
779CONFIG_LOCALVERSION=y
780''', cfg_data)
781 self.assertIn('Not dropping LOCALVERSION_AUTO', stdout.getvalue())