blob: a2dd7406149f98a4e660f284fcefaea707c44a9f [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
Liviu Raufd2e3212019-12-18 16:38:20 +010039AUTOROLL_ACCOUNT = "devtools-ci-autoroll-builder@chops-service-accounts.iam.gserviceaccount.com"
Mathias Bynensa0a6e292019-12-17 13:24:08 +010040
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000041
42def _ExecuteSubProcess(input_api, output_api, script_path, args, results):
Tim van der Lippef515fdc2020-03-06 16:18:25 +000043 if isinstance(script_path, six.string_types):
44 script_path = [input_api.python_executable, script_path]
45
Tim van der Lippefb023462020-08-21 14:10:06 +010046 start_time = time.time()
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +010047 process = input_api.subprocess.Popen(script_path + args,
48 stdout=input_api.subprocess.PIPE,
49 stderr=input_api.subprocess.STDOUT)
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000050 out, _ = process.communicate()
Tim van der Lippefb023462020-08-21 14:10:06 +010051 end_time = time.time()
52
53 time_difference = end_time - start_time
54 time_info = "Script execution time was %.1fs seconds\n" % (time_difference)
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000055 if process.returncode != 0:
Tim van der Lippefb023462020-08-21 14:10:06 +010056 results.append(output_api.PresubmitError(time_info + out))
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000057 else:
Tim van der Lippefb023462020-08-21 14:10:06 +010058 results.append(output_api.PresubmitNotifyResult(time_info + out))
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000059 return results
60
61
Yang Guoa7845d52019-10-31 11:30:23 +010062def _CheckChangesAreExclusiveToDirectory(input_api, output_api):
Tim van der Lippebc42a632019-11-28 14:22:55 +000063 if input_api.change.DISABLE_THIRD_PARTY_CHECK != None:
64 return []
Brandon Goddarde7028672020-01-30 09:31:04 -080065 results = [output_api.PresubmitNotifyResult('Directory Exclusivity Check:')]
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +010066
Yang Guoa7845d52019-10-31 11:30:23 +010067 def IsParentDir(file, dir):
68 while file != '':
69 if file == dir:
70 return True
71 file = input_api.os_path.dirname(file)
Yang Guoa7845d52019-10-31 11:30:23 +010072 return False
73
74 def FileIsInDir(file, dirs):
75 for dir in dirs:
76 if IsParentDir(file, dir):
77 return True
78
Tim van der Lippe4050a302021-04-13 10:21:21 +010079 EXCLUSIVE_CHANGE_DIRECTORIES = [
80 [
81 'third_party', 'v8',
82 input_api.os_path.join('front_end', 'generated')
83 ],
84 [
85 'node_modules',
86 'package.json',
87 'package-lock.json',
88 input_api.os_path.join('scripts', 'deps', 'manage_node_deps.py'),
89 ],
90 ['OWNERS', input_api.os_path.join('config', 'owner')],
91 ]
92
Yang Guoa7845d52019-10-31 11:30:23 +010093 affected_files = input_api.LocalPaths()
Yang Guoa7845d52019-10-31 11:30:23 +010094 num_affected = len(affected_files)
95 for dirs in EXCLUSIVE_CHANGE_DIRECTORIES:
Paul Lewis14effba2019-12-02 14:56:40 +000096 dir_list = ', '.join(dirs)
Yang Guoa7845d52019-10-31 11:30:23 +010097 affected_in_dir = filter(lambda f: FileIsInDir(f, dirs), affected_files)
98 num_in_dir = len(affected_in_dir)
99 if num_in_dir == 0:
100 continue
Tim van der Lippeebb94a92019-11-19 17:07:53 +0000101 # Addition of new third_party folders must have a new entry in `.gitignore`
102 if '.gitignore' in affected_files:
103 num_in_dir = num_in_dir + 1
Yang Guoa7845d52019-10-31 11:30:23 +0100104 if num_in_dir < num_affected:
Tim van der Lippe239963b2021-04-09 10:43:38 +0100105 unexpected_files = [
106 file for file in affected_files if file not in affected_in_dir
107 ]
108 results.append(
109 output_api.PresubmitError(
110 ('CLs that affect files in "%s" should be limited to these files/directories.'
111 % dir_list) +
112 ('\nUnexpected files: %s.' % unexpected_files) +
113 '\nYou can disable this check by adding DISABLE_THIRD_PARTY_CHECK=<reason> to your commit message'
114 ))
Brandon Goddarde7028672020-01-30 09:31:04 -0800115 break
116
117 return results
Yang Guoa7845d52019-10-31 11:30:23 +0100118
Blink Reformat4c46d092018-04-07 15:32:37 +0000119
Sigurd Schneider5c9b4f92021-01-22 11:09:55 +0100120def _CheckBugAssociation(input_api, output_api, is_committing):
121 results = [output_api.PresubmitNotifyResult('Bug Association Check:')]
122 bugs = input_api.change.BugsFromDescription()
123 message = (
124 "Each CL should be associated with a bug, use \'Bug:\' or \'Fixed:\' lines in\n"
125 "the footer of the commit description. If you explicitly don\'t want to\n"
126 "set a bug, use \'Bug: none\' in the footer of the commit description.\n\n"
127 "Note: The footer of the commit description is the last block of lines in\n"
128 "the commit description that doesn't contain empty lines. This means that\n"
129 "any \'Bug:\' or \'Fixed:\' lines that are eventually followed by an empty\n"
130 "line are not detected by this presubmit check.")
131
132 if not bugs:
133 if is_committing:
134 results.append(output_api.PresubmitError(message))
135 else:
136 results.append(output_api.PresubmitNotifyResult(message))
137
138 for bug in bugs:
139 results.append(output_api.PresubmitNotifyResult(('%s') % bug))
140
141 return results
142
143
Blink Reformat4c46d092018-04-07 15:32:37 +0000144def _CheckBuildGN(input_api, output_api):
Brandon Goddarde7028672020-01-30 09:31:04 -0800145 results = [output_api.PresubmitNotifyResult('Running BUILD.GN check:')]
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +0100146 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
147 'scripts', 'check_gn.js')
Brandon Goddarde7028672020-01-30 09:31:04 -0800148 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
149 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000150
151
Brandon Goddard33104372020-08-13 08:49:23 -0700152def _CheckExperimentTelemetry(input_api, output_api):
Brandon Goddard33104372020-08-13 08:49:23 -0700153 experiment_telemetry_files = [
154 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
Jan Schefflerb4eb22d2021-04-05 22:38:36 +0200155 'main', 'MainImpl.ts'),
Brandon Goddard33104372020-08-13 08:49:23 -0700156 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
Tim van der Lippee0247312021-04-01 15:25:30 +0100157 'core', 'host', 'UserMetrics.ts')
Brandon Goddard33104372020-08-13 08:49:23 -0700158 ]
159 affected_main_files = _getAffectedFiles(input_api,
160 experiment_telemetry_files, [],
161 ['.js'])
162 if len(affected_main_files) == 0:
Tim van der Lippefb023462020-08-21 14:10:06 +0100163 return [
164 output_api.PresubmitNotifyResult(
165 'No affected files for telemetry check')
166 ]
Brandon Goddard33104372020-08-13 08:49:23 -0700167
Tim van der Lippefb023462020-08-21 14:10:06 +0100168 results = [
169 output_api.PresubmitNotifyResult('Running Experiment Telemetry check:')
170 ]
Brandon Goddard33104372020-08-13 08:49:23 -0700171 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
172 'scripts', 'check_experiments.js')
173 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
174 return results
175
176
Tim van der Lippee4bdd742019-12-17 16:40:16 +0100177def _CheckJSON(input_api, output_api):
Brandon Goddarde7028672020-01-30 09:31:04 -0800178 results = [output_api.PresubmitNotifyResult('Running JSON Validator:')]
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +0100179 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
180 'scripts', 'json_validator',
181 'validate_module_json.js')
Brandon Goddarde7028672020-01-30 09:31:04 -0800182 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
183 return results
Tim van der Lippee4bdd742019-12-17 16:40:16 +0100184
185
Blink Reformat4c46d092018-04-07 15:32:37 +0000186def _CheckFormat(input_api, output_api):
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +0100187 node_modules_affected_files = _getAffectedFiles(input_api, [
188 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules')
189 ], [], [])
Tim van der Lippefdbd42e2020-04-07 15:14:36 +0100190
191 # TODO(crbug.com/1068198): Remove once `git cl format --js` can handle large CLs.
192 if (len(node_modules_affected_files) > 0):
193 return [output_api.PresubmitNotifyResult('Skipping Format Checks because `node_modules` files are affected.')]
194
Brandon Goddarde7028672020-01-30 09:31:04 -0800195 results = [output_api.PresubmitNotifyResult('Running Format Checks:')]
Blink Reformat4c46d092018-04-07 15:32:37 +0000196
Tim van der Lippef515fdc2020-03-06 16:18:25 +0000197 return _ExecuteSubProcess(input_api, output_api, ['git', 'cl', 'format', '--js'], [], results)
Blink Reformat4c46d092018-04-07 15:32:37 +0000198
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200199def _CheckDevToolsStyleJS(input_api, output_api):
Tim van der Lippefb023462020-08-21 14:10:06 +0100200 results = [output_api.PresubmitNotifyResult('JS style check:')]
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200201 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
202 'scripts', 'test',
203 'run_lint_check_js.js')
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000204
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200205 front_end_directory = input_api.os_path.join(
206 input_api.PresubmitLocalPath(), 'front_end')
Jack Franklinbcfd6ad2021-02-17 10:12:50 +0000207 component_docs_directory = input_api.os_path.join(front_end_directory,
Tim van der Lippee622f552021-04-14 15:15:18 +0100208 'ui', 'components',
209 'docs')
Alex Rudenko5556a902020-09-29 09:37:23 +0000210 inspector_overlay_directory = input_api.os_path.join(
211 input_api.PresubmitLocalPath(), 'inspector_overlay')
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200212 test_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
213 'test')
214 scripts_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
215 'scripts')
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000216
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200217 default_linted_directories = [
Alex Rudenko5556a902020-09-29 09:37:23 +0000218 front_end_directory, test_directory, scripts_directory,
219 inspector_overlay_directory
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200220 ]
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000221
222 eslint_related_files = [
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200223 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
224 'eslint'),
Tim van der Lippecf4ab402021-02-12 14:30:58 +0000225 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
226 '@typescript-eslint'),
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000227 input_api.os_path.join(input_api.PresubmitLocalPath(), '.eslintrc.js'),
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200228 input_api.os_path.join(input_api.PresubmitLocalPath(),
229 '.eslintignore'),
Tim van der Lippe33543ac2020-12-14 15:37:45 +0100230 input_api.os_path.join(front_end_directory, '.eslintrc.js'),
Jack Franklinbcfd6ad2021-02-17 10:12:50 +0000231 input_api.os_path.join(component_docs_directory, '.eslintrc.js'),
Tim van der Lippe406249f2020-12-14 15:59:10 +0100232 input_api.os_path.join(test_directory, '.eslintrc.js'),
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200233 input_api.os_path.join(scripts_directory, 'test',
234 'run_lint_check_js.py'),
235 input_api.os_path.join(scripts_directory, 'test',
236 'run_lint_check_js.js'),
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000237 input_api.os_path.join(scripts_directory, '.eslintrc.js'),
238 input_api.os_path.join(scripts_directory, 'eslint_rules'),
239 ]
240
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200241 lint_config_files = _getAffectedFiles(input_api, eslint_related_files, [],
242 ['.js', '.py', '.eslintignore'])
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000243
Mathias Bynens0ec56612020-06-19 09:14:03 +0200244 should_bail_out, files_to_lint = _getFilesToLint(
245 input_api, output_api, lint_config_files, default_linted_directories,
246 ['.js', '.ts'], results)
247 if should_bail_out:
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200248 return results
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000249
Brandon Goddarde34e94f2021-04-12 10:58:26 -0700250 # If there are more than 50 files to check, don't bother and check
251 # everything, so as to not run into command line length limits on Windows.
252 if len(files_to_lint) > 50:
253 files_to_lint = []
254
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200255 results.extend(
256 _checkWithNodeScript(input_api, output_api, lint_path, files_to_lint))
Tim van der Lippe98132242020-04-14 17:16:54 +0100257 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000258
259
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200260def _CheckDevToolsStyleCSS(input_api, output_api):
Tim van der Lippefb023462020-08-21 14:10:06 +0100261 results = [output_api.PresubmitNotifyResult('CSS style check:')]
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200262 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
263 'scripts', 'test',
Jack Franklinbc302342021-01-18 10:03:30 +0000264 'run_lint_check_css.js')
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200265
266 front_end_directory = input_api.os_path.join(
267 input_api.PresubmitLocalPath(), 'front_end')
Alex Rudenko5556a902020-09-29 09:37:23 +0000268 inspector_overlay_directory = input_api.os_path.join(
269 input_api.PresubmitLocalPath(), 'inspector_overlay')
270 default_linted_directories = [
271 front_end_directory, inspector_overlay_directory
272 ]
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200273
274 scripts_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
275 'scripts')
276
277 stylelint_related_files = [
278 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
279 'stylelint'),
280 input_api.os_path.join(input_api.PresubmitLocalPath(),
281 '.stylelintrc.json'),
282 input_api.os_path.join(input_api.PresubmitLocalPath(),
283 '.stylelintignore'),
284 input_api.os_path.join(scripts_directory, 'test',
Sigurd Schneider6523c512021-02-12 10:44:28 +0100285 'run_lint_check_css.js'),
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200286 ]
287
288 lint_config_files = _getAffectedFiles(input_api, stylelint_related_files,
Sigurd Schneider6523c512021-02-12 10:44:28 +0100289 [], [])
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200290
Sigurd Schneidere3bf6c22021-02-11 15:35:23 +0100291 css_should_bail_out, css_files_to_lint = _getFilesToLint(
Mathias Bynens0ec56612020-06-19 09:14:03 +0200292 input_api, output_api, lint_config_files, default_linted_directories,
293 ['.css'], results)
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200294
Sigurd Schneidere3bf6c22021-02-11 15:35:23 +0100295 ts_should_bail_out, ts_files_to_lint = _getFilesToLint(
296 input_api, output_api, lint_config_files, default_linted_directories,
297 ['.ts'], results)
298
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +0100299 # If there are more than 50 files to check, don't bother and check
300 # everything, so as to not run into command line length limits on Windows.
301 if not css_should_bail_out:
302 if len(css_files_to_lint) < 50:
303 script_args = ["--files"] + css_files_to_lint
304 else:
305 script_args = [] # The defaults check all CSS files.
306 results.extend(
307 _checkWithNodeScript(input_api, output_api, lint_path,
308 script_args))
309
Sigurd Schneidere3bf6c22021-02-11 15:35:23 +0100310 if not ts_should_bail_out:
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +0100311 script_args = ["--syntax", "html"]
312 if len(ts_files_to_lint) < 50:
313 script_args += ["--files"] + ts_files_to_lint
314 else:
315 script_args += ["--glob", "front_end/**/*.ts"]
Sigurd Schneidere3bf6c22021-02-11 15:35:23 +0100316 results.extend(
317 _checkWithNodeScript(input_api, output_api, lint_path,
318 script_args))
319
Jack Franklinbc302342021-01-18 10:03:30 +0000320 return results
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200321
322
Jack Franklin13812f62021-02-01 15:51:12 +0000323def _CheckDarkModeStyleSheetsUpToDate(input_api, output_api):
324 devtools_root = input_api.PresubmitLocalPath()
325 devtools_front_end = input_api.os_path.join(devtools_root, 'front_end')
Jack Franklina5840542021-04-08 14:10:15 +0000326 dark_mode_scripts_folder = input_api.os_path.join(devtools_root, 'scripts',
327 'dark_mode')
328 dark_mode_script_files = _getAffectedFiles(input_api,
329 dark_mode_scripts_folder, [],
330 ['.js'])
331 script_arguments = []
332 if len(dark_mode_script_files) > 0:
333 # If the scripts have changed, we should check all darkmode files as they may need to be updated.
334 script_arguments += ['--check-all-files']
335 else:
336 affected_css_files = _getAffectedFiles(input_api, [devtools_front_end],
337 [], ['.css'])
338 script_arguments += affected_css_files
339
Jack Franklin13812f62021-02-01 15:51:12 +0000340 results = [output_api.PresubmitNotifyResult('Dark Mode CSS check:')]
341 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
342 'scripts', 'dark_mode',
343 'check_darkmode_css_up_to_date.js')
344 results.extend(
345 _checkWithNodeScript(input_api, output_api, script_path,
Jack Franklina5840542021-04-08 14:10:15 +0000346 script_arguments))
Jack Franklin13812f62021-02-01 15:51:12 +0000347 return results
348
349
Joel Einbinderf6f86b62019-06-10 23:19:12 +0000350def _CheckOptimizeSVGHashes(input_api, output_api):
Tim van der Lippefb023462020-08-21 14:10:06 +0100351 if not input_api.platform.startswith('linux'):
352 return [output_api.PresubmitNotifyResult('Skipping SVG hash check')]
353
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200354 results = [
355 output_api.PresubmitNotifyResult('Running SVG optimization check:')
356 ]
Blink Reformat4c46d092018-04-07 15:32:37 +0000357
358 original_sys_path = sys.path
359 try:
360 sys.path = sys.path + [input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'build')]
361 import devtools_file_hashes
362 finally:
363 sys.path = original_sys_path
364
365 absolute_local_paths = [af.AbsoluteLocalPath() for af in input_api.AffectedFiles(include_deletes=False)]
Yang Guo75beda92019-10-28 08:29:25 +0100366 images_src_path = input_api.os_path.join('devtools', 'front_end', 'Images', 'src')
367 image_source_file_paths = [path for path in absolute_local_paths if images_src_path in path and path.endswith('.svg')]
368 image_sources_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end', 'Images', 'src')
369 hashes_file_name = 'optimize_svg.hashes'
Blink Reformat4c46d092018-04-07 15:32:37 +0000370 hashes_file_path = input_api.os_path.join(image_sources_path, hashes_file_name)
371 invalid_hash_file_paths = devtools_file_hashes.files_with_invalid_hashes(hashes_file_path, image_source_file_paths)
372 if len(invalid_hash_file_paths) == 0:
Brandon Goddarde7028672020-01-30 09:31:04 -0800373 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000374 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 +0100375 file_paths_str = ', '.join(invalid_hash_file_names)
376 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 -0800377 results.append(output_api.PresubmitError(error_message))
378 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000379
380
Mathias Bynens032591d2019-10-21 11:51:31 +0200381
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000382def _CheckGeneratedFiles(input_api, output_api):
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000383 v8_directory_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'v8')
384 blink_directory_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'blink')
385 protocol_location = input_api.os_path.join(blink_directory_path, 'public', 'devtools_protocol')
386 scripts_build_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'build')
Tim van der Lippe5d2d79b2020-03-23 11:45:04 +0000387 scripts_generated_output_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end', 'generated')
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000388
389 generated_aria_path = input_api.os_path.join(scripts_build_path, 'generate_aria.py')
390 generated_supported_css_path = input_api.os_path.join(scripts_build_path, 'generate_supported_css.py')
391 generated_protocol_path = input_api.os_path.join(scripts_build_path, 'code_generator_frontend.py')
392 concatenate_protocols_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'inspector_protocol',
393 'concatenate_protocols.py')
394
395 affected_files = _getAffectedFiles(input_api, [
396 v8_directory_path,
397 blink_directory_path,
398 input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'pyjson5'),
399 generated_aria_path,
400 generated_supported_css_path,
401 concatenate_protocols_path,
402 generated_protocol_path,
Tim van der Lippe5d2d79b2020-03-23 11:45:04 +0000403 scripts_generated_output_path,
404 ], [], ['.pdl', '.json5', '.py', '.js'])
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000405
406 if len(affected_files) == 0:
Tim van der Lippefb023462020-08-21 14:10:06 +0100407 return [
408 output_api.PresubmitNotifyResult(
409 'No affected files for generated files check')
410 ]
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000411
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000412 results = [output_api.PresubmitNotifyResult('Running Generated Files Check:')]
Tim van der Lippeb0d65f12020-03-05 12:15:24 +0000413 generate_protocol_resources_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'deps',
414 'generate_protocol_resources.py')
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000415
Tim van der Lippeb0d65f12020-03-05 12:15:24 +0000416 return _ExecuteSubProcess(input_api, output_api, generate_protocol_resources_path, [], results)
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000417
418
Christy Chen2d6d9a62020-09-22 09:04:09 -0700419def _CollectStrings(input_api, output_api):
420 devtools_root = input_api.PresubmitLocalPath()
421 devtools_front_end = input_api.os_path.join(devtools_root, 'front_end')
422 affected_front_end_files = _getAffectedFiles(input_api,
Peter Marshall1d952dc2021-02-10 13:49:32 +0100423 [devtools_front_end], [],
Tim van der Lippec50df852021-01-19 15:15:52 +0000424 ['.js', '.ts'])
Christy Chen2d6d9a62020-09-22 09:04:09 -0700425 if len(affected_front_end_files) == 0:
426 return [
427 output_api.PresubmitNotifyResult(
428 'No affected files to run collect-strings')
429 ]
430
431 results = [
432 output_api.PresubmitNotifyResult('Collecting strings from front_end:')
433 ]
434 script_path = input_api.os_path.join(devtools_root, 'third_party', 'i18n',
435 'collect-strings.js')
436 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
437 results.append(
438 output_api.PresubmitNotifyResult(
Peter Marshalld67e9f12021-02-08 10:34:35 +0100439 'Please commit en-US.json/en-XL.json if changes are generated.'))
Christy Chen2d6d9a62020-09-22 09:04:09 -0700440 return results
441
442
Tim van der Lippe5279f842020-01-14 16:26:38 +0000443def _CheckNoUncheckedFiles(input_api, output_api):
444 results = []
445 process = input_api.subprocess.Popen(['git', 'diff', '--exit-code'],
446 stdout=input_api.subprocess.PIPE,
447 stderr=input_api.subprocess.STDOUT)
448 out, _ = process.communicate()
449 if process.returncode != 0:
Jack Franklin324f3042020-09-03 11:28:29 +0100450 files_changed_process = input_api.subprocess.Popen(
451 ['git', 'diff', '--name-only'],
452 stdout=input_api.subprocess.PIPE,
453 stderr=input_api.subprocess.STDOUT)
Tim van der Lippe9bb1cf62020-03-06 16:17:02 +0000454 files_changed, _ = files_changed_process.communicate()
455
456 return [
457 output_api.PresubmitError('You have changed files that need to be committed:'),
458 output_api.PresubmitError(files_changed)
459 ]
Tim van der Lippe5279f842020-01-14 16:26:38 +0000460 return []
461
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000462def _CheckForTooLargeFiles(input_api, output_api):
Christy Chen1ab87e02020-01-30 16:32:16 -0800463 """Avoid large files, especially binary files, in the repository since
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000464 git doesn't scale well for those. They will be in everyone's repo
465 clones forever, forever making Chromium slower to clone and work
466 with."""
Christy Chen1ab87e02020-01-30 16:32:16 -0800467 # Uploading files to cloud storage is not trivial so we don't want
468 # to set the limit too low, but the upper limit for "normal" large
469 # files seems to be 1-2 MB, with a handful around 5-8 MB, so
470 # anything over 20 MB is exceptional.
471 TOO_LARGE_FILE_SIZE_LIMIT = 20 * 1024 * 1024 # 10 MB
472 too_large_files = []
473 for f in input_api.AffectedFiles():
474 # Check both added and modified files (but not deleted files).
475 if f.Action() in ('A', 'M'):
476 size = input_api.os_path.getsize(f.AbsoluteLocalPath())
477 if size > TOO_LARGE_FILE_SIZE_LIMIT:
478 too_large_files.append("%s: %d bytes" % (f.LocalPath(), size))
479 if too_large_files:
480 message = (
481 'Do not commit large files to git since git scales badly for those.\n' +
482 'Instead put the large files in cloud storage and use DEPS to\n' +
483 'fetch them.\n' + '\n'.join(too_large_files)
484 )
485 return [output_api.PresubmitError(
486 'Too large files found in commit', long_text=message + '\n')]
487 else:
488 return []
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000489
Tim van der Lippe5279f842020-01-14 16:26:38 +0000490
Tim van der Lippef8a87092020-09-14 13:01:18 +0100491def _RunCannedChecks(input_api, output_api):
492 results = []
493 results.extend(
494 input_api.canned_checks.CheckOwnersFormat(input_api, output_api))
495 results.extend(input_api.canned_checks.CheckOwners(input_api, output_api))
496 results.extend(
497 input_api.canned_checks.CheckChangeHasNoCrAndHasOnlyOneEol(
498 input_api, output_api))
499 results.extend(
500 input_api.canned_checks.CheckChangeHasNoStrayWhitespace(
501 input_api, output_api))
502 results.extend(
503 input_api.canned_checks.CheckGenderNeutral(input_api, output_api))
504 return results
505
506
Yang Guo4fd355c2019-09-19 10:59:03 +0200507def _CommonChecks(input_api, output_api):
Mathias Bynens032591d2019-10-21 11:51:31 +0200508 """Checks common to both upload and commit."""
509 results = []
Mathias Bynens011b0072020-08-05 10:17:35 +0200510 results.extend(
511 input_api.canned_checks.CheckAuthorizedAuthor(
512 input_api, output_api, bot_allowlist=[AUTOROLL_ACCOUNT]))
Blink Reformat4c46d092018-04-07 15:32:37 +0000513 results.extend(_CheckBuildGN(input_api, output_api))
Brandon Goddard33104372020-08-13 08:49:23 -0700514 results.extend(_CheckExperimentTelemetry(input_api, output_api))
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000515 results.extend(_CheckGeneratedFiles(input_api, output_api))
Tim van der Lippee4bdd742019-12-17 16:40:16 +0100516 results.extend(_CheckJSON(input_api, output_api))
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200517 results.extend(_CheckDevToolsStyleJS(input_api, output_api))
518 results.extend(_CheckDevToolsStyleCSS(input_api, output_api))
Jack Franklinb10193f2021-03-19 10:25:08 +0000519
Jack Franklind34cf332021-03-24 10:27:20 +0000520 results.extend(_CheckDarkModeStyleSheetsUpToDate(input_api, output_api))
Tim van der Lippe5497d482020-01-14 15:27:30 +0000521 results.extend(_CheckFormat(input_api, output_api))
Joel Einbinderf6f86b62019-06-10 23:19:12 +0000522 results.extend(_CheckOptimizeSVGHashes(input_api, output_api))
Yang Guoa7845d52019-10-31 11:30:23 +0100523 results.extend(_CheckChangesAreExclusiveToDirectory(input_api, output_api))
Peter Marshallcd845512021-01-28 15:29:21 +0100524 results.extend(_CheckI18nWasBundled(input_api, output_api))
Tim van der Lippef8a87092020-09-14 13:01:18 +0100525 # Run the canned checks from `depot_tools` after the custom DevTools checks.
526 # The canned checks for example check that lines have line endings. The
527 # DevTools presubmit checks automatically fix these issues. If we would run
528 # the canned checks before the DevTools checks, they would erroneously conclude
529 # that there are issues in the code. Since the canned checks are allowed to be
530 # ignored, a confusing message is shown that asks if the failed presubmit can
531 # be continued regardless. By fixing the issues before we reach the canned checks,
532 # we don't show the message to suppress these errors, which would otherwise be
533 # causing CQ to fail.
534 results.extend(_RunCannedChecks(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 05:43:25 -0800535 return results
536
537
538def _SideEffectChecks(input_api, output_api):
539 """Check side effects caused by other checks"""
540 results = []
Tim van der Lippe5279f842020-01-14 16:26:38 +0000541 results.extend(_CheckNoUncheckedFiles(input_api, output_api))
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000542 results.extend(_CheckForTooLargeFiles(input_api, output_api))
Blink Reformat4c46d092018-04-07 15:32:37 +0000543 return results
544
545
Liviu Raud614e092020-01-08 10:56:33 +0100546def CheckChangeOnUpload(input_api, output_api):
547 results = []
548 results.extend(_CommonChecks(input_api, output_api))
Christy Chen2d6d9a62020-09-22 09:04:09 -0700549 results.extend(_CollectStrings(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 05:43:25 -0800550 # Run checks that rely on output from other DevTool checks
551 results.extend(_SideEffectChecks(input_api, output_api))
Sigurd Schneider5c9b4f92021-01-22 11:09:55 +0100552 results.extend(_CheckBugAssociation(input_api, output_api, False))
Liviu Raud614e092020-01-08 10:56:33 +0100553 return results
554
555
Blink Reformat4c46d092018-04-07 15:32:37 +0000556def CheckChangeOnCommit(input_api, output_api):
Mandy Chenf0fbdbe2019-08-22 23:58:37 +0000557 results = []
Yang Guo4fd355c2019-09-19 10:59:03 +0200558 results.extend(_CommonChecks(input_api, output_api))
Christy Chen2d6d9a62020-09-22 09:04:09 -0700559 results.extend(_CollectStrings(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 05:43:25 -0800560 # Run checks that rely on output from other DevTool checks
561 results.extend(_SideEffectChecks(input_api, output_api))
Mathias Bynens032591d2019-10-21 11:51:31 +0200562 results.extend(input_api.canned_checks.CheckChangeHasDescription(input_api, output_api))
Sigurd Schneider5c9b4f92021-01-22 11:09:55 +0100563 results.extend(_CheckBugAssociation(input_api, output_api, True))
Mandy Chenf0fbdbe2019-08-22 23:58:37 +0000564 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000565
566
Mandy Chena6be46a2019-07-09 17:06:27 +0000567def _getAffectedFiles(input_api, parent_directories, excluded_actions, accepted_endings): # pylint: disable=invalid-name
Yang Guo75beda92019-10-28 08:29:25 +0100568 """Return absolute file paths of affected files (not due to an excluded action)
Mandy Chena6be46a2019-07-09 17:06:27 +0000569 under a parent directory with an accepted file ending.
Yang Guo75beda92019-10-28 08:29:25 +0100570 """
Mandy Chena6be46a2019-07-09 17:06:27 +0000571 local_paths = [
572 f.AbsoluteLocalPath() for f in input_api.AffectedFiles() if all(f.Action() != action for action in excluded_actions)
573 ]
574 affected_files = [
Tim van der Lippefdbd42e2020-04-07 15:14:36 +0100575 file_name for file_name in local_paths if any(parent_directory in file_name for parent_directory in parent_directories) and
576 (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 +0000577 ]
578 return affected_files
579
580
Tim van der Lippec4617122020-03-06 16:24:19 +0000581def _checkWithNodeScript(input_api, output_api, script_path, script_arguments=[]): # pylint: disable=invalid-name
Blink Reformat4c46d092018-04-07 15:32:37 +0000582 original_sys_path = sys.path
583 try:
Yang Guo75beda92019-10-28 08:29:25 +0100584 sys.path = sys.path + [input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts')]
Yang Guod8176982019-10-04 20:30:35 +0000585 import devtools_paths
Blink Reformat4c46d092018-04-07 15:32:37 +0000586 finally:
587 sys.path = original_sys_path
588
Tim van der Lippec4617122020-03-06 16:24:19 +0000589 return _ExecuteSubProcess(input_api, output_api, [devtools_paths.node_path(), script_path], script_arguments, [])
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200590
591
Jack Franklin324f3042020-09-03 11:28:29 +0100592def _checkWithTypeScript(input_api,
593 output_api,
594 tsc_arguments,
595 script_path,
596 script_arguments=[]): # pylint: disable=invalid-name
597 original_sys_path = sys.path
598 try:
599 sys.path = sys.path + [
600 input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts')
601 ]
602 import devtools_paths
603 finally:
604 sys.path = original_sys_path
605
606 # First run tsc to compile the TS script that we then run in the _ExecuteSubProcess call
607 tsc_compiler_process = input_api.subprocess.Popen(
608 [
609 devtools_paths.node_path(),
610 devtools_paths.typescript_compiler_path()
611 ] + tsc_arguments,
612 stdout=input_api.subprocess.PIPE,
613 stderr=input_api.subprocess.STDOUT)
614
615 out, _ = tsc_compiler_process.communicate()
616 if tsc_compiler_process.returncode != 0:
617 return [
618 output_api.PresubmitError('Error compiling briges regenerator:\n' +
619 str(out))
620 ]
621
622 return _checkWithNodeScript(input_api, output_api, script_path,
623 script_arguments)
624
625
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200626def _getFilesToLint(input_api, output_api, lint_config_files,
627 default_linted_directories, accepted_endings, results):
Mathias Bynens0ec56612020-06-19 09:14:03 +0200628 run_full_check = False
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200629 files_to_lint = []
630
631 # We are changing the lint configuration; run the full check.
632 if len(lint_config_files) is not 0:
633 results.append(
634 output_api.PresubmitNotifyResult('Running full lint check'))
Mathias Bynens0ec56612020-06-19 09:14:03 +0200635 run_full_check = True
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200636 else:
637 # Only run the linter on files that are relevant, to save PRESUBMIT time.
638 files_to_lint = _getAffectedFiles(input_api,
639 default_linted_directories, ['D'],
640 accepted_endings)
641
Paul Lewis2b9224f2020-09-08 18:13:10 +0100642 # Exclude front_end/third_party files.
643 files_to_lint = filter(lambda path: "third_party" not in path,
644 files_to_lint)
645
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200646 if len(files_to_lint) is 0:
647 results.append(
648 output_api.PresubmitNotifyResult(
649 'No affected files for lint check'))
650
Mathias Bynens0ec56612020-06-19 09:14:03 +0200651 should_bail_out = len(files_to_lint) is 0 and not run_full_check
652 return should_bail_out, files_to_lint
Peter Marshallcd845512021-01-28 15:29:21 +0100653
654
655def _CheckI18nWasBundled(input_api, output_api):
656 affected_files = _getAffectedFiles(input_api, [
657 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
658 'third_party', 'i18n', 'lib')
659 ], [], ['.js'])
660
661 if len(affected_files) == 0:
662 return [
663 output_api.PresubmitNotifyResult(
664 'No affected files for i18n bundle check')
665 ]
666
667 results = [output_api.PresubmitNotifyResult('Running buildi18nBundle.js:')]
668 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
669 'scripts', 'localizationV2',
670 'buildi18nBundle.js')
671 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
672 return results