Anders Blomdell / mbed-sdk-tools

Clone of official tools

test/examples/examples_lib.py@31:8ea194f6145b, 2017-01-04 (annotated)

Committer:
The Other Jimmy
Date:
Wed Jan 04 11:58:24 2017 -0600
Revision:
31:8ea194f6145b
Child:
35:da9c89f8be7d
Update tools to follow mbed-os tools release 5.3.1

Who changed what in which revision?

UserRevisionLine numberNew contents of line
The Other Jimmy 31:8ea194f6145b 1 """ Import and bulid a bunch of example programs
The Other Jimmy 31:8ea194f6145b 2
The Other Jimmy 31:8ea194f6145b 3 This library includes functions that are shared between the examples.py and
The Other Jimmy 31:8ea194f6145b 4 the update.py modules.
The Other Jimmy 31:8ea194f6145b 5
The Other Jimmy 31:8ea194f6145b 6 """
The Other Jimmy 31:8ea194f6145b 7 import os
The Other Jimmy 31:8ea194f6145b 8 from os.path import dirname, abspath, basename
The Other Jimmy 31:8ea194f6145b 9 import os.path
The Other Jimmy 31:8ea194f6145b 10 import sys
The Other Jimmy 31:8ea194f6145b 11 import subprocess
The Other Jimmy 31:8ea194f6145b 12 from shutil import rmtree
The Other Jimmy 31:8ea194f6145b 13
The Other Jimmy 31:8ea194f6145b 14 ROOT = abspath(dirname(dirname(dirname(dirname(__file__)))))
The Other Jimmy 31:8ea194f6145b 15 sys.path.insert(0, ROOT)
The Other Jimmy 31:8ea194f6145b 16
The Other Jimmy 31:8ea194f6145b 17 from tools.build_api import get_mbed_official_release
The Other Jimmy 31:8ea194f6145b 18 from tools.targets import TARGET_MAP
The Other Jimmy 31:8ea194f6145b 19 from tools.export import EXPORTERS
The Other Jimmy 31:8ea194f6145b 20
The Other Jimmy 31:8ea194f6145b 21 SUPPORTED_TOOLCHAINS = ["ARM", "IAR", "GCC_ARM"]
The Other Jimmy 31:8ea194f6145b 22 SUPPORTED_IDES = [exp for exp in EXPORTERS.keys() if exp != "cmsis" and exp != "zip"]
The Other Jimmy 31:8ea194f6145b 23
The Other Jimmy 31:8ea194f6145b 24
The Other Jimmy 31:8ea194f6145b 25 def print_list(lst):
The Other Jimmy 31:8ea194f6145b 26 """Prints to screen the contents of a list
The Other Jimmy 31:8ea194f6145b 27
The Other Jimmy 31:8ea194f6145b 28 Args:
The Other Jimmy 31:8ea194f6145b 29 lst - a list of any type, to be displayed
The Other Jimmy 31:8ea194f6145b 30
The Other Jimmy 31:8ea194f6145b 31 """
The Other Jimmy 31:8ea194f6145b 32 if lst:
The Other Jimmy 31:8ea194f6145b 33 for thing in lst:
The Other Jimmy 31:8ea194f6145b 34 print("# %s" % thing)
The Other Jimmy 31:8ea194f6145b 35
The Other Jimmy 31:8ea194f6145b 36
The Other Jimmy 31:8ea194f6145b 37 def print_category(results, index, message):
The Other Jimmy 31:8ea194f6145b 38 summary = [example for key, summ in results.iteritems()
The Other Jimmy 31:8ea194f6145b 39 for example in summ[index]]
The Other Jimmy 31:8ea194f6145b 40 if all(len(s) == 0 for s in summary):
The Other Jimmy 31:8ea194f6145b 41 return
The Other Jimmy 31:8ea194f6145b 42 print("#")
The Other Jimmy 31:8ea194f6145b 43 print("#" * 80)
The Other Jimmy 31:8ea194f6145b 44 print("# %s" % message)
The Other Jimmy 31:8ea194f6145b 45 print("#" * 80)
The Other Jimmy 31:8ea194f6145b 46 split_summ = [s.rsplit(" ", 1) for s in summary]
The Other Jimmy 31:8ea194f6145b 47
The Other Jimmy 31:8ea194f6145b 48 print_list(summary)
The Other Jimmy 31:8ea194f6145b 49
The Other Jimmy 31:8ea194f6145b 50
The Other Jimmy 31:8ea194f6145b 51 def print_summary(results, export=False):
The Other Jimmy 31:8ea194f6145b 52 """Prints to screen the results of compiling/exporting combinations of example programs,
The Other Jimmy 31:8ea194f6145b 53 targets and compile toolchains/IDEs.
The Other Jimmy 31:8ea194f6145b 54
The Other Jimmy 31:8ea194f6145b 55 Args:
The Other Jimmy 31:8ea194f6145b 56 results - results of the compilation stage. See compile_repos() and export_repos()
The Other Jimmy 31:8ea194f6145b 57 for details of the format.
The Other Jimmy 31:8ea194f6145b 58
The Other Jimmy 31:8ea194f6145b 59 """
The Other Jimmy 31:8ea194f6145b 60
The Other Jimmy 31:8ea194f6145b 61 print("#"*80)
The Other Jimmy 31:8ea194f6145b 62 print("# Examples compilation summary")
The Other Jimmy 31:8ea194f6145b 63 print("#"*80)
The Other Jimmy 31:8ea194f6145b 64
The Other Jimmy 31:8ea194f6145b 65 print_category(results, 2, "Passed example combinations")
The Other Jimmy 31:8ea194f6145b 66
The Other Jimmy 31:8ea194f6145b 67 second_result = "Failed example combinations" if not export else \
The Other Jimmy 31:8ea194f6145b 68 "Failed export example combinations"
The Other Jimmy 31:8ea194f6145b 69
The Other Jimmy 31:8ea194f6145b 70 print_category(results, 3, second_result)
The Other Jimmy 31:8ea194f6145b 71
The Other Jimmy 31:8ea194f6145b 72 if export:
The Other Jimmy 31:8ea194f6145b 73 print_category(results, 4, "Failed build combinations")
The Other Jimmy 31:8ea194f6145b 74 print_category(results, 5, "Skipped build combinations")
The Other Jimmy 31:8ea194f6145b 75
The Other Jimmy 31:8ea194f6145b 76 print("#")
The Other Jimmy 31:8ea194f6145b 77 print("#"*80)
The Other Jimmy 31:8ea194f6145b 78
The Other Jimmy 31:8ea194f6145b 79 def valid_choices(allowed_choices, all_choices):
The Other Jimmy 31:8ea194f6145b 80 if len(allowed_choices) > 0:
The Other Jimmy 31:8ea194f6145b 81 return [t for t in all_choices if t in allowed_choices]
The Other Jimmy 31:8ea194f6145b 82 else:
The Other Jimmy 31:8ea194f6145b 83 return all_choices
The Other Jimmy 31:8ea194f6145b 84
The Other Jimmy 31:8ea194f6145b 85
The Other Jimmy 31:8ea194f6145b 86 def target_cross_toolchain(allowed_targets, allowed_toolchains, features=[]):
The Other Jimmy 31:8ea194f6145b 87 """Generate pairs of target and toolchains
The Other Jimmy 31:8ea194f6145b 88
The Other Jimmy 31:8ea194f6145b 89 Args:
The Other Jimmy 31:8ea194f6145b 90 allowed_targets - a list of all possible targets
The Other Jimmy 31:8ea194f6145b 91 allowed_toolchains - a list of all possible toolchains
The Other Jimmy 31:8ea194f6145b 92
The Other Jimmy 31:8ea194f6145b 93 Kwargs:
The Other Jimmy 31:8ea194f6145b 94 features - the features that must be in the features array of a
The Other Jimmy 31:8ea194f6145b 95 target
The Other Jimmy 31:8ea194f6145b 96 """
The Other Jimmy 31:8ea194f6145b 97 for target in allowed_targets:
The Other Jimmy 31:8ea194f6145b 98 for toolchain in allowed_toolchains:
The Other Jimmy 31:8ea194f6145b 99 if all(feature in TARGET_MAP[target].features
The Other Jimmy 31:8ea194f6145b 100 for feature in features):
The Other Jimmy 31:8ea194f6145b 101 yield target, toolchain
The Other Jimmy 31:8ea194f6145b 102
The Other Jimmy 31:8ea194f6145b 103
The Other Jimmy 31:8ea194f6145b 104 def target_cross_ide(allowed_targets, allowed_ides, features=[], toolchains=[]):
The Other Jimmy 31:8ea194f6145b 105 """Generate pairs of target and ides
The Other Jimmy 31:8ea194f6145b 106
The Other Jimmy 31:8ea194f6145b 107 Args:
The Other Jimmy 31:8ea194f6145b 108 allowed_targets - a list of all possible targets
The Other Jimmy 31:8ea194f6145b 109 allowed_ides - a list of all possible IDEs
The Other Jimmy 31:8ea194f6145b 110
The Other Jimmy 31:8ea194f6145b 111 Kwargs:
The Other Jimmy 31:8ea194f6145b 112 features - the features that must be in the features array of a
The Other Jimmy 31:8ea194f6145b 113 target
The Other Jimmy 31:8ea194f6145b 114 """
The Other Jimmy 31:8ea194f6145b 115 for target in allowed_targets:
The Other Jimmy 31:8ea194f6145b 116 for ide in allowed_ides:
The Other Jimmy 31:8ea194f6145b 117 if (target in EXPORTERS[ide].TARGETS and
The Other Jimmy 31:8ea194f6145b 118 (not toolchains or EXPORTERS[ide].TOOLCHAIN in toolchains) and
The Other Jimmy 31:8ea194f6145b 119 all(feature in TARGET_MAP[target].features
The Other Jimmy 31:8ea194f6145b 120 for feature in features)):
The Other Jimmy 31:8ea194f6145b 121 yield target, ide
The Other Jimmy 31:8ea194f6145b 122
The Other Jimmy 31:8ea194f6145b 123
The Other Jimmy 31:8ea194f6145b 124 def get_repo_list(example):
The Other Jimmy 31:8ea194f6145b 125 """ Returns a list of all the repos associated with the specific example in the json
The Other Jimmy 31:8ea194f6145b 126 config file.
The Other Jimmy 31:8ea194f6145b 127 If there are repos listed under the mbed section then these will be returned as a
The Other Jimmy 31:8ea194f6145b 128 list. If not then the github single repo with be returned.
The Other Jimmy 31:8ea194f6145b 129 NOTE: This does not currently deal with multiple examples underneath a github
The Other Jimmy 31:8ea194f6145b 130 sourced exampe repo.
The Other Jimmy 31:8ea194f6145b 131
The Other Jimmy 31:8ea194f6145b 132 Args:
The Other Jimmy 31:8ea194f6145b 133 example - Example for which the repo list is requested
The Other Jimmy 31:8ea194f6145b 134 repos - The list of repos and types contained within that example in the json file
The Other Jimmy 31:8ea194f6145b 135
The Other Jimmy 31:8ea194f6145b 136 """
The Other Jimmy 31:8ea194f6145b 137 repos = []
The Other Jimmy 31:8ea194f6145b 138 if len(example['mbed']) > 0:
The Other Jimmy 31:8ea194f6145b 139 for repo in example['mbed']:
The Other Jimmy 31:8ea194f6145b 140 repos.append({
The Other Jimmy 31:8ea194f6145b 141 'repo': repo,
The Other Jimmy 31:8ea194f6145b 142 'type': 'hg'
The Other Jimmy 31:8ea194f6145b 143 })
The Other Jimmy 31:8ea194f6145b 144 else:
The Other Jimmy 31:8ea194f6145b 145 repos.append({
The Other Jimmy 31:8ea194f6145b 146 'repo': example['github'],
The Other Jimmy 31:8ea194f6145b 147 'type': 'git'
The Other Jimmy 31:8ea194f6145b 148 })
The Other Jimmy 31:8ea194f6145b 149 return repos
The Other Jimmy 31:8ea194f6145b 150
The Other Jimmy 31:8ea194f6145b 151
The Other Jimmy 31:8ea194f6145b 152 def source_repos(config, examples):
The Other Jimmy 31:8ea194f6145b 153 """ Imports each of the repos and its dependencies (.lib files) associated
The Other Jimmy 31:8ea194f6145b 154 with the specific examples name from the json config file. Note if
The Other Jimmy 31:8ea194f6145b 155 there is already a clone of the repo then it will first be removed to
The Other Jimmy 31:8ea194f6145b 156 ensure a clean, up to date cloning.
The Other Jimmy 31:8ea194f6145b 157 Args:
The Other Jimmy 31:8ea194f6145b 158 config - the json object imported from the file.
The Other Jimmy 31:8ea194f6145b 159
The Other Jimmy 31:8ea194f6145b 160 """
The Other Jimmy 31:8ea194f6145b 161 print("\nImporting example repos....\n")
The Other Jimmy 31:8ea194f6145b 162 for example in config['examples']:
The Other Jimmy 31:8ea194f6145b 163 for repo_info in get_repo_list(example):
The Other Jimmy 31:8ea194f6145b 164 name = basename(repo_info['repo'])
The Other Jimmy 31:8ea194f6145b 165 if name in examples:
The Other Jimmy 31:8ea194f6145b 166 if os.path.exists(name):
The Other Jimmy 31:8ea194f6145b 167 print("'%s' example directory already exists. Deleting..." % name)
The Other Jimmy 31:8ea194f6145b 168 rmtree(name)
The Other Jimmy 31:8ea194f6145b 169
The Other Jimmy 31:8ea194f6145b 170 subprocess.call(["mbed-cli", "import", repo_info['repo']])
The Other Jimmy 31:8ea194f6145b 171
The Other Jimmy 31:8ea194f6145b 172 def clone_repos(config, examples):
The Other Jimmy 31:8ea194f6145b 173 """ Clones each of the repos associated with the specific examples name from the
The Other Jimmy 31:8ea194f6145b 174 json config file. Note if there is already a clone of the repo then it will first
The Other Jimmy 31:8ea194f6145b 175 be removed to ensure a clean, up to date cloning.
The Other Jimmy 31:8ea194f6145b 176 Args:
The Other Jimmy 31:8ea194f6145b 177 config - the json object imported from the file.
The Other Jimmy 31:8ea194f6145b 178
The Other Jimmy 31:8ea194f6145b 179 """
The Other Jimmy 31:8ea194f6145b 180 print("\nCloning example repos....\n")
The Other Jimmy 31:8ea194f6145b 181 for example in config['examples']:
The Other Jimmy 31:8ea194f6145b 182 for repo_info in get_repo_list(example):
The Other Jimmy 31:8ea194f6145b 183 name = basename(repo_info['repo'])
The Other Jimmy 31:8ea194f6145b 184 if name in examples:
The Other Jimmy 31:8ea194f6145b 185 if os.path.exists(name):
The Other Jimmy 31:8ea194f6145b 186 print("'%s' example directory already exists. Deleting..." % name)
The Other Jimmy 31:8ea194f6145b 187 rmtree(name)
The Other Jimmy 31:8ea194f6145b 188
The Other Jimmy 31:8ea194f6145b 189 subprocess.call([repo_info['type'], "clone", repo_info['repo']])
The Other Jimmy 31:8ea194f6145b 190
The Other Jimmy 31:8ea194f6145b 191 def deploy_repos(config, examples):
The Other Jimmy 31:8ea194f6145b 192 """ If the example directory exists as provided by the json config file,
The Other Jimmy 31:8ea194f6145b 193 pull in the examples dependencies by using `mbed-cli deploy`.
The Other Jimmy 31:8ea194f6145b 194 Args:
The Other Jimmy 31:8ea194f6145b 195 config - the json object imported from the file.
The Other Jimmy 31:8ea194f6145b 196
The Other Jimmy 31:8ea194f6145b 197 """
The Other Jimmy 31:8ea194f6145b 198 print("\nDeploying example repos....\n")
The Other Jimmy 31:8ea194f6145b 199 for example in config['examples']:
The Other Jimmy 31:8ea194f6145b 200 for repo_info in get_repo_list(example):
The Other Jimmy 31:8ea194f6145b 201 name = basename(repo_info['repo'])
The Other Jimmy 31:8ea194f6145b 202 if name in examples:
The Other Jimmy 31:8ea194f6145b 203 if os.path.exists(name):
The Other Jimmy 31:8ea194f6145b 204 os.chdir(name)
The Other Jimmy 31:8ea194f6145b 205 subprocess.call(["mbed-cli", "deploy"])
The Other Jimmy 31:8ea194f6145b 206 os.chdir("..")
The Other Jimmy 31:8ea194f6145b 207 else:
The Other Jimmy 31:8ea194f6145b 208 print("'%s' example directory doesn't exist. Skipping..." % name)
The Other Jimmy 31:8ea194f6145b 209
The Other Jimmy 31:8ea194f6145b 210
The Other Jimmy 31:8ea194f6145b 211 def get_num_failures(results, export=False):
The Other Jimmy 31:8ea194f6145b 212 """ Returns the number of failed compilations from the results summary
The Other Jimmy 31:8ea194f6145b 213 Args:
The Other Jimmy 31:8ea194f6145b 214 results - results summary of the compilation stage. See compile_repos() for
The Other Jimmy 31:8ea194f6145b 215 details of the format.
The Other Jimmy 31:8ea194f6145b 216 num_failures
The Other Jimmy 31:8ea194f6145b 217
The Other Jimmy 31:8ea194f6145b 218 """
The Other Jimmy 31:8ea194f6145b 219 num_failures = 0
The Other Jimmy 31:8ea194f6145b 220
The Other Jimmy 31:8ea194f6145b 221 for key, val in results.iteritems():
The Other Jimmy 31:8ea194f6145b 222 num_failures = num_failures + len(val[3])
The Other Jimmy 31:8ea194f6145b 223 if export:
The Other Jimmy 31:8ea194f6145b 224 num_failures += len(val[4])
The Other Jimmy 31:8ea194f6145b 225
The Other Jimmy 31:8ea194f6145b 226 return num_failures
The Other Jimmy 31:8ea194f6145b 227
The Other Jimmy 31:8ea194f6145b 228 def export_repos(config, ides, targets, examples):
The Other Jimmy 31:8ea194f6145b 229 """Exports and builds combinations of example programs, targets and IDEs.
The Other Jimmy 31:8ea194f6145b 230
The Other Jimmy 31:8ea194f6145b 231 The results are returned in a [key: value] dictionary format:
The Other Jimmy 31:8ea194f6145b 232 Where key = The example name from the json config file
The Other Jimmy 31:8ea194f6145b 233 value = a list containing: pass_status, successes, export failures, build_failures,
The Other Jimmy 31:8ea194f6145b 234 and build_skips
The Other Jimmy 31:8ea194f6145b 235
The Other Jimmy 31:8ea194f6145b 236 where pass_status = The overall pass status for the export of the full
The Other Jimmy 31:8ea194f6145b 237 set of example programs comprising the example suite.
The Other Jimmy 31:8ea194f6145b 238 IE they must build and export) True if all examples pass, false otherwise
The Other Jimmy 31:8ea194f6145b 239 successes = list of examples that exported and built (if possible)
The Other Jimmy 31:8ea194f6145b 240 If the exporter has no build functionality, then it is a pass
The Other Jimmy 31:8ea194f6145b 241 if exported
The Other Jimmy 31:8ea194f6145b 242 export_failures = list of examples that failed to export.
The Other Jimmy 31:8ea194f6145b 243 build_failures = list of examples that failed to build
The Other Jimmy 31:8ea194f6145b 244 build_skips = list of examples that cannot build
The Other Jimmy 31:8ea194f6145b 245
The Other Jimmy 31:8ea194f6145b 246 Both successes and failures contain the example name, target and IDE
The Other Jimmy 31:8ea194f6145b 247
The Other Jimmy 31:8ea194f6145b 248 Args:
The Other Jimmy 31:8ea194f6145b 249 config - the json object imported from the file.
The Other Jimmy 31:8ea194f6145b 250 ides - List of IDES to export to
The Other Jimmy 31:8ea194f6145b 251 """
The Other Jimmy 31:8ea194f6145b 252 results = {}
The Other Jimmy 31:8ea194f6145b 253 print("\nExporting example repos....\n")
The Other Jimmy 31:8ea194f6145b 254 for example in config['examples']:
The Other Jimmy 31:8ea194f6145b 255 if example['name'] not in examples:
The Other Jimmy 31:8ea194f6145b 256 continue
The Other Jimmy 31:8ea194f6145b 257
The Other Jimmy 31:8ea194f6145b 258 export_failures = []
The Other Jimmy 31:8ea194f6145b 259 build_failures = []
The Other Jimmy 31:8ea194f6145b 260 build_skips = []
The Other Jimmy 31:8ea194f6145b 261 successes = []
The Other Jimmy 31:8ea194f6145b 262 exported = True
The Other Jimmy 31:8ea194f6145b 263 pass_status = True
The Other Jimmy 31:8ea194f6145b 264 if example['export']:
The Other Jimmy 31:8ea194f6145b 265 for repo_info in get_repo_list(example):
The Other Jimmy 31:8ea194f6145b 266 example_project_name = basename(repo_info['repo'])
The Other Jimmy 31:8ea194f6145b 267 os.chdir(example_project_name)
The Other Jimmy 31:8ea194f6145b 268 # Check that the target, IDE, and features combinations are valid and return a
The Other Jimmy 31:8ea194f6145b 269 # list of valid combinations to work through
The Other Jimmy 31:8ea194f6145b 270 for target, ide in target_cross_ide(valid_choices(example['targets'], targets),
The Other Jimmy 31:8ea194f6145b 271 valid_choices(example['exporters'], ides),
The Other Jimmy 31:8ea194f6145b 272 example['features'], example['toolchains']):
The Other Jimmy 31:8ea194f6145b 273 example_name = "{} {} {}".format(example_project_name, target,
The Other Jimmy 31:8ea194f6145b 274 ide)
The Other Jimmy 31:8ea194f6145b 275 def status(message):
The Other Jimmy 31:8ea194f6145b 276 print(message + " %s" % example_name)
The Other Jimmy 31:8ea194f6145b 277 sys.stdout.flush()
The Other Jimmy 31:8ea194f6145b 278
The Other Jimmy 31:8ea194f6145b 279 status("Exporting")
The Other Jimmy 31:8ea194f6145b 280 proc = subprocess.Popen(["mbed-cli", "export", "-i", ide,
The Other Jimmy 31:8ea194f6145b 281 "-m", target])
The Other Jimmy 31:8ea194f6145b 282 proc.wait()
The Other Jimmy 31:8ea194f6145b 283 if proc.returncode:
The Other Jimmy 31:8ea194f6145b 284 export_failures.append(example_name)
The Other Jimmy 31:8ea194f6145b 285 status("FAILURE exporting")
The Other Jimmy 31:8ea194f6145b 286 else:
The Other Jimmy 31:8ea194f6145b 287 status("SUCCESS exporting")
The Other Jimmy 31:8ea194f6145b 288 status("Building")
The Other Jimmy 31:8ea194f6145b 289 try:
The Other Jimmy 31:8ea194f6145b 290 if EXPORTERS[ide].build(example_project_name):
The Other Jimmy 31:8ea194f6145b 291 status("FAILURE building")
The Other Jimmy 31:8ea194f6145b 292 build_failures.append(example_name)
The Other Jimmy 31:8ea194f6145b 293 else:
The Other Jimmy 31:8ea194f6145b 294 status("SUCCESS building")
The Other Jimmy 31:8ea194f6145b 295 successes.append(example_name)
The Other Jimmy 31:8ea194f6145b 296 except TypeError:
The Other Jimmy 31:8ea194f6145b 297 successes.append(example_name)
The Other Jimmy 31:8ea194f6145b 298 build_skips.append(example_name)
The Other Jimmy 31:8ea194f6145b 299 os.chdir("..")
The Other Jimmy 31:8ea194f6145b 300
The Other Jimmy 31:8ea194f6145b 301 if len(build_failures+export_failures) > 0:
The Other Jimmy 31:8ea194f6145b 302 pass_status= False
The Other Jimmy 31:8ea194f6145b 303 else:
The Other Jimmy 31:8ea194f6145b 304 exported = False
The Other Jimmy 31:8ea194f6145b 305
The Other Jimmy 31:8ea194f6145b 306 results[example['name']] = [exported, pass_status, successes,
The Other Jimmy 31:8ea194f6145b 307 export_failures, build_failures, build_skips]
The Other Jimmy 31:8ea194f6145b 308
The Other Jimmy 31:8ea194f6145b 309 return results
The Other Jimmy 31:8ea194f6145b 310
The Other Jimmy 31:8ea194f6145b 311
The Other Jimmy 31:8ea194f6145b 312 def compile_repos(config, toolchains, targets, examples):
The Other Jimmy 31:8ea194f6145b 313 """Compiles combinations of example programs, targets and compile chains.
The Other Jimmy 31:8ea194f6145b 314
The Other Jimmy 31:8ea194f6145b 315 The results are returned in a [key: value] dictionary format:
The Other Jimmy 31:8ea194f6145b 316 Where key = The example name from the json config file
The Other Jimmy 31:8ea194f6145b 317 value = a list containing: pass_status, successes, and failures
The Other Jimmy 31:8ea194f6145b 318
The Other Jimmy 31:8ea194f6145b 319 where pass_status = The overall pass status for the compilation of the full
The Other Jimmy 31:8ea194f6145b 320 set of example programs comprising the example suite.
The Other Jimmy 31:8ea194f6145b 321 True if all examples pass, false otherwise
The Other Jimmy 31:8ea194f6145b 322 successes = list of passing examples.
The Other Jimmy 31:8ea194f6145b 323 failures = list of failing examples.
The Other Jimmy 31:8ea194f6145b 324
The Other Jimmy 31:8ea194f6145b 325 Both successes and failures contain the example name, target and compile chain
The Other Jimmy 31:8ea194f6145b 326
The Other Jimmy 31:8ea194f6145b 327 Args:
The Other Jimmy 31:8ea194f6145b 328 config - the json object imported from the file.
The Other Jimmy 31:8ea194f6145b 329 toolchains - List of toolchains to compile for.
The Other Jimmy 31:8ea194f6145b 330 results - results of the compilation stage.
The Other Jimmy 31:8ea194f6145b 331
The Other Jimmy 31:8ea194f6145b 332 """
The Other Jimmy 31:8ea194f6145b 333 results = {}
The Other Jimmy 31:8ea194f6145b 334 print("\nCompiling example repos....\n")
The Other Jimmy 31:8ea194f6145b 335 for example in config['examples']:
The Other Jimmy 31:8ea194f6145b 336 if example['name'] not in examples:
The Other Jimmy 31:8ea194f6145b 337 continue
The Other Jimmy 31:8ea194f6145b 338 failures = []
The Other Jimmy 31:8ea194f6145b 339 successes = []
The Other Jimmy 31:8ea194f6145b 340 compiled = True
The Other Jimmy 31:8ea194f6145b 341 pass_status = True
The Other Jimmy 31:8ea194f6145b 342 if example['compile']:
The Other Jimmy 31:8ea194f6145b 343 for repo_info in get_repo_list(example):
The Other Jimmy 31:8ea194f6145b 344 name = basename(repo_info['repo'])
The Other Jimmy 31:8ea194f6145b 345 os.chdir(name)
The Other Jimmy 31:8ea194f6145b 346
The Other Jimmy 31:8ea194f6145b 347 # Check that the target, toolchain and features combinations are valid and return a
The Other Jimmy 31:8ea194f6145b 348 # list of valid combinations to work through
The Other Jimmy 31:8ea194f6145b 349 for target, toolchain in target_cross_toolchain(valid_choices(example['targets'], targets),
The Other Jimmy 31:8ea194f6145b 350 valid_choices(example['toolchains'], toolchains),
The Other Jimmy 31:8ea194f6145b 351 example['features']):
The Other Jimmy 31:8ea194f6145b 352 proc = subprocess.Popen(["mbed-cli", "compile", "-t", toolchain,
The Other Jimmy 31:8ea194f6145b 353 "-m", target, "--silent"])
The Other Jimmy 31:8ea194f6145b 354 proc.wait()
The Other Jimmy 31:8ea194f6145b 355 example_summary = "{} {} {}".format(name, target, toolchain)
The Other Jimmy 31:8ea194f6145b 356 if proc.returncode:
The Other Jimmy 31:8ea194f6145b 357 failures.append(example_summary)
The Other Jimmy 31:8ea194f6145b 358 else:
The Other Jimmy 31:8ea194f6145b 359 successes.append(example_summary)
The Other Jimmy 31:8ea194f6145b 360 os.chdir("..")
The Other Jimmy 31:8ea194f6145b 361
The Other Jimmy 31:8ea194f6145b 362 # If there are any compilation failures for the example 'set' then the overall status is fail.
The Other Jimmy 31:8ea194f6145b 363 if len(failures) > 0:
The Other Jimmy 31:8ea194f6145b 364 pass_status = False
The Other Jimmy 31:8ea194f6145b 365 else:
The Other Jimmy 31:8ea194f6145b 366 compiled = False
The Other Jimmy 31:8ea194f6145b 367
The Other Jimmy 31:8ea194f6145b 368 results[example['name']] = [compiled, pass_status, successes, failures]
The Other Jimmy 31:8ea194f6145b 369
The Other Jimmy 31:8ea194f6145b 370 return results
The Other Jimmy 31:8ea194f6145b 371
The Other Jimmy 31:8ea194f6145b 372
The Other Jimmy 31:8ea194f6145b 373 def update_mbedos_version(config, tag, examples):
The Other Jimmy 31:8ea194f6145b 374 """ For each example repo identified in the config json object, update the version of
The Other Jimmy 31:8ea194f6145b 375 mbed-os to that specified by the supplied GitHub tag. This function assumes that each
The Other Jimmy 31:8ea194f6145b 376 example repo has already been cloned.
The Other Jimmy 31:8ea194f6145b 377
The Other Jimmy 31:8ea194f6145b 378 Args:
The Other Jimmy 31:8ea194f6145b 379 config - the json object imported from the file.
The Other Jimmy 31:8ea194f6145b 380 tag - GitHub tag corresponding to a version of mbed-os to upgrade to.
The Other Jimmy 31:8ea194f6145b 381
The Other Jimmy 31:8ea194f6145b 382 """
The Other Jimmy 31:8ea194f6145b 383 print("Updating mbed-os in examples to version %s\n" % tag)
The Other Jimmy 31:8ea194f6145b 384 for example in config['examples']:
The Other Jimmy 31:8ea194f6145b 385 if example['name'] not in examples:
The Other Jimmy 31:8ea194f6145b 386 continue
The Other Jimmy 31:8ea194f6145b 387 for repo_info in get_repo_list(example):
The Other Jimmy 31:8ea194f6145b 388 update_dir = basename(repo_info['repo']) + "/mbed-os"
The Other Jimmy 31:8ea194f6145b 389 print("\nChanging dir to %s\n" % update_dir)
The Other Jimmy 31:8ea194f6145b 390 os.chdir(update_dir)
The Other Jimmy 31:8ea194f6145b 391 subprocess.call(["mbed-cli", "update", tag, "--clean"])
The Other Jimmy 31:8ea194f6145b 392 os.chdir("../..")
The Other Jimmy 31:8ea194f6145b 393