blob: 171ba09af1c6527d0e16e82a857631372780a033 [file] [log] [blame]
Blink Reformat4c46d092018-04-07 15:32:37 +00001# Copyright (C) 2014 Google Inc. All rights reserved.
2#
3# Redistribution and use in source and binary forms, with or without
4# modification, are permitted provided that the following conditions are
5# met:
6#
7# * Redistributions of source code must retain the above copyright
8# notice, this list of conditions and the following disclaimer.
9# * Redistributions in binary form must reproduce the above
10# copyright notice, this list of conditions and the following disclaimer
11# in the documentation and/or other materials provided with the
12# distribution.
13# * Neither the name of Google Inc. nor the names of its
14# contributors may be used to endorse or promote products derived from
15# this software without specific prior written permission.
16#
17# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
20# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
21# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
22# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
23# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Yang Guo75beda92019-10-28 08:29:25 +010028"""
29DevTools presubmit script
Blink Reformat4c46d092018-04-07 15:32:37 +000030
31See http://dev.chromium.org/developers/how-tos/depottools/presubmit-scripts
32for more details about the presubmit API built into gcl.
33"""
34
35import sys
Tim van der Lippef515fdc2020-03-06 16:18:25 +000036import six
Tim van der Lippefb023462020-08-21 14:10:06 +010037import time
Blink Reformat4c46d092018-04-07 15:32:37 +000038
Yang Guoa7845d52019-10-31 11:30:23 +010039EXCLUSIVE_CHANGE_DIRECTORIES = [
40 [ 'third_party', 'v8' ],
41 [ 'node_modules' ],
42 [ 'OWNERS' ],
43]
44
Liviu Raufd2e3212019-12-18 16:38:20 +010045AUTOROLL_ACCOUNT = "devtools-ci-autoroll-builder@chops-service-accounts.iam.gserviceaccount.com"
Mathias Bynensa0a6e292019-12-17 13:24:08 +010046
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000047
48def _ExecuteSubProcess(input_api, output_api, script_path, args, results):
Tim van der Lippef515fdc2020-03-06 16:18:25 +000049 if isinstance(script_path, six.string_types):
50 script_path = [input_api.python_executable, script_path]
51
Tim van der Lippefb023462020-08-21 14:10:06 +010052 start_time = time.time()
Tim van der Lippef515fdc2020-03-06 16:18:25 +000053 process = input_api.subprocess.Popen(script_path + args, stdout=input_api.subprocess.PIPE, stderr=input_api.subprocess.STDOUT)
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000054 out, _ = process.communicate()
Tim van der Lippefb023462020-08-21 14:10:06 +010055 end_time = time.time()
56
57 time_difference = end_time - start_time
58 time_info = "Script execution time was %.1fs seconds\n" % (time_difference)
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000059 if process.returncode != 0:
Tim van der Lippefb023462020-08-21 14:10:06 +010060 results.append(output_api.PresubmitError(time_info + out))
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000061 else:
Tim van der Lippefb023462020-08-21 14:10:06 +010062 results.append(output_api.PresubmitNotifyResult(time_info + out))
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000063 return results
64
65
Yang Guoa7845d52019-10-31 11:30:23 +010066def _CheckChangesAreExclusiveToDirectory(input_api, output_api):
Tim van der Lippebc42a632019-11-28 14:22:55 +000067 if input_api.change.DISABLE_THIRD_PARTY_CHECK != None:
68 return []
Brandon Goddarde7028672020-01-30 09:31:04 -080069 results = [output_api.PresubmitNotifyResult('Directory Exclusivity Check:')]
Yang Guoa7845d52019-10-31 11:30:23 +010070 def IsParentDir(file, dir):
71 while file != '':
72 if file == dir:
73 return True
74 file = input_api.os_path.dirname(file)
Yang Guoa7845d52019-10-31 11:30:23 +010075 return False
76
77 def FileIsInDir(file, dirs):
78 for dir in dirs:
79 if IsParentDir(file, dir):
80 return True
81
82 affected_files = input_api.LocalPaths()
Yang Guoa7845d52019-10-31 11:30:23 +010083 num_affected = len(affected_files)
84 for dirs in EXCLUSIVE_CHANGE_DIRECTORIES:
Paul Lewis14effba2019-12-02 14:56:40 +000085 dir_list = ', '.join(dirs)
Yang Guoa7845d52019-10-31 11:30:23 +010086 affected_in_dir = filter(lambda f: FileIsInDir(f, dirs), affected_files)
87 num_in_dir = len(affected_in_dir)
88 if num_in_dir == 0:
89 continue
Tim van der Lippeebb94a92019-11-19 17:07:53 +000090 # Addition of new third_party folders must have a new entry in `.gitignore`
91 if '.gitignore' in affected_files:
92 num_in_dir = num_in_dir + 1
Yang Guoa7845d52019-10-31 11:30:23 +010093 if num_in_dir < num_affected:
Brandon Goddarde7028672020-01-30 09:31:04 -080094 results.append(output_api
Paul Lewis14effba2019-12-02 14:56:40 +000095 .PresubmitError(('CLs that affect files in "%s" should be limited to these files/directories.' % dir_list) +
Brandon Goddarde7028672020-01-30 09:31:04 -080096 ' You can disable this check by adding DISABLE_THIRD_PARTY_CHECK=<reason> to your commit message'))
97 break
98
99 return results
Yang Guoa7845d52019-10-31 11:30:23 +0100100
Blink Reformat4c46d092018-04-07 15:32:37 +0000101
Sigurd Schneider5c9b4f92021-01-22 11:09:55 +0100102def _CheckBugAssociation(input_api, output_api, is_committing):
103 results = [output_api.PresubmitNotifyResult('Bug Association Check:')]
104 bugs = input_api.change.BugsFromDescription()
105 message = (
106 "Each CL should be associated with a bug, use \'Bug:\' or \'Fixed:\' lines in\n"
107 "the footer of the commit description. If you explicitly don\'t want to\n"
108 "set a bug, use \'Bug: none\' in the footer of the commit description.\n\n"
109 "Note: The footer of the commit description is the last block of lines in\n"
110 "the commit description that doesn't contain empty lines. This means that\n"
111 "any \'Bug:\' or \'Fixed:\' lines that are eventually followed by an empty\n"
112 "line are not detected by this presubmit check.")
113
114 if not bugs:
115 if is_committing:
116 results.append(output_api.PresubmitError(message))
117 else:
118 results.append(output_api.PresubmitNotifyResult(message))
119
120 for bug in bugs:
121 results.append(output_api.PresubmitNotifyResult(('%s') % bug))
122
123 return results
124
125
Blink Reformat4c46d092018-04-07 15:32:37 +0000126def _CheckBuildGN(input_api, output_api):
Brandon Goddarde7028672020-01-30 09:31:04 -0800127 results = [output_api.PresubmitNotifyResult('Running BUILD.GN check:')]
Yang Guo75beda92019-10-28 08:29:25 +0100128 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'check_gn.js')
Brandon Goddarde7028672020-01-30 09:31:04 -0800129 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
130 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000131
132
Brandon Goddard33104372020-08-13 08:49:23 -0700133def _CheckExperimentTelemetry(input_api, output_api):
Brandon Goddard33104372020-08-13 08:49:23 -0700134 experiment_telemetry_files = [
135 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
136 'main', 'MainImpl.js'),
137 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
138 'host', 'UserMetrics.js')
139 ]
140 affected_main_files = _getAffectedFiles(input_api,
141 experiment_telemetry_files, [],
142 ['.js'])
143 if len(affected_main_files) == 0:
Tim van der Lippefb023462020-08-21 14:10:06 +0100144 return [
145 output_api.PresubmitNotifyResult(
146 'No affected files for telemetry check')
147 ]
Brandon Goddard33104372020-08-13 08:49:23 -0700148
Tim van der Lippefb023462020-08-21 14:10:06 +0100149 results = [
150 output_api.PresubmitNotifyResult('Running Experiment Telemetry check:')
151 ]
Brandon Goddard33104372020-08-13 08:49:23 -0700152 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
153 'scripts', 'check_experiments.js')
154 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
155 return results
156
157
Tim van der Lippee4bdd742019-12-17 16:40:16 +0100158def _CheckJSON(input_api, output_api):
Brandon Goddarde7028672020-01-30 09:31:04 -0800159 results = [output_api.PresubmitNotifyResult('Running JSON Validator:')]
Tim van der Lippee4bdd742019-12-17 16:40:16 +0100160 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'json_validator', 'validate_module_json.js')
Brandon Goddarde7028672020-01-30 09:31:04 -0800161 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
162 return results
Tim van der Lippee4bdd742019-12-17 16:40:16 +0100163
164
Blink Reformat4c46d092018-04-07 15:32:37 +0000165def _CheckFormat(input_api, output_api):
Tim van der Lippefdbd42e2020-04-07 15:14:36 +0100166 node_modules_affected_files = _getAffectedFiles(input_api, [input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules')], [], [])
167
168 # TODO(crbug.com/1068198): Remove once `git cl format --js` can handle large CLs.
169 if (len(node_modules_affected_files) > 0):
170 return [output_api.PresubmitNotifyResult('Skipping Format Checks because `node_modules` files are affected.')]
171
Brandon Goddarde7028672020-01-30 09:31:04 -0800172 results = [output_api.PresubmitNotifyResult('Running Format Checks:')]
Blink Reformat4c46d092018-04-07 15:32:37 +0000173
Tim van der Lippef515fdc2020-03-06 16:18:25 +0000174 return _ExecuteSubProcess(input_api, output_api, ['git', 'cl', 'format', '--js'], [], results)
Blink Reformat4c46d092018-04-07 15:32:37 +0000175
176
e52a82bdfb5106bd658c2c5ea465e200594be1e2019-10-29 16:02:46 -0700177def _CheckDevtoolsLocalization(input_api, output_api, check_all_files=False): # pylint: disable=invalid-name
Mandy Chene997da72019-08-22 23:50:19 +0000178 devtools_root = input_api.PresubmitLocalPath()
vidorteg2b675b02019-11-25 09:51:28 -0800179 script_path = input_api.os_path.join(devtools_root, 'scripts', 'test', 'run_localization_check.py')
Paul Lewis954a5a92019-11-20 15:33:49 +0000180 if check_all_files == True:
vidorteg2b675b02019-11-25 09:51:28 -0800181 # Scan all files and fix any errors
vidorteg75c025e2019-11-25 09:52:43 -0800182 args = ['--autofix', '--all']
Paul Lewis954a5a92019-11-20 15:33:49 +0000183 else:
vidorteg2b675b02019-11-25 09:51:28 -0800184 devtools_front_end = input_api.os_path.join(devtools_root, 'front_end')
Andres Olivares71a1ce42020-11-03 11:07:30 -0500185 affected_front_end_files = _getAffectedFiles(
186 input_api, [devtools_front_end], ['D'],
187 ['.ts', '.js', '.grdp', '.grd', 'module.json'])
vidorteg2b675b02019-11-25 09:51:28 -0800188
189 if len(affected_front_end_files) == 0:
Tim van der Lippefb023462020-08-21 14:10:06 +0100190 return [
191 output_api.PresubmitNotifyResult(
192 'No affected files for localization check')
193 ]
Christy Chen1ab87e02020-01-30 16:32:16 -0800194
195 with input_api.CreateTemporaryFile() as file_list:
196 for affected_file in affected_front_end_files:
197 file_list.write(affected_file + '\n')
198 file_list.close()
199
vidorteg2b675b02019-11-25 09:51:28 -0800200 # Scan only added or modified files with specific extensions.
Christy Chen1ab87e02020-01-30 16:32:16 -0800201 args = ['--autofix', '--file-list', file_list.name]
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000202
Tim van der Lippefb023462020-08-21 14:10:06 +0100203 results = [
204 output_api.PresubmitNotifyResult('Running Localization Checks:')
205 ]
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000206 return _ExecuteSubProcess(input_api, output_api, script_path, args, results)
Mandy Chen465b4f72019-03-21 22:52:54 +0000207
208
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200209def _CheckDevToolsStyleJS(input_api, output_api):
Tim van der Lippefb023462020-08-21 14:10:06 +0100210 results = [output_api.PresubmitNotifyResult('JS style check:')]
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200211 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
212 'scripts', 'test',
213 'run_lint_check_js.js')
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000214
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200215 front_end_directory = input_api.os_path.join(
216 input_api.PresubmitLocalPath(), 'front_end')
Alex Rudenko5556a902020-09-29 09:37:23 +0000217 inspector_overlay_directory = input_api.os_path.join(
218 input_api.PresubmitLocalPath(), 'inspector_overlay')
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200219 test_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
220 'test')
221 scripts_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
222 'scripts')
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000223
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200224 default_linted_directories = [
Alex Rudenko5556a902020-09-29 09:37:23 +0000225 front_end_directory, test_directory, scripts_directory,
226 inspector_overlay_directory
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200227 ]
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000228
229 eslint_related_files = [
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200230 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
231 'eslint'),
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000232 input_api.os_path.join(input_api.PresubmitLocalPath(), '.eslintrc.js'),
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200233 input_api.os_path.join(input_api.PresubmitLocalPath(),
234 '.eslintignore'),
Tim van der Lippe33543ac2020-12-14 15:37:45 +0100235 input_api.os_path.join(front_end_directory, '.eslintrc.js'),
Tim van der Lippe406249f2020-12-14 15:59:10 +0100236 input_api.os_path.join(test_directory, '.eslintrc.js'),
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200237 input_api.os_path.join(scripts_directory, 'test',
238 'run_lint_check_js.py'),
239 input_api.os_path.join(scripts_directory, 'test',
240 'run_lint_check_js.js'),
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000241 input_api.os_path.join(scripts_directory, '.eslintrc.js'),
242 input_api.os_path.join(scripts_directory, 'eslint_rules'),
243 ]
244
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200245 lint_config_files = _getAffectedFiles(input_api, eslint_related_files, [],
246 ['.js', '.py', '.eslintignore'])
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000247
Mathias Bynens0ec56612020-06-19 09:14:03 +0200248 should_bail_out, files_to_lint = _getFilesToLint(
249 input_api, output_api, lint_config_files, default_linted_directories,
250 ['.js', '.ts'], results)
251 if should_bail_out:
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200252 return results
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000253
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200254 results.extend(
255 _checkWithNodeScript(input_api, output_api, lint_path, files_to_lint))
Tim van der Lippe98132242020-04-14 17:16:54 +0100256 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000257
258
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200259def _CheckDevToolsStyleCSS(input_api, output_api):
Tim van der Lippefb023462020-08-21 14:10:06 +0100260 results = [output_api.PresubmitNotifyResult('CSS style check:')]
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200261 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
262 'scripts', 'test',
Jack Franklinbc302342021-01-18 10:03:30 +0000263 'run_lint_check_css.js')
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200264
265 front_end_directory = input_api.os_path.join(
266 input_api.PresubmitLocalPath(), 'front_end')
Alex Rudenko5556a902020-09-29 09:37:23 +0000267 inspector_overlay_directory = input_api.os_path.join(
268 input_api.PresubmitLocalPath(), 'inspector_overlay')
269 default_linted_directories = [
270 front_end_directory, inspector_overlay_directory
271 ]
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200272
273 scripts_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
274 'scripts')
275
276 stylelint_related_files = [
277 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
278 'stylelint'),
279 input_api.os_path.join(input_api.PresubmitLocalPath(),
280 '.stylelintrc.json'),
281 input_api.os_path.join(input_api.PresubmitLocalPath(),
282 '.stylelintignore'),
283 input_api.os_path.join(scripts_directory, 'test',
284 'run_lint_check_css.py'),
285 ]
286
287 lint_config_files = _getAffectedFiles(input_api, stylelint_related_files,
288 [],
289 ['.json', '.py', '.stylelintignore'])
290
Mathias Bynens0ec56612020-06-19 09:14:03 +0200291 should_bail_out, files_to_lint = _getFilesToLint(
292 input_api, output_api, lint_config_files, default_linted_directories,
293 ['.css'], results)
294 if should_bail_out:
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200295 return results
296
Jack Franklinbc302342021-01-18 10:03:30 +0000297 results.extend(
298 _checkWithNodeScript(input_api, output_api, lint_path, files_to_lint))
299 return results
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200300
301
Jack Franklin13812f62021-02-01 15:51:12 +0000302def _CheckDarkModeStyleSheetsUpToDate(input_api, output_api):
303 devtools_root = input_api.PresubmitLocalPath()
304 devtools_front_end = input_api.os_path.join(devtools_root, 'front_end')
305 affected_css_files = _getAffectedFiles(input_api, [devtools_front_end], [],
306 ['.css'])
307 results = [output_api.PresubmitNotifyResult('Dark Mode CSS check:')]
308 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
309 'scripts', 'dark_mode',
310 'check_darkmode_css_up_to_date.js')
311 results.extend(
312 _checkWithNodeScript(input_api, output_api, script_path,
313 affected_css_files))
314 return results
315
316
Joel Einbinderf6f86b62019-06-10 23:19:12 +0000317def _CheckOptimizeSVGHashes(input_api, output_api):
Tim van der Lippefb023462020-08-21 14:10:06 +0100318 if not input_api.platform.startswith('linux'):
319 return [output_api.PresubmitNotifyResult('Skipping SVG hash check')]
320
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200321 results = [
322 output_api.PresubmitNotifyResult('Running SVG optimization check:')
323 ]
Blink Reformat4c46d092018-04-07 15:32:37 +0000324
325 original_sys_path = sys.path
326 try:
327 sys.path = sys.path + [input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'build')]
328 import devtools_file_hashes
329 finally:
330 sys.path = original_sys_path
331
332 absolute_local_paths = [af.AbsoluteLocalPath() for af in input_api.AffectedFiles(include_deletes=False)]
Yang Guo75beda92019-10-28 08:29:25 +0100333 images_src_path = input_api.os_path.join('devtools', 'front_end', 'Images', 'src')
334 image_source_file_paths = [path for path in absolute_local_paths if images_src_path in path and path.endswith('.svg')]
335 image_sources_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end', 'Images', 'src')
336 hashes_file_name = 'optimize_svg.hashes'
Blink Reformat4c46d092018-04-07 15:32:37 +0000337 hashes_file_path = input_api.os_path.join(image_sources_path, hashes_file_name)
338 invalid_hash_file_paths = devtools_file_hashes.files_with_invalid_hashes(hashes_file_path, image_source_file_paths)
339 if len(invalid_hash_file_paths) == 0:
Brandon Goddarde7028672020-01-30 09:31:04 -0800340 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000341 invalid_hash_file_names = [input_api.os_path.basename(file_path) for file_path in invalid_hash_file_paths]
Yang Guo75beda92019-10-28 08:29:25 +0100342 file_paths_str = ', '.join(invalid_hash_file_names)
343 error_message = 'The following SVG files should be optimized using optimize_svg_images script before uploading: \n - %s' % file_paths_str
Brandon Goddarde7028672020-01-30 09:31:04 -0800344 results.append(output_api.PresubmitError(error_message))
345 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000346
347
Mathias Bynens032591d2019-10-21 11:51:31 +0200348
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000349def _CheckGeneratedFiles(input_api, output_api):
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000350 v8_directory_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'v8')
351 blink_directory_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'blink')
352 protocol_location = input_api.os_path.join(blink_directory_path, 'public', 'devtools_protocol')
353 scripts_build_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'build')
Tim van der Lippe5d2d79b2020-03-23 11:45:04 +0000354 scripts_generated_output_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end', 'generated')
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000355
356 generated_aria_path = input_api.os_path.join(scripts_build_path, 'generate_aria.py')
357 generated_supported_css_path = input_api.os_path.join(scripts_build_path, 'generate_supported_css.py')
358 generated_protocol_path = input_api.os_path.join(scripts_build_path, 'code_generator_frontend.py')
359 concatenate_protocols_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'inspector_protocol',
360 'concatenate_protocols.py')
361
362 affected_files = _getAffectedFiles(input_api, [
363 v8_directory_path,
364 blink_directory_path,
365 input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'pyjson5'),
366 generated_aria_path,
367 generated_supported_css_path,
368 concatenate_protocols_path,
369 generated_protocol_path,
Tim van der Lippe5d2d79b2020-03-23 11:45:04 +0000370 scripts_generated_output_path,
371 ], [], ['.pdl', '.json5', '.py', '.js'])
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000372
373 if len(affected_files) == 0:
Tim van der Lippefb023462020-08-21 14:10:06 +0100374 return [
375 output_api.PresubmitNotifyResult(
376 'No affected files for generated files check')
377 ]
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000378
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000379 results = [output_api.PresubmitNotifyResult('Running Generated Files Check:')]
Tim van der Lippeb0d65f12020-03-05 12:15:24 +0000380 generate_protocol_resources_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'deps',
381 'generate_protocol_resources.py')
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000382
Tim van der Lippeb0d65f12020-03-05 12:15:24 +0000383 return _ExecuteSubProcess(input_api, output_api, generate_protocol_resources_path, [], results)
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000384
385
Christy Chen2d6d9a62020-09-22 09:04:09 -0700386def _CollectStrings(input_api, output_api):
387 devtools_root = input_api.PresubmitLocalPath()
388 devtools_front_end = input_api.os_path.join(devtools_root, 'front_end')
389 affected_front_end_files = _getAffectedFiles(input_api,
390 [devtools_front_end], ['D'],
Tim van der Lippec50df852021-01-19 15:15:52 +0000391 ['.js', '.ts'])
Christy Chen2d6d9a62020-09-22 09:04:09 -0700392 if len(affected_front_end_files) == 0:
393 return [
394 output_api.PresubmitNotifyResult(
395 'No affected files to run collect-strings')
396 ]
397
398 results = [
399 output_api.PresubmitNotifyResult('Collecting strings from front_end:')
400 ]
401 script_path = input_api.os_path.join(devtools_root, 'third_party', 'i18n',
402 'collect-strings.js')
403 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
404 results.append(
405 output_api.PresubmitNotifyResult(
406 'Please commit en-US.json if changes are generated.'))
407 return results
408
409
Tim van der Lippe5279f842020-01-14 16:26:38 +0000410def _CheckNoUncheckedFiles(input_api, output_api):
411 results = []
412 process = input_api.subprocess.Popen(['git', 'diff', '--exit-code'],
413 stdout=input_api.subprocess.PIPE,
414 stderr=input_api.subprocess.STDOUT)
415 out, _ = process.communicate()
416 if process.returncode != 0:
Jack Franklin324f3042020-09-03 11:28:29 +0100417 files_changed_process = input_api.subprocess.Popen(
418 ['git', 'diff', '--name-only'],
419 stdout=input_api.subprocess.PIPE,
420 stderr=input_api.subprocess.STDOUT)
Tim van der Lippe9bb1cf62020-03-06 16:17:02 +0000421 files_changed, _ = files_changed_process.communicate()
422
423 return [
424 output_api.PresubmitError('You have changed files that need to be committed:'),
425 output_api.PresubmitError(files_changed)
426 ]
Tim van der Lippe5279f842020-01-14 16:26:38 +0000427 return []
428
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000429def _CheckForTooLargeFiles(input_api, output_api):
Christy Chen1ab87e02020-01-30 16:32:16 -0800430 """Avoid large files, especially binary files, in the repository since
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000431 git doesn't scale well for those. They will be in everyone's repo
432 clones forever, forever making Chromium slower to clone and work
433 with."""
Christy Chen1ab87e02020-01-30 16:32:16 -0800434 # Uploading files to cloud storage is not trivial so we don't want
435 # to set the limit too low, but the upper limit for "normal" large
436 # files seems to be 1-2 MB, with a handful around 5-8 MB, so
437 # anything over 20 MB is exceptional.
438 TOO_LARGE_FILE_SIZE_LIMIT = 20 * 1024 * 1024 # 10 MB
439 too_large_files = []
440 for f in input_api.AffectedFiles():
441 # Check both added and modified files (but not deleted files).
442 if f.Action() in ('A', 'M'):
443 size = input_api.os_path.getsize(f.AbsoluteLocalPath())
444 if size > TOO_LARGE_FILE_SIZE_LIMIT:
445 too_large_files.append("%s: %d bytes" % (f.LocalPath(), size))
446 if too_large_files:
447 message = (
448 'Do not commit large files to git since git scales badly for those.\n' +
449 'Instead put the large files in cloud storage and use DEPS to\n' +
450 'fetch them.\n' + '\n'.join(too_large_files)
451 )
452 return [output_api.PresubmitError(
453 'Too large files found in commit', long_text=message + '\n')]
454 else:
455 return []
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000456
Tim van der Lippe5279f842020-01-14 16:26:38 +0000457
Tim van der Lippef8a87092020-09-14 13:01:18 +0100458def _RunCannedChecks(input_api, output_api):
459 results = []
460 results.extend(
461 input_api.canned_checks.CheckOwnersFormat(input_api, output_api))
462 results.extend(input_api.canned_checks.CheckOwners(input_api, output_api))
463 results.extend(
464 input_api.canned_checks.CheckChangeHasNoCrAndHasOnlyOneEol(
465 input_api, output_api))
466 results.extend(
467 input_api.canned_checks.CheckChangeHasNoStrayWhitespace(
468 input_api, output_api))
469 results.extend(
470 input_api.canned_checks.CheckGenderNeutral(input_api, output_api))
471 return results
472
473
Yang Guo4fd355c2019-09-19 10:59:03 +0200474def _CommonChecks(input_api, output_api):
Mathias Bynens032591d2019-10-21 11:51:31 +0200475 """Checks common to both upload and commit."""
476 results = []
Mathias Bynens011b0072020-08-05 10:17:35 +0200477 results.extend(
478 input_api.canned_checks.CheckAuthorizedAuthor(
479 input_api, output_api, bot_allowlist=[AUTOROLL_ACCOUNT]))
Blink Reformat4c46d092018-04-07 15:32:37 +0000480 results.extend(_CheckBuildGN(input_api, output_api))
Brandon Goddard33104372020-08-13 08:49:23 -0700481 results.extend(_CheckExperimentTelemetry(input_api, output_api))
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000482 results.extend(_CheckGeneratedFiles(input_api, output_api))
Tim van der Lippee4bdd742019-12-17 16:40:16 +0100483 results.extend(_CheckJSON(input_api, output_api))
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200484 results.extend(_CheckDevToolsStyleJS(input_api, output_api))
485 results.extend(_CheckDevToolsStyleCSS(input_api, output_api))
Jack Franklin13812f62021-02-01 15:51:12 +0000486 results.extend(_CheckDarkModeStyleSheetsUpToDate(input_api, output_api))
Tim van der Lippe5497d482020-01-14 15:27:30 +0000487 results.extend(_CheckFormat(input_api, output_api))
Joel Einbinderf6f86b62019-06-10 23:19:12 +0000488 results.extend(_CheckOptimizeSVGHashes(input_api, output_api))
Yang Guoa7845d52019-10-31 11:30:23 +0100489 results.extend(_CheckChangesAreExclusiveToDirectory(input_api, output_api))
Peter Marshallcd845512021-01-28 15:29:21 +0100490 results.extend(_CheckI18nWasBundled(input_api, output_api))
Tim van der Lippef8a87092020-09-14 13:01:18 +0100491 # Run the canned checks from `depot_tools` after the custom DevTools checks.
492 # The canned checks for example check that lines have line endings. The
493 # DevTools presubmit checks automatically fix these issues. If we would run
494 # the canned checks before the DevTools checks, they would erroneously conclude
495 # that there are issues in the code. Since the canned checks are allowed to be
496 # ignored, a confusing message is shown that asks if the failed presubmit can
497 # be continued regardless. By fixing the issues before we reach the canned checks,
498 # we don't show the message to suppress these errors, which would otherwise be
499 # causing CQ to fail.
500 results.extend(_RunCannedChecks(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 05:43:25 -0800501 return results
502
503
504def _SideEffectChecks(input_api, output_api):
505 """Check side effects caused by other checks"""
506 results = []
Tim van der Lippe5279f842020-01-14 16:26:38 +0000507 results.extend(_CheckNoUncheckedFiles(input_api, output_api))
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000508 results.extend(_CheckForTooLargeFiles(input_api, output_api))
Blink Reformat4c46d092018-04-07 15:32:37 +0000509 return results
510
511
Liviu Raud614e092020-01-08 10:56:33 +0100512def CheckChangeOnUpload(input_api, output_api):
513 results = []
514 results.extend(_CommonChecks(input_api, output_api))
515 results.extend(_CheckDevtoolsLocalization(input_api, output_api))
Christy Chen2d6d9a62020-09-22 09:04:09 -0700516 # Run collectStrings after localization check that cleans up unused strings
517 results.extend(_CollectStrings(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 05:43:25 -0800518 # Run checks that rely on output from other DevTool checks
519 results.extend(_SideEffectChecks(input_api, output_api))
Sigurd Schneider5c9b4f92021-01-22 11:09:55 +0100520 results.extend(_CheckBugAssociation(input_api, output_api, False))
Liviu Raud614e092020-01-08 10:56:33 +0100521 return results
522
523
Blink Reformat4c46d092018-04-07 15:32:37 +0000524def CheckChangeOnCommit(input_api, output_api):
Mandy Chenf0fbdbe2019-08-22 23:58:37 +0000525 results = []
Yang Guo4fd355c2019-09-19 10:59:03 +0200526 results.extend(_CommonChecks(input_api, output_api))
e52a82bdfb5106bd658c2c5ea465e200594be1e2019-10-29 16:02:46 -0700527 results.extend(_CheckDevtoolsLocalization(input_api, output_api, True))
Christy Chen2d6d9a62020-09-22 09:04:09 -0700528 # Run collectStrings after localization check that cleans up unused strings
529 results.extend(_CollectStrings(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 05:43:25 -0800530 # Run checks that rely on output from other DevTool checks
531 results.extend(_SideEffectChecks(input_api, output_api))
Mathias Bynens032591d2019-10-21 11:51:31 +0200532 results.extend(input_api.canned_checks.CheckChangeHasDescription(input_api, output_api))
Sigurd Schneider5c9b4f92021-01-22 11:09:55 +0100533 results.extend(_CheckBugAssociation(input_api, output_api, True))
Mandy Chenf0fbdbe2019-08-22 23:58:37 +0000534 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000535
536
Mandy Chena6be46a2019-07-09 17:06:27 +0000537def _getAffectedFiles(input_api, parent_directories, excluded_actions, accepted_endings): # pylint: disable=invalid-name
Yang Guo75beda92019-10-28 08:29:25 +0100538 """Return absolute file paths of affected files (not due to an excluded action)
Mandy Chena6be46a2019-07-09 17:06:27 +0000539 under a parent directory with an accepted file ending.
Yang Guo75beda92019-10-28 08:29:25 +0100540 """
Mandy Chena6be46a2019-07-09 17:06:27 +0000541 local_paths = [
542 f.AbsoluteLocalPath() for f in input_api.AffectedFiles() if all(f.Action() != action for action in excluded_actions)
543 ]
544 affected_files = [
Tim van der Lippefdbd42e2020-04-07 15:14:36 +0100545 file_name for file_name in local_paths if any(parent_directory in file_name for parent_directory in parent_directories) and
546 (len(accepted_endings) is 0 or any(file_name.endswith(accepted_ending) for accepted_ending in accepted_endings))
Mandy Chena6be46a2019-07-09 17:06:27 +0000547 ]
548 return affected_files
549
550
Tim van der Lippec4617122020-03-06 16:24:19 +0000551def _checkWithNodeScript(input_api, output_api, script_path, script_arguments=[]): # pylint: disable=invalid-name
Blink Reformat4c46d092018-04-07 15:32:37 +0000552 original_sys_path = sys.path
553 try:
Yang Guo75beda92019-10-28 08:29:25 +0100554 sys.path = sys.path + [input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts')]
Yang Guod8176982019-10-04 20:30:35 +0000555 import devtools_paths
Blink Reformat4c46d092018-04-07 15:32:37 +0000556 finally:
557 sys.path = original_sys_path
558
Tim van der Lippec4617122020-03-06 16:24:19 +0000559 return _ExecuteSubProcess(input_api, output_api, [devtools_paths.node_path(), script_path], script_arguments, [])
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200560
561
Jack Franklin324f3042020-09-03 11:28:29 +0100562def _checkWithTypeScript(input_api,
563 output_api,
564 tsc_arguments,
565 script_path,
566 script_arguments=[]): # pylint: disable=invalid-name
567 original_sys_path = sys.path
568 try:
569 sys.path = sys.path + [
570 input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts')
571 ]
572 import devtools_paths
573 finally:
574 sys.path = original_sys_path
575
576 # First run tsc to compile the TS script that we then run in the _ExecuteSubProcess call
577 tsc_compiler_process = input_api.subprocess.Popen(
578 [
579 devtools_paths.node_path(),
580 devtools_paths.typescript_compiler_path()
581 ] + tsc_arguments,
582 stdout=input_api.subprocess.PIPE,
583 stderr=input_api.subprocess.STDOUT)
584
585 out, _ = tsc_compiler_process.communicate()
586 if tsc_compiler_process.returncode != 0:
587 return [
588 output_api.PresubmitError('Error compiling briges regenerator:\n' +
589 str(out))
590 ]
591
592 return _checkWithNodeScript(input_api, output_api, script_path,
593 script_arguments)
594
595
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200596def _getFilesToLint(input_api, output_api, lint_config_files,
597 default_linted_directories, accepted_endings, results):
Mathias Bynens0ec56612020-06-19 09:14:03 +0200598 run_full_check = False
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200599 files_to_lint = []
600
601 # We are changing the lint configuration; run the full check.
602 if len(lint_config_files) is not 0:
603 results.append(
604 output_api.PresubmitNotifyResult('Running full lint check'))
Mathias Bynens0ec56612020-06-19 09:14:03 +0200605 run_full_check = True
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200606 else:
607 # Only run the linter on files that are relevant, to save PRESUBMIT time.
608 files_to_lint = _getAffectedFiles(input_api,
609 default_linted_directories, ['D'],
610 accepted_endings)
611
Paul Lewis2b9224f2020-09-08 18:13:10 +0100612 # Exclude front_end/third_party files.
613 files_to_lint = filter(lambda path: "third_party" not in path,
614 files_to_lint)
615
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200616 if len(files_to_lint) is 0:
617 results.append(
618 output_api.PresubmitNotifyResult(
619 'No affected files for lint check'))
620
Mathias Bynens0ec56612020-06-19 09:14:03 +0200621 should_bail_out = len(files_to_lint) is 0 and not run_full_check
622 return should_bail_out, files_to_lint
Peter Marshallcd845512021-01-28 15:29:21 +0100623
624
625def _CheckI18nWasBundled(input_api, output_api):
626 affected_files = _getAffectedFiles(input_api, [
627 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
628 'third_party', 'i18n', 'lib')
629 ], [], ['.js'])
630
631 if len(affected_files) == 0:
632 return [
633 output_api.PresubmitNotifyResult(
634 'No affected files for i18n bundle check')
635 ]
636
637 results = [output_api.PresubmitNotifyResult('Running buildi18nBundle.js:')]
638 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
639 'scripts', 'localizationV2',
640 'buildi18nBundle.js')
641 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
642 return results