blob: f1a4a3bc3f88a2014856df6abbfd8c1eab29e37f [file] [log] [blame]
Patrick Rohr92d74122022-10-21 15:50:52 -07001#!/usr/bin/env python3
2# Copyright (C) 2022 The Android Open Source Project
3#
4# Licensed under the Apache License, Version 2.0 (the "License");
5# you may not use this file except in compliance with the License.
6# You may obtain a copy of the License at
7#
8# http://www.apache.org/licenses/LICENSE-2.0
9#
10# Unless required by applicable law or agreed to in writing, software
11# distributed under the License is distributed on an "AS IS" BASIS,
12# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13# See the License for the specific language governing permissions and
14# limitations under the License.
15
16# This tool translates a collection of BUILD.gn files into a mostly equivalent
17# Android.bp file for the Android Soong build system. The input to the tool is a
18# JSON description of the GN build definition generated with the following
19# command:
20#
21# gn desc out --format=json --all-toolchains "//*" > desc.json
22#
23# The tool is then given a list of GN labels for which to generate Android.bp
24# build rules. The dependencies for the GN labels are squashed to the generated
25# Android.bp target, except for actions which get their own genrule. Some
26# libraries are also mapped to their Android equivalents -- see |builtin_deps|.
27
28import argparse
29import collections
30import json
Patrick Rohr16228942022-10-26 14:00:26 -070031import logging as log
Patrick Rohr92d74122022-10-21 15:50:52 -070032import os
33import re
34import sys
Motomu Utsumic6277d92022-11-07 15:15:17 +090035import copy
Patrick Rohr92d74122022-10-21 15:50:52 -070036
37import gn_utils
38
Patrick Rohr92d74122022-10-21 15:50:52 -070039ROOT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
40
Patrick Rohr06296362022-11-10 21:37:33 -080041# Default targets to translate to the blueprint file.
42default_targets = [
43 '//components/cronet/android:cronet',
44]
45
Patrick Rohr92d74122022-10-21 15:50:52 -070046# Defines a custom init_rc argument to be applied to the corresponding output
47# blueprint target.
48target_initrc = {
Patrick Rohrc36ef422022-10-25 10:38:05 -070049 # TODO: this can probably be removed.
Patrick Rohr92d74122022-10-21 15:50:52 -070050}
51
52target_host_supported = [
Patrick Rohrdc383942022-10-25 10:45:29 -070053 # TODO: remove if this is not useful for the cronet build.
Patrick Rohr92d74122022-10-21 15:50:52 -070054]
55
Patrick Rohr92d74122022-10-21 15:50:52 -070056# Proto target groups which will be made public.
57proto_groups = {
Patrick Rohr95212a22022-10-25 09:53:13 -070058 # TODO: remove if this is not used for the cronet build.
Patrick Rohr92d74122022-10-21 15:50:52 -070059}
60
61# All module names are prefixed with this string to avoid collisions.
Patrick Rohr61b2bad2022-10-25 10:49:20 -070062module_prefix = 'cronet_aml_'
Patrick Rohr92d74122022-10-21 15:50:52 -070063
64# Shared libraries which are directly translated to Android system equivalents.
65shared_library_allowlist = [
66 'android',
67 'android.hardware.atrace@1.0',
68 'android.hardware.health@2.0',
69 'android.hardware.health-V1-ndk',
70 'android.hardware.power.stats@1.0',
71 "android.hardware.power.stats-V1-cpp",
72 'base',
73 'binder',
74 'binder_ndk',
75 'cutils',
76 'hidlbase',
77 'hidltransport',
78 'hwbinder',
79 'incident',
80 'log',
81 'services',
82 'statssocket',
83 "tracingproxy",
84 'utils',
85]
86
87# Static libraries which are directly translated to Android system equivalents.
88static_library_allowlist = [
89 'statslog_perfetto',
90]
91
Patrick Rohrd9dd3b92022-11-09 16:15:30 -080092# Include directories that will be removed from all targets.
93local_include_dirs_denylist = [
Patrick Rohrd9dd3b92022-11-09 16:15:30 -080094]
95
Patrick Rohr92d74122022-10-21 15:50:52 -070096# Name of the module which settings such as compiler flags for all other
97# modules.
98defaults_module = module_prefix + 'defaults'
99
100# Location of the project in the Android source tree.
Patrick Rohr76ceeb52022-11-07 14:18:58 -0800101tree_path = 'external/chromium_org'
Patrick Rohr92d74122022-10-21 15:50:52 -0700102
103# Path for the protobuf sources in the standalone build.
104buildtools_protobuf_src = '//buildtools/protobuf/src'
105
106# Location of the protobuf src dir in the Android source tree.
107android_protobuf_src = 'external/protobuf/src'
108
109# Compiler flags which are passed through to the blueprint.
Motomu Utsumic8b7bea2022-11-16 18:12:44 +0900110cflag_allowlist = [
Motomu Utsumicf68d732022-11-16 18:15:21 +0900111 # needed for zlib:zlib
112 "-mpclmul",
113 # needed for zlib:zlib
114 "-mssse3",
Motomu Utsumic8b7bea2022-11-16 18:12:44 +0900115]
Patrick Rohr92d74122022-10-21 15:50:52 -0700116
Patrick Rohr92d74122022-10-21 15:50:52 -0700117# Additional arguments to apply to Android.bp rules.
118additional_args = {
Patrick Rohr2267a0a2022-11-08 18:59:34 -0800119 # TODO: remove if not needed.
Patrick Rohrd90025f2022-11-11 14:18:35 -0800120 'cronet_aml_components_cronet_android_cronet': [
121 ('linker_scripts', {
122 'base/android/library_loader/anchor_functions.lds',
123 }),
124 ],
Patrick Rohrbb0956e2022-11-09 15:37:16 -0800125 'cronet_aml_net_net': [
Patrick Rohr9f4d3e32022-11-09 16:37:31 -0800126 ('export_static_lib_headers', {
127 'cronet_aml_net_third_party_quiche_quiche',
128 'cronet_aml_crypto_crypto',
129 }),
Mohannad Farrag627dc912022-11-11 19:00:26 +0000130 # When a code is compiled under rtti(cronet) that depends on another code(net)
131 # that doesn't depend on rtti. undefined symbol: typeinfo 'class' errors appears.
132 ('rtti', True), # go/undefined-symbol-typeinfo
Mohannad Farrag37388fa2022-11-10 20:42:13 +0000133 ],
Patrick Rohr92d74122022-10-21 15:50:52 -0700134}
135
Patrick Rohr92d74122022-10-21 15:50:52 -0700136# Android equivalents for third-party libraries that the upstream project
137# depends on.
138builtin_deps = {
Patrick Rohr14ee0932022-11-15 12:10:27 -0800139 '//net/tools/root_store_tool:root_store_tool':
140 lambda x: None,
Patrick Rohr92d74122022-10-21 15:50:52 -0700141}
142
143# ----------------------------------------------------------------------------
144# End of configuration.
145# ----------------------------------------------------------------------------
146
147
148class Error(Exception):
149 pass
150
151
152class ThrowingArgumentParser(argparse.ArgumentParser):
153
154 def __init__(self, context):
155 super(ThrowingArgumentParser, self).__init__()
156 self.context = context
157
158 def error(self, message):
159 raise Error('%s: %s' % (self.context, message))
160
161
162def write_blueprint_key_value(output, name, value, sort=True):
163 """Writes a Blueprint key-value pair to the output"""
164
165 if isinstance(value, bool):
166 if value:
167 output.append(' %s: true,' % name)
168 else:
169 output.append(' %s: false,' % name)
170 return
171 if not value:
172 return
173 if isinstance(value, set):
174 value = sorted(value)
175 if isinstance(value, list):
176 output.append(' %s: [' % name)
177 for item in sorted(value) if sort else value:
178 output.append(' "%s",' % item)
179 output.append(' ],')
180 return
181 if isinstance(value, Target):
182 value.to_string(output)
183 return
184 if isinstance(value, dict):
185 kv_output = []
186 for k, v in value.items():
187 write_blueprint_key_value(kv_output, k, v)
188
189 output.append(' %s: {' % name)
190 for line in kv_output:
191 output.append(' %s' % line)
192 output.append(' },')
193 return
194 output.append(' %s: "%s",' % (name, value))
195
196
197class Target(object):
198 """A target-scoped part of a module"""
199
200 def __init__(self, name):
201 self.name = name
202 self.shared_libs = set()
203 self.static_libs = set()
204 self.whole_static_libs = set()
205 self.cflags = set()
206 self.dist = dict()
207 self.strip = dict()
208 self.stl = None
209
210 def to_string(self, output):
211 nested_out = []
212 self._output_field(nested_out, 'shared_libs')
213 self._output_field(nested_out, 'static_libs')
214 self._output_field(nested_out, 'whole_static_libs')
215 self._output_field(nested_out, 'cflags')
216 self._output_field(nested_out, 'stl')
217 self._output_field(nested_out, 'dist')
218 self._output_field(nested_out, 'strip')
219
220 if nested_out:
221 output.append(' %s: {' % self.name)
222 for line in nested_out:
223 output.append(' %s' % line)
224 output.append(' },')
225
226 def _output_field(self, output, name, sort=True):
227 value = getattr(self, name)
228 return write_blueprint_key_value(output, name, value, sort)
229
230
231class Module(object):
232 """A single module (e.g., cc_binary, cc_test) in a blueprint."""
233
234 def __init__(self, mod_type, name, gn_target):
235 self.type = mod_type
236 self.gn_target = gn_target
237 self.name = name
238 self.srcs = set()
Patrick Rohr07876662022-11-15 22:55:23 -0800239 self.comment = 'GN: ' + gn_target
Patrick Rohr92d74122022-10-21 15:50:52 -0700240 self.shared_libs = set()
241 self.static_libs = set()
242 self.whole_static_libs = set()
243 self.runtime_libs = set()
244 self.tools = set()
245 self.cmd = None
246 self.host_supported = False
Patrick Rohrcdda6322022-11-15 22:44:16 -0800247 self.device_supported = True
Patrick Rohr92d74122022-10-21 15:50:52 -0700248 self.vendor_available = False
249 self.init_rc = set()
250 self.out = set()
251 self.export_include_dirs = set()
252 self.generated_headers = set()
253 self.export_generated_headers = set()
Patrick Rohrbb0956e2022-11-09 15:37:16 -0800254 self.export_static_lib_headers = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700255 self.defaults = set()
256 self.cflags = set()
257 self.include_dirs = set()
Motomu Utsumi97fb1812022-11-01 13:08:10 +0900258 self.local_include_dirs = []
Patrick Rohr92d74122022-10-21 15:50:52 -0700259 self.header_libs = set()
260 self.required = set()
Patrick Rohr3d8c7282022-10-27 13:36:31 -0700261 self.tool_files = set()
Patrick Rohrbfdc5fd2022-11-16 10:03:49 -0800262 # target contains a dict of Targets indexed by os_arch.
263 # example: { 'android_x86': Target('android_x86')
264 self.target = dict()
265 self.target['android'] = Target('android')
266 self.target['host'] = Target('host')
Patrick Rohr92d74122022-10-21 15:50:52 -0700267 self.stl = None
Patrick Rohrb8f830a2022-10-31 11:18:57 -0700268 self.cpp_std = None
Patrick Rohr92d74122022-10-21 15:50:52 -0700269 self.dist = dict()
270 self.strip = dict()
271 self.data = set()
272 self.apex_available = set()
273 self.min_sdk_version = None
274 self.proto = dict()
Patrick Rohrd90025f2022-11-11 14:18:35 -0800275 self.linker_scripts = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700276 # The genrule_XXX below are properties that must to be propagated back
277 # on the module(s) that depend on the genrule.
278 self.genrule_headers = set()
279 self.genrule_srcs = set()
280 self.genrule_shared_libs = set()
Patrick Rohra1a27872022-10-31 11:57:14 -0700281 self.genrule_header_libs = set()
Patrick Rohr92d74122022-10-21 15:50:52 -0700282 self.version_script = None
283 self.test_suites = set()
284 self.test_config = None
285 self.stubs = {}
Mohannad Farrag37388fa2022-11-10 20:42:13 +0000286 self.cppflags = set()
287 self.rtti = False
Motomu Utsumi87c2a482022-11-14 14:57:46 +0900288 self.arch = dict()
Patrick Rohr92d74122022-10-21 15:50:52 -0700289
290 def to_string(self, output):
291 if self.comment:
292 output.append('// %s' % self.comment)
293 output.append('%s {' % self.type)
294 self._output_field(output, 'name')
295 self._output_field(output, 'srcs')
296 self._output_field(output, 'shared_libs')
297 self._output_field(output, 'static_libs')
298 self._output_field(output, 'whole_static_libs')
299 self._output_field(output, 'runtime_libs')
300 self._output_field(output, 'tools')
301 self._output_field(output, 'cmd', sort=False)
302 if self.host_supported:
303 self._output_field(output, 'host_supported')
Patrick Rohrcdda6322022-11-15 22:44:16 -0800304 if not self.device_supported:
305 self._output_field(output, 'device_supported')
Patrick Rohr92d74122022-10-21 15:50:52 -0700306 if self.vendor_available:
307 self._output_field(output, 'vendor_available')
308 self._output_field(output, 'init_rc')
309 self._output_field(output, 'out')
310 self._output_field(output, 'export_include_dirs')
311 self._output_field(output, 'generated_headers')
312 self._output_field(output, 'export_generated_headers')
Patrick Rohrbb0956e2022-11-09 15:37:16 -0800313 self._output_field(output, 'export_static_lib_headers')
Patrick Rohr92d74122022-10-21 15:50:52 -0700314 self._output_field(output, 'defaults')
315 self._output_field(output, 'cflags')
316 self._output_field(output, 'include_dirs')
Motomu Utsumi97fb1812022-11-01 13:08:10 +0900317 self._output_field(output, 'local_include_dirs', sort=False)
Patrick Rohr92d74122022-10-21 15:50:52 -0700318 self._output_field(output, 'header_libs')
319 self._output_field(output, 'required')
320 self._output_field(output, 'dist')
321 self._output_field(output, 'strip')
322 self._output_field(output, 'tool_files')
323 self._output_field(output, 'data')
324 self._output_field(output, 'stl')
Patrick Rohrb8f830a2022-10-31 11:18:57 -0700325 self._output_field(output, 'cpp_std')
Patrick Rohr92d74122022-10-21 15:50:52 -0700326 self._output_field(output, 'apex_available')
327 self._output_field(output, 'min_sdk_version')
328 self._output_field(output, 'version_script')
329 self._output_field(output, 'test_suites')
330 self._output_field(output, 'test_config')
331 self._output_field(output, 'stubs')
332 self._output_field(output, 'proto')
Patrick Rohrd90025f2022-11-11 14:18:35 -0800333 self._output_field(output, 'linker_scripts')
Mohannad Farrag37388fa2022-11-10 20:42:13 +0000334 self._output_field(output, 'cppflags')
335 if self.rtti:
336 self._output_field(output, 'rtti')
Motomu Utsumi87c2a482022-11-14 14:57:46 +0900337 self._output_field(output, 'arch')
Patrick Rohr92d74122022-10-21 15:50:52 -0700338
339 target_out = []
Patrick Rohrbfdc5fd2022-11-16 10:03:49 -0800340 for arch, target in self.target.items():
341 # _output_field calls getattr(self, arch).
342 setattr(self, arch, target)
343 self._output_field(target_out, arch)
344
Patrick Rohr92d74122022-10-21 15:50:52 -0700345 if target_out:
346 output.append(' target: {')
347 for line in target_out:
348 output.append(' %s' % line)
349 output.append(' },')
350
Patrick Rohr92d74122022-10-21 15:50:52 -0700351 output.append('}')
352 output.append('')
353
354 def add_android_static_lib(self, lib):
355 if self.type == 'cc_binary_host':
356 raise Exception('Adding Android static lib for host tool is unsupported')
357 elif self.host_supported:
Patrick Rohrbfdc5fd2022-11-16 10:03:49 -0800358 self.target['android'].static_libs.add(lib)
Patrick Rohr92d74122022-10-21 15:50:52 -0700359 else:
360 self.static_libs.add(lib)
361
362 def add_android_shared_lib(self, lib):
363 if self.type == 'cc_binary_host':
364 raise Exception('Adding Android shared lib for host tool is unsupported')
365 elif self.host_supported:
Patrick Rohrbfdc5fd2022-11-16 10:03:49 -0800366 self.target['android'].shared_libs.add(lib)
Patrick Rohr92d74122022-10-21 15:50:52 -0700367 else:
368 self.shared_libs.add(lib)
369
370 def _output_field(self, output, name, sort=True):
371 value = getattr(self, name)
372 return write_blueprint_key_value(output, name, value, sort)
373
374
375class Blueprint(object):
376 """In-memory representation of an Android.bp file."""
377
378 def __init__(self):
379 self.modules = {}
380
381 def add_module(self, module):
382 """Adds a new module to the blueprint, replacing any existing module
383 with the same name.
384
385 Args:
386 module: Module instance.
387 """
388 self.modules[module.name] = module
389
390 def to_string(self, output):
Patrick Rohr23f26192022-10-25 09:45:22 -0700391 for m in sorted(self.modules.values(), key=lambda m: m.name):
Patrick Rohr92d74122022-10-21 15:50:52 -0700392 m.to_string(output)
393
394
395def label_to_module_name(label):
396 """Turn a GN label (e.g., //:perfetto_tests) into a module name."""
Patrick Rohr07876662022-11-15 22:55:23 -0800397 module = re.sub(r'^//:?', '', label)
Patrick Rohr92d74122022-10-21 15:50:52 -0700398 module = re.sub(r'[^a-zA-Z0-9_]', '_', module)
Motomu Utsumi3fde1482022-11-14 15:55:21 +0900399
400 # If it's required to support multi toolchain for more targets, it's better to avoid hardcoding.
401 if label == "//third_party/boringssl:boringssl_asm(//build/toolchain/android:android_clang_x86)":
402 module += "_x86"
403
Patrick Rohr92d74122022-10-21 15:50:52 -0700404 if not module.startswith(module_prefix):
405 return module_prefix + module
406 return module
407
408
409def is_supported_source_file(name):
410 """Returns True if |name| can appear in a 'srcs' list."""
Patrick Rohrf9f3a992022-11-10 19:40:32 -0800411 return os.path.splitext(name)[1] in ['.c', '.cc', '.cpp', '.java', '.proto', '.S']
Patrick Rohr92d74122022-10-21 15:50:52 -0700412
413
414def create_proto_modules(blueprint, gn, target):
415 """Generate genrules for a proto GN target.
416
417 GN actions are used to dynamically generate files during the build. The
418 Soong equivalent is a genrule. This function turns a specific kind of
419 genrule which turns .proto files into source and header files into a pair
420 equivalent genrules.
421
422 Args:
423 blueprint: Blueprint instance which is being generated.
424 target: gn_utils.Target object.
425
426 Returns:
427 The source_genrule module.
428 """
429 assert (target.type == 'proto_library')
430
Motomu Utsumid58c1dc2022-11-16 18:04:46 +0900431 protoc_gn_target_name = "//third_party/protobuf:protoc(//build/toolchain/linux:clang_x64)"
432 protoc_module_name = label_to_module_name(protoc_gn_target_name)
433 tools = {protoc_module_name}
Motomu Utsumid7e0e422022-11-08 17:49:52 +0900434 cpp_out_dir = '$(genDir)/%s/%s/' % (tree_path, target.proto_in_dir)
Patrick Rohr92d74122022-10-21 15:50:52 -0700435 target_module_name = label_to_module_name(target.name)
436
437 # In GN builds the proto path is always relative to the output directory
438 # (out/tmp.xxx).
Motomu Utsumid58c1dc2022-11-16 18:04:46 +0900439 cmd = ['$(location %s)' % protoc_module_name]
Motomu Utsumid7e0e422022-11-08 17:49:52 +0900440 cmd += ['--proto_path=%s/%s' % (tree_path, target.proto_in_dir)]
Patrick Rohr92d74122022-10-21 15:50:52 -0700441
442 if buildtools_protobuf_src in target.proto_paths:
443 cmd += ['--proto_path=%s' % android_protobuf_src]
444
445 # We don't generate any targets for source_set proto modules because
446 # they will be inlined into other modules if required.
447 if target.proto_plugin == 'source_set':
448 return None
449
450 # Descriptor targets only generate a single target.
451 if target.proto_plugin == 'descriptor':
452 out = '{}.bin'.format(target_module_name)
453
454 cmd += ['--descriptor_set_out=$(out)']
455 cmd += ['$(in)']
456
457 descriptor_module = Module('genrule', target_module_name, target.name)
458 descriptor_module.cmd = ' '.join(cmd)
459 descriptor_module.out = [out]
460 descriptor_module.tools = tools
461 blueprint.add_module(descriptor_module)
462
463 # Recursively extract the .proto files of all the dependencies and
464 # add them to srcs.
465 descriptor_module.srcs.update(
466 gn_utils.label_to_path(src) for src in target.sources)
467 for dep in target.transitive_proto_deps:
468 current_target = gn.get_target(dep)
469 descriptor_module.srcs.update(
470 gn_utils.label_to_path(src) for src in current_target.sources)
471
472 return descriptor_module
473
474 # We create two genrules for each proto target: one for the headers and
475 # another for the sources. This is because the module that depends on the
476 # generated files needs to declare two different types of dependencies --
477 # source files in 'srcs' and headers in 'generated_headers' -- and it's not
478 # valid to generate .h files from a source dependency and vice versa.
479 source_module_name = target_module_name + '_gen'
480 source_module = Module('genrule', source_module_name, target.name)
481 blueprint.add_module(source_module)
482 source_module.srcs.update(
483 gn_utils.label_to_path(src) for src in target.sources)
484
485 header_module = Module('genrule', source_module_name + '_headers',
486 target.name)
487 blueprint.add_module(header_module)
488 header_module.srcs = set(source_module.srcs)
489
490 # TODO(primiano): at some point we should remove this. This was introduced
491 # by aosp/1108421 when adding "protos/" to .proto include paths, in order to
492 # avoid doing multi-repo changes and allow old clients in the android tree
493 # to still do the old #include "perfetto/..." rather than
494 # #include "protos/perfetto/...".
495 header_module.export_include_dirs = {'.', 'protos'}
Patrick Rohr2267a0a2022-11-08 18:59:34 -0800496 # Since the .cc file and .h get created by a different gerule target, they
497 # are not put in the same intermediate path, so local includes do not work
498 # without explictily exporting the include dir.
499 header_module.export_include_dirs.add(target.proto_in_dir)
Patrick Rohr92d74122022-10-21 15:50:52 -0700500
501 source_module.genrule_srcs.add(':' + source_module.name)
502 source_module.genrule_headers.add(header_module.name)
503
504 if target.proto_plugin == 'proto':
505 suffixes = ['pb']
506 source_module.genrule_shared_libs.add('libprotobuf-cpp-lite')
507 cmd += ['--cpp_out=lite=true:' + cpp_out_dir]
508 elif target.proto_plugin == 'protozero':
509 suffixes = ['pbzero']
510 plugin = create_modules_from_target(blueprint, gn, protozero_plugin)
511 tools.add(plugin.name)
512 cmd += ['--plugin=protoc-gen-plugin=$(location %s)' % plugin.name]
513 cmd += ['--plugin_out=wrapper_namespace=pbzero:' + cpp_out_dir]
514 elif target.proto_plugin == 'cppgen':
515 suffixes = ['gen']
516 plugin = create_modules_from_target(blueprint, gn, cppgen_plugin)
517 tools.add(plugin.name)
518 cmd += ['--plugin=protoc-gen-plugin=$(location %s)' % plugin.name]
519 cmd += ['--plugin_out=wrapper_namespace=gen:' + cpp_out_dir]
520 elif target.proto_plugin == 'ipc':
521 suffixes = ['ipc']
522 plugin = create_modules_from_target(blueprint, gn, ipc_plugin)
523 tools.add(plugin.name)
524 cmd += ['--plugin=protoc-gen-plugin=$(location %s)' % plugin.name]
525 cmd += ['--plugin_out=wrapper_namespace=gen:' + cpp_out_dir]
526 else:
527 raise Error('Unsupported proto plugin: %s' % target.proto_plugin)
528
529 cmd += ['$(in)']
530 source_module.cmd = ' '.join(cmd)
531 header_module.cmd = source_module.cmd
532 source_module.tools = tools
533 header_module.tools = tools
534
535 for sfx in suffixes:
536 source_module.out.update('%s/%s' %
537 (tree_path, src.replace('.proto', '.%s.cc' % sfx))
538 for src in source_module.srcs)
539 header_module.out.update('%s/%s' %
540 (tree_path, src.replace('.proto', '.%s.h' % sfx))
541 for src in header_module.srcs)
542 return source_module
543
544
545def create_amalgamated_sql_metrics_module(blueprint, target):
546 bp_module_name = label_to_module_name(target.name)
547 module = Module('genrule', bp_module_name, target.name)
Patrick Rohr3d8c7282022-10-27 13:36:31 -0700548 module.tool_files.add('tools/gen_amalgamated_sql_metrics.py')
Patrick Rohr92d74122022-10-21 15:50:52 -0700549 module.cmd = ' '.join([
550 '$(location tools/gen_amalgamated_sql_metrics.py)',
551 '--cpp_out=$(out)',
552 '$(in)',
553 ])
554 module.genrule_headers.add(module.name)
555 module.out.update(target.outputs)
556 module.srcs.update(gn_utils.label_to_path(src) for src in target.inputs)
557 blueprint.add_module(module)
558 return module
559
560
561def create_cc_proto_descriptor_module(blueprint, target):
562 bp_module_name = label_to_module_name(target.name)
563 module = Module('genrule', bp_module_name, target.name)
Patrick Rohr3d8c7282022-10-27 13:36:31 -0700564 module.tool_files.add('tools/gen_cc_proto_descriptor.py')
Patrick Rohr92d74122022-10-21 15:50:52 -0700565 module.cmd = ' '.join([
566 '$(location tools/gen_cc_proto_descriptor.py)', '--gen_dir=$(genDir)',
567 '--cpp_out=$(out)', '$(in)'
568 ])
569 module.genrule_headers.add(module.name)
570 module.srcs.update(
571 ':' + label_to_module_name(dep) for dep in target.proto_deps)
572 module.srcs.update(
573 gn_utils.label_to_path(src)
574 for src in target.inputs
575 if "tmp.gn_utils" not in src)
576 module.out.update(target.outputs)
577 blueprint.add_module(module)
578 return module
579
580
581def create_gen_version_module(blueprint, target, bp_module_name):
582 module = Module('genrule', bp_module_name, gn_utils.GEN_VERSION_TARGET)
583 script_path = gn_utils.label_to_path(target.script)
584 module.genrule_headers.add(bp_module_name)
Patrick Rohr3d8c7282022-10-27 13:36:31 -0700585 module.tool_files.add(script_path)
Patrick Rohr92d74122022-10-21 15:50:52 -0700586 module.out.update(target.outputs)
587 module.srcs.update(gn_utils.label_to_path(src) for src in target.inputs)
588 module.cmd = ' '.join([
589 'python3 $(location %s)' % script_path, '--no_git',
590 '--changelog=$(location CHANGELOG)', '--cpp_out=$(out)'
591 ])
592 blueprint.add_module(module)
593 return module
594
595
596def create_proto_group_modules(blueprint, gn, module_name, target_names):
597 # TODO(lalitm): today, we're only adding a Java lite module because that's
598 # the only one used in practice. In the future, if we need other target types
599 # (e.g. C++, Java full etc.) add them here.
600 bp_module_name = label_to_module_name(module_name) + '_java_protos'
601 module = Module('java_library', bp_module_name, bp_module_name)
602 module.comment = f'''GN: [{', '.join(target_names)}]'''
603 module.proto = {'type': 'lite', 'canonical_path_from_root': False}
604
605 for name in target_names:
606 target = gn.get_target(name)
607 module.srcs.update(gn_utils.label_to_path(src) for src in target.sources)
608 for dep_label in target.transitive_proto_deps:
609 dep = gn.get_target(dep_label)
610 module.srcs.update(gn_utils.label_to_path(src) for src in dep.sources)
611
612 blueprint.add_module(module)
613
Motomu Utsumia6c33152022-11-02 18:21:55 +0900614# HACK: Need to support build_cofig_gen flexibly instead of hardcoding
615# build_config_gen generates srcjar by executing gcc via gcc_preprocess.py but gcc is not
616# available in genrule sandbox. Also gcc path is not configurable.
617# Under the //net:net, gcc_preprocess.py is only used for build_config_gen.
618# So, for now, hardcoding BuildConfig.java and generates srcjar by soong_zip.
619def override_build_config_gen(module):
620 module.tool_files.clear()
621 module.tools.add("soong_zip")
622 cmd = [
623 "echo",
624 "\\\"package org.chromium.build;\\n",
625 "public class BuildConfig {\\n",
626 "public static boolean IS_MULTIDEX_ENABLED ;\\n",
627 "public static boolean ENABLE_ASSERTS = true;\\n",
628 "public static boolean IS_UBSAN ;\\n",
629 "public static boolean IS_CHROME_BRANDED ;\\n",
630 "public static int R_STRING_PRODUCT_VERSION ;\\n",
631 "public static int MIN_SDK_VERSION = 1;\\n",
632 "public static boolean BUNDLES_SUPPORTED ;\\n",
633 "public static boolean IS_INCREMENTAL_INSTALL ;\\n",
634 "public static boolean ISOLATED_SPLITS_ENABLED ;\\n",
635 "public static boolean IS_FOR_TEST ;\\n",
636 "}\\n\\\"",
637 "> $(genDir)/BuildConfig.java &&",
638 "$(location soong_zip) -o $(out) -srcjar -f $(genDir)/BuildConfig.java"
639 ]
640 NEWLINE = ' " +\n "'
641 module.cmd = NEWLINE.join(cmd)
642 return module
643
Mohannad Farragbab6c892022-11-02 14:09:46 +0000644def create_action_foreach_modules(blueprint, target):
645 """ The following assumes that rebase_path exists in the args.
646 The args of an action_foreach contains hints about which output files are generated
647 by which source files.
648 This is copied directly from the args
649 "gen/net/base/registry_controlled_domains/{{source_name_part}}-reversed-inc.cc"
650 So each source file will generate an output whose name is the {source_name-reversed-inc.cc}
651 """
652 new_args = []
Motomu Utsumi56afcac2022-11-04 12:58:30 +0900653 for i, src in enumerate(sorted(target.sources)):
Mohannad Farragbab6c892022-11-02 14:09:46 +0000654 # don't add script arg for the first source -- create_action_module
655 # already does this.
656 if i != 0:
657 new_args.append('&& python3 $(location %s)' %
658 gn_utils.label_to_path(target.script))
659 for arg in target.args:
660 if '{{source}}' in arg:
661 new_args.append('$(location %s)' % (gn_utils.label_to_path(src)))
662 elif '{{source_name_part}}' in arg:
663 source_name_part = src.split("/")[-1] # Get the file name only
664 source_name_part = source_name_part.split(".")[0] # Remove the extension (Ex: .cc)
665 file_name = arg.replace('{{source_name_part}}', source_name_part).split("/")[-1]
666 # file_name represent the output file name. But we need the whole path
667 # This can be found from target.outputs.
668 for out in target.outputs:
669 if out.endswith(file_name):
670 new_args.append('$(location %s)' % out)
671 else:
672 new_args.append(arg)
673
674 target.args = new_args
675 return create_action_module(blueprint, target)
Motomu Utsumia6c33152022-11-02 18:21:55 +0900676
Patrick Rohr7be99032022-10-31 11:54:19 -0700677def create_action_module(blueprint, target):
678 bp_module_name = label_to_module_name(target.name)
679 module = Module('genrule', bp_module_name, target.name)
680
Patrick Rohr9b99a982022-10-28 11:00:57 -0700681 # Convert ['--param=value'] to ['--param', 'value'] for consistency.
682 # TODO: we may want to only do this for python scripts arguments. If argparse
683 # is used, this transformation is safe.
684 target.args = [str for it in target.args for str in it.split('=')]
685
Motomu Utsumibf569d42022-10-28 16:47:34 +0900686 if target.script == "//build/write_buildflag_header.py":
687 # write_buildflag_header.py writes result to args.genDir/args.output
688 # So, override args.genDir by '.' so that args.output=$(out) works
Patrick Rohrde568a22022-10-28 09:22:35 -0700689 for i, val in enumerate(target.args):
690 if val == '--gen-dir':
691 target.args[i + 1] = '.'
Patrick Rohrfa972402022-11-01 11:54:35 -0700692 elif val == '--output':
693 target.args[i + 1] = '$(out)'
694
695 elif target.script == '//build/write_build_date_header.py':
696 target.args[0] = '$(out)'
Patrick Rohr0db9f852022-10-27 13:49:57 -0700697
Patrick Rohr8acccca2022-10-28 10:39:06 -0700698 elif target.script == '//base/android/jni_generator/jni_generator.py':
Patrick Rohrc5cc21a2022-10-31 11:57:49 -0700699 # chromium builds against a prebuilt ndk that contains the jni_headers, so
700 # a dependency is never explicitly created.
701 module.genrule_header_libs.add('jni_headers')
Patrick Rohr131ba282022-10-31 16:36:20 -0700702 needs_javap = False
Patrick Rohr8acccca2022-10-28 10:39:06 -0700703 for i, val in enumerate(target.args):
Motomu Utsumi6f9139d2022-10-31 12:15:19 +0900704 if val == '--output_dir':
Patrick Rohrf1d08f82022-10-31 14:43:59 -0700705 # replace --output_dir gen/jni_headers/... with --output_dir $(genDir)/...
706 target.args[i + 1] = re.sub('^gen/jni_headers', '$(genDir)', target.args[i + 1])
Patrick Rohrbec0c8c2022-11-01 11:56:38 -0700707 elif val == '--input_file':
Patrick Rohr8acccca2022-10-28 10:39:06 -0700708 # --input_file supports both .class specifiers or source files as arguments.
709 # Only source files need to be wrapped inside a $(location <label>) tag.
710 if re.match('.*\.class$', target.args[i + 1]):
711 continue
712 # replace --input_file ../../... with --input_file $(location ...)
713 # TODO: put inside function
714 filename = re.sub('^\.\./\.\./', '', target.args[i + 1])
715 target.args[i + 1] = '$(location %s)' % filename
Patrick Rohrbec0c8c2022-11-01 11:56:38 -0700716 elif val == '--includes' and 'jni_generator_helper' in target.args[i + 1]:
Patrick Rohrd89e8bf2022-10-31 14:51:05 -0700717 # delete all leading ../
718 target.args[i + 1] = re.sub('^(\.\./)+', '', target.args[i + 1])
Patrick Rohrbec0c8c2022-11-01 11:56:38 -0700719 elif val == '--prev_output_dir':
Patrick Rohr131ba282022-10-31 16:36:20 -0700720 # this is not needed for aosp builds.
721 target.args[i] = ''
722 target.args[i + 1] = ''
Patrick Rohrbec0c8c2022-11-01 11:56:38 -0700723 elif val == '--jar_file':
Patrick Rohr131ba282022-10-31 16:36:20 -0700724 # delete leading ../../ and add path to javap
725 filename = re.sub('^\.\./\.\./', '', target.args[i + 1])
726 target.args[i + 1] = '$(location %s)' % filename
727 needs_javap = True
728
729 if needs_javap:
730 target.args.append('--javap')
731 target.args.append('$$(find out/.path -name javap)')
Patrick Rohrf1d08f82022-10-31 14:43:59 -0700732 # fix target.output directory to match #include statements.
733 target.outputs = [re.sub('^jni_headers/', '', out) for out in target.outputs]
Patrick Rohr8acccca2022-10-28 10:39:06 -0700734
Patrick Rohrf6d2b612022-11-09 12:30:26 -0800735 elif target.script == '//base/android/jni_generator/jni_registration_generator.py':
736 # jni_registration_generator.py pulls in some config dependencies that we
737 # do not handle. Remove them.
738 # TODO: find a better way to do this.
739 target.deps.clear()
740
Motomu Utsumied009082022-11-10 16:26:44 +0900741 target.inputs = [file for file in target.inputs if not file.startswith('//out/')]
Motomu Utsumi6b4acaa2022-11-10 16:13:24 +0900742 for i, val in enumerate(target.args):
743 if val in ['--depfile', '--srcjar-path', '--header-path']:
744 target.args[i + 1] = re.sub('^gen', '$(genDir)', target.args[i + 1])
Motomu Utsumi7bc2fcc2022-11-10 17:09:54 +0900745 if val == '--sources-files':
746 target.args[i + 1] = '$(genDir)/java.sources'
Motomu Utsumi47d122f2022-11-10 17:32:23 +0900747 elif val == '--sources-exclusions':
748 # update_jni_registration_module removes them from the srcs of the module
749 # It might be better to remove sources by '--sources-exclusions'
750 target.args[i] = ''
751 target.args[i + 1] = ''
Motomu Utsumi6b4acaa2022-11-10 16:13:24 +0900752
Patrick Rohr245df582022-11-01 16:59:45 -0700753 elif target.script == '//build/android/gyp/write_build_config.py':
754 for i, val in enumerate(target.args):
755 if val == '--depfile':
756 # Depfile is not used, so no need to generate it.
757 target.args[i] = ''
758 target.args[i + 1] = ''
759 elif val in ['--deps-configs', '--bundled-srcjars']:
760 args = target.args[i + 1]
761 if args == '[]':
762 continue
763 # strip surrounding [] and split by ", "
764 args = args.strip('[]').split(', ')
765 # strip surrounding ""
766 args = [arg.strip('"') for arg in args]
767 # remove leading gen/
768 args = [re.sub('^gen/', '', arg) for arg in args]
769 # wrap filename in \"$(location filename)\"
770 args = ['\"$(location %s)\"' % arg for arg in args]
771 # join args with ", " and wrap in []
772 target.args[i + 1] = '[%s]' % ', '.join(args)
773
774 elif val == '--public-deps-configs':
775 # TODO: implement.
776 pass
777
778 elif val == '--build-config':
779 # json output of this script
780 target.args[i + 1] = re.sub('^gen', '$(genDir)', target.args[i + 1])
781
782 elif val in ['--unprocessed-jar-path', '--interface-jar-path',
783 '--device-jar-path', '--host-jar-path']:
784 # jar path can be within sources (../../) or output generated by
785 # another genrule (obj/)
786 filename = re.sub('^\.\./\.\./', '', target.args[i + 1])
787 filename = re.sub('^obj/', '', target.args[i + 1])
788 target.args[i + 1] = '$(location %s)' % filename
789
790 elif val == '--proguard-configs':
791 args = target.args[i + 1]
792 if args == '[]':
793 continue
794 # TODO: consider adding helpers to deal with argument lists
795 # strip surrounding [] and split by ", ", then strip surrounding ""
796 args = args.strip('[]').split(', ')
797 args = [arg.strip('"') for arg in args]
798 # remove leading ../../
799 args = [re.sub('^\.\./\.\./', '', arg) for arg in args]
800 # add dependency on proguard config file, so a $(location) wrapper can be used.
801 module.tool_files.update(args)
802 # wrap filename in \"$(location filename)\"
803 args = ['$(location %s)' % arg for arg in args]
804 target.args[i + 1] = '[%s]' % ', '.join(args)
Motomu Utsumi1caa39b2022-11-02 18:38:13 +0900805 elif target.script == "//build/android/gyp/write_native_libraries_java.py":
806 for i, val in enumerate(target.args):
807 if val == '--output':
808 target.args[i + 1] = '$(out)'
Motomu Utsumi26211dc2022-11-02 19:38:47 +0900809 elif target.script == "//tools/grit/stamp_grit_sources.py":
810 target.outputs = [re.sub('^\/\/', '', out) for out in target.outputs]
811 # Directory that contains grit scripts
812 target.args[0] = '`dirname $(location tools/grit/grit.py)`'
813 # Path to the stamp file
814 target.args[1] = '$(out)'
815 # Script tries to create args[2] file but this is not in the output.
816 # Specifying file under $(genDir) so that parent directory exists.
817 # If this file is used by other module, we may need to add this file to the outputs.
818 target.args[2] = '$(genDir)/' + target.args[2].split('/')[-1]
Mohannad Farrag033c9d62022-11-07 14:55:49 +0000819 elif target.script == "//tools/grit/grit.py":
820 for i, val in enumerate(target.args):
821 if val == '-i':
822 # Delete leading ../..
823 filename = re.sub('^\.\./\.\./', '', target.args[i + 1])
824 target.args[i + 1] = '$(location %s)' % filename
825 elif val == '-o':
826 filename = re.sub('^gen/', '', target.args[i + 1])
827 if filename == "net":
828 # This is a directory not a file
829 target.args[i + 1] = '$(genDir)/net'
830 else:
831 # This is an output fil
832 target.args[i + 1] = '$(location %s)' % filename
833 elif val == '--depfile':
834 # The depfile is replaced by adding /tools/**/*.py to the tools_files
835 # This is basically just globbing all the needed sources by hardcoding.
836 module.tool_files.update([
837 "tools/grit/**/*.py",
838 "third_party/six/src/six.py" # This is not picked up by default. Must be added
839 ])
840
841 # Delete the depfile argument
842 target.args[i] = ' '
843 target.args[i + 1] = ' '
844 elif val == '--input':
845 # Delete leading ../..
846 filename = re.sub('^\.\./\.\./', '', target.args[i + 1])
847 # This is an output file so use $(location %s)
848 target.args[i + 1] = '$(location %s)' % filename
Motomu Utsumia0cc6662022-11-09 15:22:27 +0900849 elif target.script == "//net/tools/dafsa/make_dafsa.py":
850 # This script generates .cc files but source (registry_controlled_domain.cc) in the target that
851 # depends on this target includes .cc file this script generates.
852 module.genrule_headers.add(module.name)
Motomu Utsumi847a6d32022-11-09 17:32:06 +0900853 elif target.script == "//build/util/version.py":
Motomu Utsumib0a49e42022-11-09 18:12:27 +0900854 # android_chrome_version.py is not specified in anywhere but version.py imports this file
855 module.tool_files.add('build/util/android_chrome_version.py')
Motomu Utsumi847a6d32022-11-09 17:32:06 +0900856 for i, val in enumerate(target.args):
857 if val.startswith('../../'):
858 filename = re.sub('^\.\./\.\./', '', val)
859 target.args[i] = '$(location %s)' % filename
Motomu Utsumiee279c52022-11-09 17:46:27 +0900860 elif val == '-e':
861 # arg for -e EVAL option should be passed in -e PATCH_HI=int(PATCH)//256 format.
862 target.args[i + 1] = '%s=\'%s\'' % (target.args[i + 1], target.args[i + 2])
863 target.args[i + 2] = ''
Motomu Utsumi438f2c22022-11-09 18:16:40 +0900864 elif val == '-o':
865 target.args[i + 1] = '$(out)'
Patrick Rohr245df582022-11-01 16:59:45 -0700866
Patrick Rohr2041d5b2022-10-26 15:07:53 -0700867 script = gn_utils.label_to_path(target.script)
Patrick Rohr3d8c7282022-10-27 13:36:31 -0700868 module.tool_files.add(script)
Patrick Rohre1a853e2022-10-26 12:31:39 -0700869
Patrick Rohr8a4e2bd2022-10-27 13:06:16 -0700870 # Handle passing parameters via response file by piping them into the script
871 # and reading them from /dev/stdin.
872 response_file = '{{response_file_name}}'
873 use_response_file = response_file in target.args
874 if use_response_file:
875 # Replace {{response_file_contents}} with /dev/stdin
876 target.args = ['/dev/stdin' if it == response_file else it for it in target.args]
877
Patrick Rohr4b0952d2022-11-01 12:42:31 -0700878 # escape " and \$ in target.args.
879 # once all actions are properly implemented, this may not be necessary anymore.
880 # TODO: is this the right place to do this?
881 target.args = [arg.replace('"', r'\"') for arg in target.args]
882 target.args = [arg.replace(r'\$', r'\\$') for arg in target.args]
883
Patrick Rohr9b99a982022-10-28 11:00:57 -0700884 # put all args on a new line for better diffs.
885 NEWLINE = ' " +\n "'
886 arg_string = NEWLINE.join(target.args)
Patrick Rohr2041d5b2022-10-26 15:07:53 -0700887 module.cmd = '$(location %s) %s' % (script, arg_string)
Patrick Rohre1a853e2022-10-26 12:31:39 -0700888
Patrick Rohr8a4e2bd2022-10-27 13:06:16 -0700889 if use_response_file:
890 # Pipe response file contents into script
Patrick Rohr9b99a982022-10-28 11:00:57 -0700891 module.cmd = 'echo \'%s\' |%s%s' % (target.response_file_contents, NEWLINE, module.cmd)
Patrick Rohr8a4e2bd2022-10-27 13:06:16 -0700892
Motomu Utsumi7e983832022-11-10 16:04:46 +0900893 if any(os.path.splitext(it)[1] == '.h' for it in target.outputs):
Patrick Rohr67f4d432022-10-26 16:04:15 -0700894 module.genrule_headers.add(bp_module_name)
Patrick Rohre1a853e2022-10-26 12:31:39 -0700895
Patrick Rohr0db9f852022-10-27 13:49:57 -0700896 # gn treats inputs and sources for actions equally.
897 # soong only supports source files inside srcs, non-source files are added as
898 # tool_files dependency.
899 for it in target.sources or target.inputs:
900 if is_supported_source_file(it):
901 module.srcs.add(gn_utils.label_to_path(it))
902 else:
903 module.tool_files.add(gn_utils.label_to_path(it))
Patrick Rohre1a853e2022-10-26 12:31:39 -0700904
Patrick Rohr15a2c302022-10-26 15:08:57 -0700905 # Actions using template "action_with_pydeps" also put script inside inputs.
906 # TODO: it might make sense to filter inputs inside GnParser.
907 if script in module.srcs:
908 module.srcs.remove(script)
909
Patrick Rohre1a853e2022-10-26 12:31:39 -0700910 module.out.update(target.outputs)
Motomu Utsumia6c33152022-11-02 18:21:55 +0900911
912 if target.name == "//build/android:build_config_gen":
913 module = override_build_config_gen(module)
Motomu Utsumi26211dc2022-11-02 19:38:47 +0900914 elif target.script == "//tools/grit/stamp_grit_sources.py":
915 # stamp_grit_sources.py is not executable
916 module.cmd = "python " + module.cmd
Mohannad Farrag18d7b512022-11-07 13:26:30 +0000917 elif target.script == "//base/android/jni_generator/jni_generator.py":
918 # android_jar.classes should be part of the tools as it list implicit classes
919 # for the script to generate JNI headers.
920 module.tool_files.add("base/android/jni_generator/android_jar.classes")
Motomu Utsumi7bc2fcc2022-11-10 17:09:54 +0900921 elif target.script == '//base/android/jni_generator/jni_registration_generator.py':
Motomu Utsumi9ca466b2022-11-10 17:12:29 +0900922 # jni_registration_generator.py doesn't work with python2
923 module.cmd = "python3 " + module.cmd
Motomu Utsumi7bc2fcc2022-11-10 17:09:54 +0900924 # Path in the original sources file does not work in genrule.
925 # So creating sources file in cmd based on the srcs of this target.
926 # Adding ../$(current_dir)/ to the head because jni_registration_generator.py uses the files
927 # whose path startswith(..)
928 commands = ["current_dir=`basename \\\`pwd\\\``;",
929 "for f in $(in);",
930 "do",
931 "echo \\\"../$$current_dir/$$f\\\" >> $(genDir)/java.sources;",
932 "done;",
933 module.cmd]
Motomu Utsumi2a892d22022-11-10 18:03:20 +0900934
935 # .h file jni_registration_generator.py generates has #define with directory name.
936 # With the genrule env that contains "." which is invalid. So replace that at the end of cmd.
Mohannad Farrag7c0f0982022-11-10 14:39:49 +0000937 commands.append(";sed -i -e 's/OUT_SOONG_.TEMP_SBOX_.*_OUT/GEN/g' ")
Motomu Utsumi2a892d22022-11-10 18:03:20 +0900938 commands.append("$(genDir)/components/cronet/android/cronet_jni_registration.h")
Motomu Utsumi7bc2fcc2022-11-10 17:09:54 +0900939 module.cmd = NEWLINE.join(commands)
Motomu Utsumia6c33152022-11-02 18:21:55 +0900940
Patrick Rohre1a853e2022-10-26 12:31:39 -0700941 blueprint.add_module(module)
942 return module
943
944
Patrick Rohr92d74122022-10-21 15:50:52 -0700945
946def _get_cflags(target):
Motomu Utsumic8b7bea2022-11-16 18:12:44 +0900947 cflags = {flag for flag in target.cflags if flag in cflag_allowlist}
Motomu Utsumifa7e9262022-10-26 19:43:02 +0900948 # Consider proper allowlist or denylist if needed
949 cflags |= set("-D%s" % define.replace("\"", "\\\"") for define in target.defines)
Motomu Utsumi50cf83e2022-11-15 20:26:37 +0900950 # -DANDROID is added by default but target.defines contain -DANDROID if it's required.
951 # So adding -UANDROID to cancel default -DANDROID if it's not specified.
952 # This is needed for some targets(e.g. symbolize)
953 if "ANDROID" not in target.defines:
954 cflags.add("-UANDROID")
Patrick Rohr92d74122022-10-21 15:50:52 -0700955 return cflags
956
957
958def create_modules_from_target(blueprint, gn, gn_target_name):
959 """Generate module(s) for a given GN target.
960
961 Given a GN target name, generate one or more corresponding modules into a
962 blueprint. The only case when this generates >1 module is proto libraries.
963
964 Args:
965 blueprint: Blueprint instance which is being generated.
966 gn: gn_utils.GnParser object.
967 gn_target_name: GN target for module generation.
968 """
969 bp_module_name = label_to_module_name(gn_target_name)
970 if bp_module_name in blueprint.modules:
971 return blueprint.modules[bp_module_name]
972 target = gn.get_target(gn_target_name)
Patrick Rohr16228942022-10-26 14:00:26 -0700973 log.info('create modules for %s (%s)', target.name, target.type)
Patrick Rohr92d74122022-10-21 15:50:52 -0700974
Patrick Rohr92d74122022-10-21 15:50:52 -0700975 if target.type == 'executable':
Patrick Rohrc8f41cd2022-11-15 22:46:10 -0800976 if target.testonly:
Patrick Rohr92d74122022-10-21 15:50:52 -0700977 module_type = 'cc_test'
978 else:
Patrick Rohrc8f41cd2022-11-15 22:46:10 -0800979 # Can be used for both host and device targets.
Patrick Rohr92d74122022-10-21 15:50:52 -0700980 module_type = 'cc_binary'
981 module = Module(module_type, bp_module_name, gn_target_name)
982 elif target.type == 'static_library':
983 module = Module('cc_library_static', bp_module_name, gn_target_name)
984 elif target.type == 'shared_library':
985 module = Module('cc_library_shared', bp_module_name, gn_target_name)
986 elif target.type == 'source_set':
987 module = Module('filegroup', bp_module_name, gn_target_name)
988 elif target.type == 'group':
989 # "group" targets are resolved recursively by gn_utils.get_target().
990 # There's nothing we need to do at this level for them.
991 return None
992 elif target.type == 'proto_library':
993 module = create_proto_modules(blueprint, gn, target)
994 if module is None:
995 return None
996 elif target.type == 'action':
997 if 'gen_amalgamated_sql_metrics' in target.name:
998 module = create_amalgamated_sql_metrics_module(blueprint, target)
Patrick Rohr07876662022-11-15 22:55:23 -0800999 elif re.match('.*gen_cc_.*_descriptor$', target.name):
Patrick Rohr92d74122022-10-21 15:50:52 -07001000 module = create_cc_proto_descriptor_module(blueprint, target)
1001 elif target.type == 'action' and \
Patrick Rohr07876662022-11-15 22:55:23 -08001002 target.name == gn_utils.GEN_VERSION_TARGET:
Patrick Rohr92d74122022-10-21 15:50:52 -07001003 module = create_gen_version_module(blueprint, target, bp_module_name)
1004 else:
Patrick Rohre1a853e2022-10-26 12:31:39 -07001005 module = create_action_module(blueprint, target)
Mohannad Farragf076f3e2022-10-31 17:45:28 +00001006 elif target.type == 'action_foreach':
Mohannad Farragbab6c892022-11-02 14:09:46 +00001007 module = create_action_foreach_modules(blueprint, target)
Patrick Rohr59a76652022-10-26 12:36:56 -07001008 elif target.type == 'copy':
1009 # TODO: careful now! copy targets are not supported yet, but this will stop
1010 # traversing the dependency tree. For //base:base, this is not a big
1011 # problem as libicu contains the only copy target which happens to be a
1012 # leaf node.
1013 return None
Patrick Rohrad440602022-11-10 22:09:04 -08001014 elif target.type == 'java_group':
1015 # Java targets are handled outside of create_modules_from_target.
1016 return None
Patrick Rohr92d74122022-10-21 15:50:52 -07001017 else:
1018 raise Error('Unknown target %s (%s)' % (target.name, target.type))
1019
1020 blueprint.add_module(module)
Patrick Rohr92d74122022-10-21 15:50:52 -07001021 module.init_rc = target_initrc.get(target.name, [])
1022 module.srcs.update(
1023 gn_utils.label_to_path(src)
1024 for src in target.sources
Motomu Utsumif951e502022-11-07 19:31:15 +09001025 if is_supported_source_file(src) and not src.startswith("//out/test"))
Patrick Rohr92d74122022-10-21 15:50:52 -07001026
Motomu Utsumi97fb1812022-11-01 13:08:10 +09001027 local_include_dirs_set = set()
Patrick Rohr92d74122022-10-21 15:50:52 -07001028 if target.type in gn_utils.LINKER_UNIT_TYPES:
1029 module.cflags.update(_get_cflags(target))
Patrick Rohrf22e9d02022-10-28 14:20:46 -07001030 # TODO: implement proper cflag parsing.
1031 for flag in target.cflags:
Patrick Rohrb8f830a2022-10-31 11:18:57 -07001032 if '-std=' in flag:
1033 module.cpp_std = flag[len('-std='):]
Patrick Rohr61f2acb2022-10-31 14:08:18 -07001034 if '-isystem' in flag:
Motomu Utsumi97fb1812022-11-01 13:08:10 +09001035 local_include_dirs_set.add(flag[len('-isystem../../'):])
Patrick Rohr5fae90f2022-11-11 08:22:52 -08001036 if '-frtti' in flag:
1037 module.rtti = True
Patrick Rohr0948d1c2022-11-11 11:02:16 -08001038 if '-fexceptions' in flag:
1039 module.cppflags.add('-fexceptions')
1040
Patrick Rohrb8f830a2022-10-31 11:18:57 -07001041
Patrick Rohrd0abc2a2022-10-31 13:29:16 -07001042 # Adding local_include_dirs is necessary due to source_sets / filegroups
1043 # which do not properly propagate include directories.
1044 # Filter any directory inside //out as a) this directory does not exist for
1045 # aosp / soong builds and b) the include directory should already be
1046 # configured via library dependency.
Motomu Utsumi97fb1812022-11-01 13:08:10 +09001047 local_include_dirs_set.update([gn_utils.label_to_path(d)
Patrick Rohrd0abc2a2022-10-31 13:29:16 -07001048 for d in target.include_dirs
1049 if not re.match('^//out/.*', d)])
Motomu Utsumi97fb1812022-11-01 13:08:10 +09001050 module.local_include_dirs = sorted(list(local_include_dirs_set))
1051
1052 # Order matters for some targets. For example, base/time/time_exploded_icu.cc
1053 # in //base:base needs to have sysroot include after icu/source/common
1054 # include. So adding sysroot include at the end.
1055 for flag in target.cflags:
1056 if '--sysroot' in flag:
Motomu Utsumi19e0c6f2022-11-15 20:22:45 +09001057 sysroot = flag[len('--sysroot=../../'):]
1058 if sysroot == "build/linux/debian_bullseye_amd64-sysroot":
1059 module.local_include_dirs.append(sysroot + "/usr/include/x86_64-linux-gnu")
1060 module.local_include_dirs.append(sysroot + "/usr/include")
Patrick Rohr92d74122022-10-21 15:50:52 -07001061
1062 module_is_compiled = module.type not in ('genrule', 'filegroup')
1063 if module_is_compiled:
Patrick Rohrc8f41cd2022-11-15 22:46:10 -08001064 module.host_supported = target.host_supported()
1065 module.device_supported = target.device_supported()
1066
Patrick Rohr92d74122022-10-21 15:50:52 -07001067 # Don't try to inject library/source dependencies into genrules or
1068 # filegroups because they are not compiled in the traditional sense.
1069 module.defaults = [defaults_module]
1070 for lib in target.libs:
1071 # Generally library names should be mangled as 'libXXX', unless they
1072 # are HAL libraries (e.g., android.hardware.health@2.0) or AIDL c++ / NDK
1073 # libraries (e.g. "android.hardware.power.stats-V1-cpp")
1074 android_lib = lib if '@' in lib or "-cpp" in lib or "-ndk" in lib \
1075 else 'lib' + lib
1076 if lib in shared_library_allowlist:
1077 module.add_android_shared_lib(android_lib)
1078 if lib in static_library_allowlist:
1079 module.add_android_static_lib(android_lib)
1080
Patrick Rohrd9dd3b92022-11-09 16:15:30 -08001081 # Remove prohibited include directories
1082 module.local_include_dirs = [d for d in module.local_include_dirs
1083 if d not in local_include_dirs_denylist]
1084
1085
Patrick Rohr92d74122022-10-21 15:50:52 -07001086 # If the module is a static library, export all the generated headers.
1087 if module.type == 'cc_library_static':
1088 module.export_generated_headers = module.generated_headers
1089
Patrick Rohr92d74122022-10-21 15:50:52 -07001090 # dep_name is an unmangled GN target name (e.g. //foo:bar(toolchain)).
Motomu Utsumif1daa232022-11-08 13:28:37 +09001091 # Currently, only one module is generated from target even target has multiple toolchains.
1092 # And module is generated based on the first visited target.
1093 # Sort deps before iteration to make result deterministic.
1094 all_deps = sorted(target.deps | target.source_set_deps | target.transitive_proto_deps)
Patrick Rohr92d74122022-10-21 15:50:52 -07001095 for dep_name in all_deps:
Patrick Rohr5cc46e02022-10-26 14:32:45 -07001096 # |builtin_deps| override GN deps with Android-specific ones. See the
1097 # config in the top of this file.
Patrick Rohr07876662022-11-15 22:55:23 -08001098 if dep_name in builtin_deps:
1099 builtin_deps[dep_name](module)
Patrick Rohr5cc46e02022-10-26 14:32:45 -07001100 continue
1101
Patrick Rohr92d74122022-10-21 15:50:52 -07001102 dep_module = create_modules_from_target(blueprint, gn, dep_name)
1103
Motomu Utsumie246feb2022-11-01 17:25:56 +09001104 # TODO: Proper dependency check for genrule.
1105 # Currently, only propagating genrule dependencies.
1106 # Also, currently, all the dependencies are propagated upwards.
1107 # in gn, public_deps should be propagated but deps should not.
1108 # Not sure this information is available in the desc.json.
1109 # Following rule works for adding android_runtime_jni_headers to base:base.
1110 # If this doesn't work for other target, hardcoding for specific target
1111 # might be better.
1112 if module.type == "genrule" and dep_module.type == "genrule":
1113 module.genrule_headers.add(dep_module.name)
1114 module.genrule_headers.update(dep_module.genrule_headers)
1115
Patrick Rohr92d74122022-10-21 15:50:52 -07001116 # For filegroups and genrule, recurse but don't apply the deps.
1117 if not module_is_compiled:
1118 continue
1119
Patrick Rohr92d74122022-10-21 15:50:52 -07001120 if dep_module is None:
1121 continue
1122 if dep_module.type == 'cc_library_shared':
1123 module.shared_libs.add(dep_module.name)
1124 elif dep_module.type == 'cc_library_static':
1125 module.static_libs.add(dep_module.name)
1126 elif dep_module.type == 'filegroup':
1127 module.srcs.add(':' + dep_module.name)
1128 elif dep_module.type == 'genrule':
1129 module.generated_headers.update(dep_module.genrule_headers)
1130 module.srcs.update(dep_module.genrule_srcs)
1131 module.shared_libs.update(dep_module.genrule_shared_libs)
Patrick Rohra1a27872022-10-31 11:57:14 -07001132 module.header_libs.update(dep_module.genrule_header_libs)
Patrick Rohr92d74122022-10-21 15:50:52 -07001133 elif dep_module.type == 'cc_binary':
1134 continue # Ignore executables deps (used by cmdline integration tests).
1135 else:
1136 raise Error('Unknown dep %s (%s) for target %s' %
1137 (dep_module.name, dep_module.type, module.name))
1138
Motomu Utsumi87c2a482022-11-14 14:57:46 +09001139 # TODO: support arch difference in generic way
1140 # Currently, it is expected that only a couple of modules (e.g. partition_alloc, boringssl)
1141 # need arch condition. So, for now, hardcoding arch condition
1142 if module.name == "cronet_aml_base_allocator_partition_allocator_partition_alloc":
1143 x86_srcs = module.srcs.copy()
Patrick Rohr5ad78112022-11-15 12:27:38 -08001144 x86_srcs.discard(
Motomu Utsumi87c2a482022-11-14 14:57:46 +09001145 "base/allocator/partition_allocator/starscan/stack/asm/x64/push_registers_asm.cc")
1146 x86_srcs.add("base/allocator/partition_allocator/starscan/stack/asm/x86/push_registers_asm.cc")
1147 module.arch['x86'] = {'srcs': x86_srcs}
1148 module.arch['x86_64'] = {'srcs': module.srcs.copy()}
1149 module.srcs.clear()
Motomu Utsumi465a96f2022-11-14 16:03:54 +09001150 elif module.name == "cronet_aml_third_party_boringssl_boringssl":
1151 x86_srcs = module.srcs.copy()
1152 x86_srcs.remove(":cronet_aml_third_party_boringssl_boringssl_asm")
1153 x86_srcs.add(":cronet_aml_third_party_boringssl_boringssl_asm_x86")
1154 module.arch['x86'] = {'srcs': x86_srcs}
1155 module.arch['x86_64'] = {'srcs': module.srcs.copy()}
1156 module.srcs.clear()
Motomu Utsumi87c2a482022-11-14 14:57:46 +09001157
Patrick Rohr92d74122022-10-21 15:50:52 -07001158 return module
1159
Patrick Rohrb18aca22022-11-04 15:07:32 -07001160def create_java_module(blueprint, gn):
1161 bp_module_name = module_prefix + 'java'
1162 module = Module('java_library', bp_module_name, '//gn:java')
Mohannad Farrag21562d62022-11-07 13:09:31 +00001163 module.srcs.update([gn_utils.label_to_path(source) for source in gn.java_sources])
Patrick Rohrb18aca22022-11-04 15:07:32 -07001164 blueprint.add_module(module)
Patrick Rohr92d74122022-10-21 15:50:52 -07001165
Motomu Utsumie3ce7702022-11-10 16:22:11 +09001166def update_jni_registration_module(blueprint, gn):
1167 bp_module_name = label_to_module_name('//components/cronet/android:cronet_jni_registration')
Patrick Rohr7f225422022-11-10 21:38:38 -08001168 if bp_module_name not in blueprint.modules:
1169 # To support building targets that might not create the cronet_jni_registration.
1170 return
Motomu Utsumie3ce7702022-11-10 16:22:11 +09001171 module = blueprint.modules[bp_module_name]
Motomu Utsumi47d122f2022-11-10 17:32:23 +09001172
1173 # TODO: deny list is in the arg of jni_registration_generator.py. Should not be hardcoded
1174 deny_list = [
1175 '//base/android/java/src/org/chromium/base/library_loader/LibraryLoader.java',
1176 '//base/android/java/src/org/chromium/base/library_loader/LibraryPrefetcher.java',
1177 '//base/android/java/src/org/chromium/base/process_launcher/ChildProcessService.java',
1178 '//base/android/java/src/org/chromium/base/SysUtils.java']
1179
Motomu Utsumie3ce7702022-11-10 16:22:11 +09001180 # TODO: java_sources might not contain all the required java files
Motomu Utsumi47d122f2022-11-10 17:32:23 +09001181 module.srcs.update([gn_utils.label_to_path(source)
1182 for source in gn.java_sources if source not in deny_list])
Motomu Utsumie3ce7702022-11-10 16:22:11 +09001183
Motomu Utsumi79bd0c82022-11-10 17:52:24 +09001184 # TODO: Remove hardcoded file addition to srcs
1185 # jni_registration_generator.py generates empty .h file if native methods are not found in the
1186 # java files. But android:cronet depends on `RegisterNonMainDexNatives` which is in the template
1187 # of .h file. To make script generate non empty .h file, adding java file which contains native
1188 # method. Once all the required java files are added to the srcs, this can be removed.
1189 module.srcs.update([
1190 "components/cronet/android/java/src/org/chromium/net/impl/CronetUrlRequest.java"])
1191
Patrick Rohr92d74122022-10-21 15:50:52 -07001192def create_blueprint_for_targets(gn, desc, targets):
1193 """Generate a blueprint for a list of GN targets."""
1194 blueprint = Blueprint()
1195
1196 # Default settings used by all modules.
1197 defaults = Module('cc_defaults', defaults_module, '//gn:default_deps')
Patrick Rohr92d74122022-10-21 15:50:52 -07001198 defaults.cflags = [
Patrick Rohr3ce74772022-11-11 14:19:58 -08001199 '-DGOOGLE_PROTOBUF_NO_RTTI',
Patrick Rohr92d74122022-10-21 15:50:52 -07001200 '-Wno-error=return-type',
Patrick Rohr3a1ec1d2022-10-31 13:30:17 -07001201 '-Wno-non-virtual-dtor',
Patrick Rohr5c700022022-11-08 19:33:07 -08001202 '-Wno-macro-redefined',
Patrick Rohr98065152022-10-31 14:49:58 -07001203 '-Wno-missing-field-initializers',
Patrick Rohr92d74122022-10-21 15:50:52 -07001204 '-Wno-sign-compare',
1205 '-Wno-sign-promo',
1206 '-Wno-unused-parameter',
Mohannad Farragd98a96d2022-11-10 14:56:19 +00001207 '-Wno-deprecated-non-prototype', # needed for zlib
Patrick Rohr92d74122022-10-21 15:50:52 -07001208 '-fvisibility=hidden',
Motomu Utsumiba020942022-11-14 15:15:41 +09001209 '-Wno-ambiguous-reversed-operator', # needed for icui18n
Motomu Utsumib1ec8782022-11-14 15:25:57 +09001210 '-Wno-unreachable-code-loop-increment', # needed for icui18n
Patrick Rohr92d74122022-10-21 15:50:52 -07001211 '-O2',
1212 ]
Patrick Rohr61f2acb2022-10-31 14:08:18 -07001213 defaults.stl = 'none'
Patrick Rohr92d74122022-10-21 15:50:52 -07001214 blueprint.add_module(defaults)
Patrick Rohr344b2472022-10-25 11:32:15 -07001215
Patrick Rohr92d74122022-10-21 15:50:52 -07001216 for target in targets:
1217 create_modules_from_target(blueprint, gn, target)
Patrick Rohrb18aca22022-11-04 15:07:32 -07001218
Motomu Utsumi3fde1482022-11-14 15:55:21 +09001219 # Currently, multi tool chain is not supported for all targets and create_modules_from_target can
1220 # not reach to this target by following the dependency.
1221 # So it's required to specify explicitly.
Patrick Rohrd0077b72022-11-15 12:43:26 -08001222 boringssl_gn_target_name = ('//third_party/boringssl:boringssl_asm' +
1223 '(//build/toolchain/android:android_clang_x86)')
Patrick Rohr564d6be2022-11-15 12:57:57 -08001224 gn.parse_gn_desc(desc, boringssl_gn_target_name)
Patrick Rohrd0077b72022-11-15 12:43:26 -08001225 create_modules_from_target(blueprint, gn, boringssl_gn_target_name)
Motomu Utsumi3fde1482022-11-14 15:55:21 +09001226
Patrick Rohrb18aca22022-11-04 15:07:32 -07001227 create_java_module(blueprint, gn)
Motomu Utsumie3ce7702022-11-10 16:22:11 +09001228 update_jni_registration_module(blueprint, gn)
Patrick Rohra7d029d2022-11-08 12:23:11 -08001229
1230 # Merge in additional hardcoded arguments.
1231 for module in blueprint.modules.values():
1232 for key, add_val in additional_args.get(module.name, []):
1233 curr = getattr(module, key)
1234 if add_val and isinstance(add_val, set) and isinstance(curr, set):
1235 curr.update(add_val)
1236 elif isinstance(add_val, str) and (not curr or isinstance(curr, str)):
1237 setattr(module, key, add_val)
1238 elif isinstance(add_val, bool) and (not curr or isinstance(curr, bool)):
1239 setattr(module, key, add_val)
1240 elif isinstance(add_val, dict) and isinstance(curr, dict):
1241 curr.update(add_val)
1242 elif isinstance(add_val, dict) and isinstance(curr, Target):
1243 curr.__dict__.update(add_val)
1244 else:
1245 raise Error('Unimplemented type %r of additional_args: %r' %
1246 (type(add_val), key))
1247
Patrick Rohr92d74122022-10-21 15:50:52 -07001248 return blueprint
1249
1250
1251def main():
1252 parser = argparse.ArgumentParser(
1253 description='Generate Android.bp from a GN description.')
1254 parser.add_argument(
Patrick Rohr92d74122022-10-21 15:50:52 -07001255 '--desc',
Patrick Rohr3db246a2022-10-25 10:25:17 -07001256 help='GN description (e.g., gn desc out --format=json --all-toolchains "//*"',
1257 required=True
Patrick Rohr92d74122022-10-21 15:50:52 -07001258 )
1259 parser.add_argument(
1260 '--extras',
1261 help='Extra targets to include at the end of the Blueprint file',
1262 default=os.path.join(gn_utils.repo_root(), 'Android.bp.extras'),
1263 )
1264 parser.add_argument(
1265 '--output',
1266 help='Blueprint file to create',
1267 default=os.path.join(gn_utils.repo_root(), 'Android.bp'),
1268 )
1269 parser.add_argument(
Patrick Rohr16228942022-10-26 14:00:26 -07001270 '-v',
1271 '--verbose',
1272 help='Print debug logs.',
1273 action='store_true',
1274 )
1275 parser.add_argument(
Patrick Rohr92d74122022-10-21 15:50:52 -07001276 'targets',
1277 nargs=argparse.REMAINDER,
Patrick Rohr1aa504a2022-10-25 10:30:42 -07001278 help='Targets to include in the blueprint (e.g., "//:perfetto_tests")'
1279 )
Patrick Rohr92d74122022-10-21 15:50:52 -07001280 args = parser.parse_args()
1281
Patrick Rohr16228942022-10-26 14:00:26 -07001282 if args.verbose:
1283 log.basicConfig(format='%(levelname)s:%(funcName)s:%(message)s', level=log.DEBUG)
1284
Patrick Rohr3db246a2022-10-25 10:25:17 -07001285 with open(args.desc) as f:
1286 desc = json.load(f)
Patrick Rohr92d74122022-10-21 15:50:52 -07001287
Patrick Rohr564d6be2022-11-15 12:57:57 -08001288 gn = gn_utils.GnParser()
Patrick Rohrd0077b72022-11-15 12:43:26 -08001289 targets = args.targets or default_targets
1290 for target in targets:
1291 # TODO: pass desc to parse_gn_desc() to support parsing multiple desc files
1292 # for different target architectures.
Patrick Rohr564d6be2022-11-15 12:57:57 -08001293 gn.parse_gn_desc(desc, target)
Patrick Rohrd0077b72022-11-15 12:43:26 -08001294 blueprint = create_blueprint_for_targets(gn, desc, targets)
Patrick Rohr92d74122022-10-21 15:50:52 -07001295 project_root = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
1296 tool_name = os.path.relpath(os.path.abspath(__file__), project_root)
1297
Patrick Rohr92d74122022-10-21 15:50:52 -07001298 # Add any proto groups to the blueprint.
1299 for l_name, t_names in proto_groups.items():
1300 create_proto_group_modules(blueprint, gn, l_name, t_names)
1301
1302 output = [
Patrick Rohr5478b392022-10-25 09:58:50 -07001303 """// Copyright (C) 2022 The Android Open Source Project
Patrick Rohr92d74122022-10-21 15:50:52 -07001304//
1305// Licensed under the Apache License, Version 2.0 (the "License");
1306// you may not use this file except in compliance with the License.
1307// You may obtain a copy of the License at
1308//
1309// http://www.apache.org/licenses/LICENSE-2.0
1310//
1311// Unless required by applicable law or agreed to in writing, software
1312// distributed under the License is distributed on an "AS IS" BASIS,
1313// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1314// See the License for the specific language governing permissions and
1315// limitations under the License.
1316//
1317// This file is automatically generated by %s. Do not edit.
1318""" % (tool_name)
1319 ]
1320 blueprint.to_string(output)
Patrick Rohrcb98e9b2022-10-25 09:57:02 -07001321 if os.path.exists(args.extras):
1322 with open(args.extras, 'r') as r:
1323 for line in r:
1324 output.append(line.rstrip("\n\r"))
Patrick Rohr92d74122022-10-21 15:50:52 -07001325
1326 out_files = []
1327
1328 # Generate the Android.bp file.
1329 out_files.append(args.output + '.swp')
1330 with open(out_files[-1], 'w') as f:
1331 f.write('\n'.join(output))
1332 # Text files should have a trailing EOL.
1333 f.write('\n')
1334
Patrick Rohr94693eb2022-10-25 10:09:16 -07001335 return 0
Patrick Rohr92d74122022-10-21 15:50:52 -07001336
1337
1338if __name__ == '__main__':
1339 sys.exit(main())