blob: 427469489173e311862c2794654bb438d41d8fe7 [file] [log] [blame]
Blink Reformat4c46d092018-04-07 15:32:371# 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 07:29:2528"""
29DevTools presubmit script
Blink Reformat4c46d092018-04-07 15:32:3730
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:2536import six
Tim van der Lippefb023462020-08-21 13:10:0637import time
Blink Reformat4c46d092018-04-07 15:32:3738
Liviu Raufd2e3212019-12-18 15:38:2039AUTOROLL_ACCOUNT = "devtools-ci-autoroll-builder@chops-service-accounts.iam.gserviceaccount.com"
Tim van der Lippefb1dc172021-05-11 15:40:2640USE_PYTHON3 = True
Mathias Bynensa0a6e292019-12-17 12:24:0841
Tim van der Lippe4d004ec2020-03-03 18:32:0142
43def _ExecuteSubProcess(input_api, output_api, script_path, args, results):
Tim van der Lippef515fdc2020-03-06 16:18:2544 if isinstance(script_path, six.string_types):
45 script_path = [input_api.python_executable, script_path]
46
Tim van der Lippefb023462020-08-21 13:10:0647 start_time = time.time()
Sigurd Schneiderf3a1ecd2021-03-02 14:46:0348 process = input_api.subprocess.Popen(script_path + args,
49 stdout=input_api.subprocess.PIPE,
50 stderr=input_api.subprocess.STDOUT)
Tim van der Lippe4d004ec2020-03-03 18:32:0151 out, _ = process.communicate()
Tim van der Lippefb023462020-08-21 13:10:0652 end_time = time.time()
53
54 time_difference = end_time - start_time
55 time_info = "Script execution time was %.1fs seconds\n" % (time_difference)
Tim van der Lippe4d004ec2020-03-03 18:32:0156 if process.returncode != 0:
Tim van der Lippefb1dc172021-05-11 15:40:2657 results.append(
58 output_api.PresubmitError(time_info + out.decode('utf-8')))
Tim van der Lippe4d004ec2020-03-03 18:32:0159 else:
Tim van der Lippefb1dc172021-05-11 15:40:2660 results.append(
61 output_api.PresubmitNotifyResult(time_info + out.decode('utf-8')))
Tim van der Lippe4d004ec2020-03-03 18:32:0162 return results
63
64
Yang Guoa7845d52019-10-31 10:30:2365def _CheckChangesAreExclusiveToDirectory(input_api, output_api):
Tim van der Lippebc42a632019-11-28 14:22:5566 if input_api.change.DISABLE_THIRD_PARTY_CHECK != None:
67 return []
Brandon Goddarde7028672020-01-30 17:31:0468 results = [output_api.PresubmitNotifyResult('Directory Exclusivity Check:')]
Sigurd Schneiderf3a1ecd2021-03-02 14:46:0369
Yang Guoa7845d52019-10-31 10:30:2370 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 10:30:2375 return False
76
77 def FileIsInDir(file, dirs):
78 for dir in dirs:
79 if IsParentDir(file, dir):
80 return True
81
Tim van der Lippe4050a302021-04-13 09:21:2182 EXCLUSIVE_CHANGE_DIRECTORIES = [
83 [
84 'third_party', 'v8',
85 input_api.os_path.join('front_end', 'generated')
86 ],
87 [
88 'node_modules',
Tim van der Lippe4050a302021-04-13 09:21:2189 'package-lock.json',
90 input_api.os_path.join('scripts', 'deps', 'manage_node_deps.py'),
91 ],
92 ['OWNERS', input_api.os_path.join('config', 'owner')],
93 ]
94
Yang Guoa7845d52019-10-31 10:30:2395 affected_files = input_api.LocalPaths()
Yang Guoa7845d52019-10-31 10:30:2396 num_affected = len(affected_files)
97 for dirs in EXCLUSIVE_CHANGE_DIRECTORIES:
Paul Lewis14effba2019-12-02 14:56:4098 dir_list = ', '.join(dirs)
Tim van der Lippefb1dc172021-05-11 15:40:2699 affected_in_dir = [
100 file for file in affected_files if FileIsInDir(file, dirs)
101 ]
Yang Guoa7845d52019-10-31 10:30:23102 num_in_dir = len(affected_in_dir)
103 if num_in_dir == 0:
104 continue
Tim van der Lippeebb94a92019-11-19 17:07:53105 # Addition of new third_party folders must have a new entry in `.gitignore`
106 if '.gitignore' in affected_files:
107 num_in_dir = num_in_dir + 1
Yang Guoa7845d52019-10-31 10:30:23108 if num_in_dir < num_affected:
Tim van der Lippe239963b2021-04-09 09:43:38109 unexpected_files = [
110 file for file in affected_files if file not in affected_in_dir
111 ]
112 results.append(
113 output_api.PresubmitError(
114 ('CLs that affect files in "%s" should be limited to these files/directories.'
115 % dir_list) +
116 ('\nUnexpected files: %s.' % unexpected_files) +
117 '\nYou can disable this check by adding DISABLE_THIRD_PARTY_CHECK=<reason> to your commit message'
118 ))
Brandon Goddarde7028672020-01-30 17:31:04119 break
120
121 return results
Yang Guoa7845d52019-10-31 10:30:23122
Blink Reformat4c46d092018-04-07 15:32:37123
Sigurd Schneider5c9b4f92021-01-22 10:09:55124def _CheckBugAssociation(input_api, output_api, is_committing):
125 results = [output_api.PresubmitNotifyResult('Bug Association Check:')]
126 bugs = input_api.change.BugsFromDescription()
127 message = (
128 "Each CL should be associated with a bug, use \'Bug:\' or \'Fixed:\' lines in\n"
129 "the footer of the commit description. If you explicitly don\'t want to\n"
130 "set a bug, use \'Bug: none\' in the footer of the commit description.\n\n"
131 "Note: The footer of the commit description is the last block of lines in\n"
132 "the commit description that doesn't contain empty lines. This means that\n"
133 "any \'Bug:\' or \'Fixed:\' lines that are eventually followed by an empty\n"
134 "line are not detected by this presubmit check.")
135
136 if not bugs:
137 if is_committing:
138 results.append(output_api.PresubmitError(message))
139 else:
140 results.append(output_api.PresubmitNotifyResult(message))
141
142 for bug in bugs:
143 results.append(output_api.PresubmitNotifyResult(('%s') % bug))
144
145 return results
146
147
Blink Reformat4c46d092018-04-07 15:32:37148def _CheckBuildGN(input_api, output_api):
Brandon Goddarde7028672020-01-30 17:31:04149 results = [output_api.PresubmitNotifyResult('Running BUILD.GN check:')]
Sigurd Schneiderf3a1ecd2021-03-02 14:46:03150 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
151 'scripts', 'check_gn.js')
Brandon Goddarde7028672020-01-30 17:31:04152 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
153 return results
Blink Reformat4c46d092018-04-07 15:32:37154
155
Brandon Goddard33104372020-08-13 15:49:23156def _CheckExperimentTelemetry(input_api, output_api):
Brandon Goddard33104372020-08-13 15:49:23157 experiment_telemetry_files = [
158 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
Christy Chenab9a44d2021-07-02 19:54:30159 'entrypoints', 'main', 'MainImpl.ts'),
Brandon Goddard33104372020-08-13 15:49:23160 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
Tim van der Lippee0247312021-04-01 14:25:30161 'core', 'host', 'UserMetrics.ts')
Brandon Goddard33104372020-08-13 15:49:23162 ]
163 affected_main_files = _getAffectedFiles(input_api,
164 experiment_telemetry_files, [],
Christy Chenab9a44d2021-07-02 19:54:30165 ['.ts'])
Brandon Goddard33104372020-08-13 15:49:23166 if len(affected_main_files) == 0:
Tim van der Lippefb023462020-08-21 13:10:06167 return [
168 output_api.PresubmitNotifyResult(
169 'No affected files for telemetry check')
170 ]
Brandon Goddard33104372020-08-13 15:49:23171
Tim van der Lippefb023462020-08-21 13:10:06172 results = [
173 output_api.PresubmitNotifyResult('Running Experiment Telemetry check:')
174 ]
Brandon Goddard33104372020-08-13 15:49:23175 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
176 'scripts', 'check_experiments.js')
177 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
178 return results
179
180
Tim van der Lippee4bdd742019-12-17 15:40:16181def _CheckJSON(input_api, output_api):
Brandon Goddarde7028672020-01-30 17:31:04182 results = [output_api.PresubmitNotifyResult('Running JSON Validator:')]
Sigurd Schneiderf3a1ecd2021-03-02 14:46:03183 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
184 'scripts', 'json_validator',
185 'validate_module_json.js')
Brandon Goddarde7028672020-01-30 17:31:04186 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
187 return results
Tim van der Lippee4bdd742019-12-17 15:40:16188
189
Blink Reformat4c46d092018-04-07 15:32:37190def _CheckFormat(input_api, output_api):
Sigurd Schneiderf3a1ecd2021-03-02 14:46:03191 node_modules_affected_files = _getAffectedFiles(input_api, [
192 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules')
193 ], [], [])
Tim van der Lippefdbd42e2020-04-07 14:14:36194
195 # TODO(crbug.com/1068198): Remove once `git cl format --js` can handle large CLs.
196 if (len(node_modules_affected_files) > 0):
197 return [output_api.PresubmitNotifyResult('Skipping Format Checks because `node_modules` files are affected.')]
198
Brandon Goddarde7028672020-01-30 17:31:04199 results = [output_api.PresubmitNotifyResult('Running Format Checks:')]
Blink Reformat4c46d092018-04-07 15:32:37200
Tim van der Lippef515fdc2020-03-06 16:18:25201 return _ExecuteSubProcess(input_api, output_api, ['git', 'cl', 'format', '--js'], [], results)
Blink Reformat4c46d092018-04-07 15:32:37202
Jack Franklin1aa212d2021-09-10 14:20:08203
204def _CheckDevToolsRunESLintTests(input_api, output_api):
205 # Check for changes in the eslint_rules directory, and run the eslint rules
206 # tests if so.
207 # We don't do this on every CL as most do not touch the rules, but if we do
208 # change them we need to make sure all the tests are passing.
Jack Franklin03db63a2021-09-16 13:40:56209 original_sys_path = sys.path
210 try:
211 sys.path = sys.path + [
212 input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts')
213 ]
214 import devtools_paths
215 finally:
216 sys.path = original_sys_path
Jack Franklin1aa212d2021-09-10 14:20:08217 eslint_rules_dir_path = input_api.os_path.join(
218 input_api.PresubmitLocalPath(), 'scripts', 'eslint_rules')
219 eslint_rules_affected_files = _getAffectedFiles(input_api,
220 [eslint_rules_dir_path],
221 [], [])
222
223 if (len(eslint_rules_affected_files) == 0):
224 return []
225
Jack Franklin03db63a2021-09-16 13:40:56226 mocha_path = devtools_paths.mocha_path()
Jack Franklin1aa212d2021-09-10 14:20:08227 eslint_tests_path = input_api.os_path.join(eslint_rules_dir_path, 'tests',
228 '*_test.js')
229
230 results = [output_api.PresubmitNotifyResult('ESLint rules unit tests')]
231 results.extend(
232 # The dot reporter is more concise which is useful to not get LOADS of
233 # output when just one test fails.
234 _checkWithNodeScript(input_api, output_api, mocha_path,
235 ['--reporter', 'dot', eslint_tests_path]))
236 return results
237
238
Mathias Bynens1b2c5e42020-06-18 06:29:21239def _CheckDevToolsStyleJS(input_api, output_api):
Tim van der Lippefb023462020-08-21 13:10:06240 results = [output_api.PresubmitNotifyResult('JS style check:')]
Mathias Bynens1b2c5e42020-06-18 06:29:21241 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
242 'scripts', 'test',
243 'run_lint_check_js.js')
Tim van der Lippe4d004ec2020-03-03 18:32:01244
Mathias Bynens1b2c5e42020-06-18 06:29:21245 front_end_directory = input_api.os_path.join(
246 input_api.PresubmitLocalPath(), 'front_end')
Jack Franklinbcfd6ad2021-02-17 10:12:50247 component_docs_directory = input_api.os_path.join(front_end_directory,
Tim van der Lippee622f552021-04-14 14:15:18248 'ui', 'components',
249 'docs')
Alex Rudenko5556a902020-09-29 09:37:23250 inspector_overlay_directory = input_api.os_path.join(
251 input_api.PresubmitLocalPath(), 'inspector_overlay')
Mathias Bynens1b2c5e42020-06-18 06:29:21252 test_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
253 'test')
254 scripts_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
255 'scripts')
Tim van der Lippe2a4ae2b2020-03-11 17:28:06256
Mathias Bynens1b2c5e42020-06-18 06:29:21257 default_linted_directories = [
Alex Rudenko5556a902020-09-29 09:37:23258 front_end_directory, test_directory, scripts_directory,
259 inspector_overlay_directory
Mathias Bynens1b2c5e42020-06-18 06:29:21260 ]
Tim van der Lippe2a4ae2b2020-03-11 17:28:06261
262 eslint_related_files = [
Mathias Bynens1b2c5e42020-06-18 06:29:21263 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
264 'eslint'),
Tim van der Lippecf4ab402021-02-12 14:30:58265 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
266 '@typescript-eslint'),
Tim van der Lippe2a4ae2b2020-03-11 17:28:06267 input_api.os_path.join(input_api.PresubmitLocalPath(), '.eslintrc.js'),
Mathias Bynens1b2c5e42020-06-18 06:29:21268 input_api.os_path.join(input_api.PresubmitLocalPath(),
269 '.eslintignore'),
Tim van der Lippe33543ac2020-12-14 14:37:45270 input_api.os_path.join(front_end_directory, '.eslintrc.js'),
Jack Franklinbcfd6ad2021-02-17 10:12:50271 input_api.os_path.join(component_docs_directory, '.eslintrc.js'),
Tim van der Lippe406249f2020-12-14 14:59:10272 input_api.os_path.join(test_directory, '.eslintrc.js'),
Mathias Bynens1b2c5e42020-06-18 06:29:21273 input_api.os_path.join(scripts_directory, 'test',
274 'run_lint_check_js.py'),
275 input_api.os_path.join(scripts_directory, 'test',
276 'run_lint_check_js.js'),
Tim van der Lippe2a4ae2b2020-03-11 17:28:06277 input_api.os_path.join(scripts_directory, '.eslintrc.js'),
278 input_api.os_path.join(scripts_directory, 'eslint_rules'),
279 ]
280
Mathias Bynens1b2c5e42020-06-18 06:29:21281 lint_config_files = _getAffectedFiles(input_api, eslint_related_files, [],
282 ['.js', '.py', '.eslintignore'])
Tim van der Lippe2a4ae2b2020-03-11 17:28:06283
Mathias Bynens0ec56612020-06-19 07:14:03284 should_bail_out, files_to_lint = _getFilesToLint(
285 input_api, output_api, lint_config_files, default_linted_directories,
286 ['.js', '.ts'], results)
287 if should_bail_out:
Mathias Bynens1b2c5e42020-06-18 06:29:21288 return results
Tim van der Lippe2a4ae2b2020-03-11 17:28:06289
Brandon Goddarde34e94f2021-04-12 17:58:26290 # If there are more than 50 files to check, don't bother and check
291 # everything, so as to not run into command line length limits on Windows.
292 if len(files_to_lint) > 50:
293 files_to_lint = []
294
Mathias Bynens1b2c5e42020-06-18 06:29:21295 results.extend(
296 _checkWithNodeScript(input_api, output_api, lint_path, files_to_lint))
Tim van der Lippe98132242020-04-14 16:16:54297 return results
Blink Reformat4c46d092018-04-07 15:32:37298
299
Mathias Bynens1b2c5e42020-06-18 06:29:21300def _CheckDevToolsStyleCSS(input_api, output_api):
Tim van der Lippefb023462020-08-21 13:10:06301 results = [output_api.PresubmitNotifyResult('CSS style check:')]
Mathias Bynens1b2c5e42020-06-18 06:29:21302 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
303 'scripts', 'test',
Jack Franklinbc302342021-01-18 10:03:30304 'run_lint_check_css.js')
Mathias Bynens1b2c5e42020-06-18 06:29:21305
306 front_end_directory = input_api.os_path.join(
307 input_api.PresubmitLocalPath(), 'front_end')
Alex Rudenko5556a902020-09-29 09:37:23308 inspector_overlay_directory = input_api.os_path.join(
309 input_api.PresubmitLocalPath(), 'inspector_overlay')
310 default_linted_directories = [
311 front_end_directory, inspector_overlay_directory
312 ]
Mathias Bynens1b2c5e42020-06-18 06:29:21313
314 scripts_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
315 'scripts')
316
317 stylelint_related_files = [
318 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
319 'stylelint'),
320 input_api.os_path.join(input_api.PresubmitLocalPath(),
321 '.stylelintrc.json'),
322 input_api.os_path.join(input_api.PresubmitLocalPath(),
323 '.stylelintignore'),
324 input_api.os_path.join(scripts_directory, 'test',
Sigurd Schneider6523c512021-02-12 09:44:28325 'run_lint_check_css.js'),
Mathias Bynens1b2c5e42020-06-18 06:29:21326 ]
327
328 lint_config_files = _getAffectedFiles(input_api, stylelint_related_files,
Sigurd Schneider6523c512021-02-12 09:44:28329 [], [])
Mathias Bynens1b2c5e42020-06-18 06:29:21330
Sigurd Schneidere3bf6c22021-02-11 14:35:23331 css_should_bail_out, css_files_to_lint = _getFilesToLint(
Mathias Bynens0ec56612020-06-19 07:14:03332 input_api, output_api, lint_config_files, default_linted_directories,
333 ['.css'], results)
Mathias Bynens1b2c5e42020-06-18 06:29:21334
Sigurd Schneidere3bf6c22021-02-11 14:35:23335 ts_should_bail_out, ts_files_to_lint = _getFilesToLint(
336 input_api, output_api, lint_config_files, default_linted_directories,
337 ['.ts'], results)
338
Sigurd Schneiderf3a1ecd2021-03-02 14:46:03339 # If there are more than 50 files to check, don't bother and check
340 # everything, so as to not run into command line length limits on Windows.
341 if not css_should_bail_out:
342 if len(css_files_to_lint) < 50:
343 script_args = ["--files"] + css_files_to_lint
344 else:
345 script_args = [] # The defaults check all CSS files.
346 results.extend(
347 _checkWithNodeScript(input_api, output_api, lint_path,
348 script_args))
349
Sigurd Schneidere3bf6c22021-02-11 14:35:23350 if not ts_should_bail_out:
Sigurd Schneiderf3a1ecd2021-03-02 14:46:03351 script_args = ["--syntax", "html"]
352 if len(ts_files_to_lint) < 50:
353 script_args += ["--files"] + ts_files_to_lint
354 else:
355 script_args += ["--glob", "front_end/**/*.ts"]
Sigurd Schneidere3bf6c22021-02-11 14:35:23356 results.extend(
357 _checkWithNodeScript(input_api, output_api, lint_path,
358 script_args))
359
Jack Franklinbc302342021-01-18 10:03:30360 return results
Mathias Bynens1b2c5e42020-06-18 06:29:21361
362
Tim van der Lippea53672d2021-07-08 14:52:35363def _CheckDevToolsNonJSFileLicenseHeaders(input_api, output_api):
Tim van der Lippe81752502021-05-26 14:38:12364 results = [
365 output_api.PresubmitNotifyResult(
366 'Python-like file license header check:')
367 ]
Tim van der Lippea53672d2021-07-08 14:52:35368 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
369 'scripts', 'test',
370 'run_header_check_non_js_files.js')
Tim van der Lippe81752502021-05-26 14:38:12371
372 front_end_directory = input_api.os_path.join(
373 input_api.PresubmitLocalPath(), 'front_end')
374 inspector_overlay_directory = input_api.os_path.join(
375 input_api.PresubmitLocalPath(), 'inspector_overlay')
376 test_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
377 'test')
378 scripts_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
379 'scripts')
Tim van der Lippe8b929542021-05-26 14:54:20380 config_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
381 'config')
Tim van der Lippe81752502021-05-26 14:38:12382
383 default_linted_directories = [
384 front_end_directory, test_directory, scripts_directory,
Tim van der Lippe8b929542021-05-26 14:54:20385 inspector_overlay_directory, config_directory
Tim van der Lippe81752502021-05-26 14:38:12386 ]
387
388 check_related_files = [lint_path]
389
390 lint_config_files = _getAffectedFiles(input_api, check_related_files, [],
391 ['.js'])
392
393 should_bail_out, files_to_lint = _getFilesToLint(
394 input_api, output_api, lint_config_files, default_linted_directories,
Tim van der Lippea53672d2021-07-08 14:52:35395 ['BUILD.gn', '.gni', '.css'], results)
Tim van der Lippe81752502021-05-26 14:38:12396 if should_bail_out:
397 return results
398
399 # If there are more than 50 files to check, don't bother and check
400 # everything, so as to not run into command line length limits on Windows.
401 if len(files_to_lint) > 50:
402 files_to_lint = []
403
404 results.extend(
405 _checkWithNodeScript(input_api, output_api, lint_path, files_to_lint))
406 return results
407
408
Tim van der Lippe4d004ec2020-03-03 18:32:01409def _CheckGeneratedFiles(input_api, output_api):
Tim van der Lippeb3b90762020-03-04 15:21:52410 v8_directory_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'v8')
411 blink_directory_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'blink')
412 protocol_location = input_api.os_path.join(blink_directory_path, 'public', 'devtools_protocol')
413 scripts_build_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'build')
Tim van der Lippe5d2d79b2020-03-23 11:45:04414 scripts_generated_output_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end', 'generated')
Tim van der Lippeb3b90762020-03-04 15:21:52415
416 generated_aria_path = input_api.os_path.join(scripts_build_path, 'generate_aria.py')
417 generated_supported_css_path = input_api.os_path.join(scripts_build_path, 'generate_supported_css.py')
418 generated_protocol_path = input_api.os_path.join(scripts_build_path, 'code_generator_frontend.py')
Tim van der Lippe2a1eac22021-05-13 15:19:29419 generated_protocol_typescript_path = input_api.os_path.join(
420 input_api.PresubmitLocalPath(), 'scripts', 'protocol_typescript')
Tim van der Lippeb3b90762020-03-04 15:21:52421 concatenate_protocols_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'inspector_protocol',
422 'concatenate_protocols.py')
423
424 affected_files = _getAffectedFiles(input_api, [
425 v8_directory_path,
426 blink_directory_path,
Tim van der Lippe2a1eac22021-05-13 15:19:29427 input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party',
428 'pyjson5'),
Tim van der Lippeb3b90762020-03-04 15:21:52429 generated_aria_path,
430 generated_supported_css_path,
431 concatenate_protocols_path,
432 generated_protocol_path,
Tim van der Lippe5d2d79b2020-03-23 11:45:04433 scripts_generated_output_path,
Tim van der Lippe2a1eac22021-05-13 15:19:29434 generated_protocol_typescript_path,
435 ], [], ['.pdl', '.json5', '.py', '.js', '.ts'])
Tim van der Lippeb3b90762020-03-04 15:21:52436
437 if len(affected_files) == 0:
Tim van der Lippefb023462020-08-21 13:10:06438 return [
439 output_api.PresubmitNotifyResult(
440 'No affected files for generated files check')
441 ]
Tim van der Lippeb3b90762020-03-04 15:21:52442
Tim van der Lippe4d004ec2020-03-03 18:32:01443 results = [output_api.PresubmitNotifyResult('Running Generated Files Check:')]
Tim van der Lippeb0d65f12020-03-05 12:15:24444 generate_protocol_resources_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'deps',
445 'generate_protocol_resources.py')
Tim van der Lippe4d004ec2020-03-03 18:32:01446
Tim van der Lippeb0d65f12020-03-05 12:15:24447 return _ExecuteSubProcess(input_api, output_api, generate_protocol_resources_path, [], results)
Tim van der Lippe4d004ec2020-03-03 18:32:01448
449
Christy Chen2d6d9a62020-09-22 16:04:09450def _CollectStrings(input_api, output_api):
451 devtools_root = input_api.PresubmitLocalPath()
452 devtools_front_end = input_api.os_path.join(devtools_root, 'front_end')
Tim van der Lippe25f11082021-06-24 15:28:08453 script_path = input_api.os_path.join(devtools_root, 'third_party', 'i18n',
454 'collect-strings.js')
455 affected_front_end_files = _getAffectedFiles(
456 input_api, [devtools_front_end, script_path], [], ['.js', '.ts'])
Christy Chen2d6d9a62020-09-22 16:04:09457 if len(affected_front_end_files) == 0:
458 return [
459 output_api.PresubmitNotifyResult(
460 'No affected files to run collect-strings')
461 ]
462
463 results = [
464 output_api.PresubmitNotifyResult('Collecting strings from front_end:')
465 ]
Tim van der Lippe25f11082021-06-24 15:28:08466 results.extend(
467 _checkWithNodeScript(input_api, output_api, script_path,
468 [devtools_front_end]))
Christy Chen2d6d9a62020-09-22 16:04:09469 results.append(
470 output_api.PresubmitNotifyResult(
Peter Marshalld67e9f12021-02-08 09:34:35471 'Please commit en-US.json/en-XL.json if changes are generated.'))
Christy Chen2d6d9a62020-09-22 16:04:09472 return results
473
474
Tim van der Lippe5279f842020-01-14 16:26:38475def _CheckNoUncheckedFiles(input_api, output_api):
476 results = []
477 process = input_api.subprocess.Popen(['git', 'diff', '--exit-code'],
478 stdout=input_api.subprocess.PIPE,
479 stderr=input_api.subprocess.STDOUT)
480 out, _ = process.communicate()
481 if process.returncode != 0:
Jack Franklin324f3042020-09-03 10:28:29482 files_changed_process = input_api.subprocess.Popen(
Tim van der Lippe25f11082021-06-24 15:28:08483 ['git', 'diff'],
Jack Franklin324f3042020-09-03 10:28:29484 stdout=input_api.subprocess.PIPE,
485 stderr=input_api.subprocess.STDOUT)
Tim van der Lippe9bb1cf62020-03-06 16:17:02486 files_changed, _ = files_changed_process.communicate()
487
488 return [
Tim van der Lippefb1dc172021-05-11 15:40:26489 output_api.PresubmitError(
490 'You have changed files that need to be committed:'),
491 output_api.PresubmitError(files_changed.decode('utf-8'))
Tim van der Lippe9bb1cf62020-03-06 16:17:02492 ]
Tim van der Lippe5279f842020-01-14 16:26:38493 return []
494
Tim van der Lippe8fdda112020-01-27 11:27:06495def _CheckForTooLargeFiles(input_api, output_api):
Christy Chen1ab87e02020-01-31 00:32:16496 """Avoid large files, especially binary files, in the repository since
Tim van der Lippe8fdda112020-01-27 11:27:06497 git doesn't scale well for those. They will be in everyone's repo
498 clones forever, forever making Chromium slower to clone and work
499 with."""
Christy Chen1ab87e02020-01-31 00:32:16500 # Uploading files to cloud storage is not trivial so we don't want
501 # to set the limit too low, but the upper limit for "normal" large
502 # files seems to be 1-2 MB, with a handful around 5-8 MB, so
503 # anything over 20 MB is exceptional.
504 TOO_LARGE_FILE_SIZE_LIMIT = 20 * 1024 * 1024 # 10 MB
505 too_large_files = []
506 for f in input_api.AffectedFiles():
507 # Check both added and modified files (but not deleted files).
508 if f.Action() in ('A', 'M'):
509 size = input_api.os_path.getsize(f.AbsoluteLocalPath())
510 if size > TOO_LARGE_FILE_SIZE_LIMIT:
511 too_large_files.append("%s: %d bytes" % (f.LocalPath(), size))
512 if too_large_files:
513 message = (
514 'Do not commit large files to git since git scales badly for those.\n' +
515 'Instead put the large files in cloud storage and use DEPS to\n' +
516 'fetch them.\n' + '\n'.join(too_large_files)
517 )
518 return [output_api.PresubmitError(
519 'Too large files found in commit', long_text=message + '\n')]
520 else:
521 return []
Tim van der Lippe8fdda112020-01-27 11:27:06522
Tim van der Lippe5279f842020-01-14 16:26:38523
Tim van der Lippef8a87092020-09-14 12:01:18524def _RunCannedChecks(input_api, output_api):
525 results = []
526 results.extend(
527 input_api.canned_checks.CheckOwnersFormat(input_api, output_api))
528 results.extend(input_api.canned_checks.CheckOwners(input_api, output_api))
529 results.extend(
530 input_api.canned_checks.CheckChangeHasNoCrAndHasOnlyOneEol(
531 input_api, output_api))
532 results.extend(
533 input_api.canned_checks.CheckChangeHasNoStrayWhitespace(
Tim van der Lippe69775382021-05-27 16:06:12534 input_api,
535 output_api,
536 source_file_filter=lambda file: not file.LocalPath().startswith(
537 'node_modules')))
Tim van der Lippef8a87092020-09-14 12:01:18538 results.extend(
539 input_api.canned_checks.CheckGenderNeutral(input_api, output_api))
540 return results
541
542
Yang Guo4fd355c2019-09-19 08:59:03543def _CommonChecks(input_api, output_api):
Mathias Bynens032591d2019-10-21 09:51:31544 """Checks common to both upload and commit."""
545 results = []
Mathias Bynens011b0072020-08-05 08:17:35546 results.extend(
547 input_api.canned_checks.CheckAuthorizedAuthor(
548 input_api, output_api, bot_allowlist=[AUTOROLL_ACCOUNT]))
Blink Reformat4c46d092018-04-07 15:32:37549 results.extend(_CheckBuildGN(input_api, output_api))
Brandon Goddard33104372020-08-13 15:49:23550 results.extend(_CheckExperimentTelemetry(input_api, output_api))
Tim van der Lippe4d004ec2020-03-03 18:32:01551 results.extend(_CheckGeneratedFiles(input_api, output_api))
Tim van der Lippee4bdd742019-12-17 15:40:16552 results.extend(_CheckJSON(input_api, output_api))
Mathias Bynens1b2c5e42020-06-18 06:29:21553 results.extend(_CheckDevToolsStyleJS(input_api, output_api))
554 results.extend(_CheckDevToolsStyleCSS(input_api, output_api))
Jack Franklin1aa212d2021-09-10 14:20:08555 results.extend(_CheckDevToolsRunESLintTests(input_api, output_api))
Tim van der Lippea53672d2021-07-08 14:52:35556 results.extend(_CheckDevToolsNonJSFileLicenseHeaders(
557 input_api, output_api))
Jack Franklinb10193f2021-03-19 10:25:08558
Tim van der Lippe5497d482020-01-14 15:27:30559 results.extend(_CheckFormat(input_api, output_api))
Yang Guoa7845d52019-10-31 10:30:23560 results.extend(_CheckChangesAreExclusiveToDirectory(input_api, output_api))
Tim van der Lippef8a87092020-09-14 12:01:18561 # Run the canned checks from `depot_tools` after the custom DevTools checks.
562 # The canned checks for example check that lines have line endings. The
563 # DevTools presubmit checks automatically fix these issues. If we would run
564 # the canned checks before the DevTools checks, they would erroneously conclude
565 # that there are issues in the code. Since the canned checks are allowed to be
566 # ignored, a confusing message is shown that asks if the failed presubmit can
567 # be continued regardless. By fixing the issues before we reach the canned checks,
568 # we don't show the message to suppress these errors, which would otherwise be
569 # causing CQ to fail.
570 results.extend(_RunCannedChecks(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 13:43:25571 return results
572
573
574def _SideEffectChecks(input_api, output_api):
575 """Check side effects caused by other checks"""
576 results = []
Tim van der Lippe5279f842020-01-14 16:26:38577 results.extend(_CheckNoUncheckedFiles(input_api, output_api))
Tim van der Lippe8fdda112020-01-27 11:27:06578 results.extend(_CheckForTooLargeFiles(input_api, output_api))
Blink Reformat4c46d092018-04-07 15:32:37579 return results
580
581
Liviu Raud614e092020-01-08 09:56:33582def CheckChangeOnUpload(input_api, output_api):
583 results = []
584 results.extend(_CommonChecks(input_api, output_api))
Christy Chen2d6d9a62020-09-22 16:04:09585 results.extend(_CollectStrings(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 13:43:25586 # Run checks that rely on output from other DevTool checks
587 results.extend(_SideEffectChecks(input_api, output_api))
Sigurd Schneider5c9b4f92021-01-22 10:09:55588 results.extend(_CheckBugAssociation(input_api, output_api, False))
Liviu Raud614e092020-01-08 09:56:33589 return results
590
591
Blink Reformat4c46d092018-04-07 15:32:37592def CheckChangeOnCommit(input_api, output_api):
Mandy Chenf0fbdbe2019-08-22 23:58:37593 results = []
Yang Guo4fd355c2019-09-19 08:59:03594 results.extend(_CommonChecks(input_api, output_api))
Christy Chen2d6d9a62020-09-22 16:04:09595 results.extend(_CollectStrings(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 13:43:25596 # Run checks that rely on output from other DevTool checks
597 results.extend(_SideEffectChecks(input_api, output_api))
Mathias Bynens032591d2019-10-21 09:51:31598 results.extend(input_api.canned_checks.CheckChangeHasDescription(input_api, output_api))
Sigurd Schneider5c9b4f92021-01-22 10:09:55599 results.extend(_CheckBugAssociation(input_api, output_api, True))
Mandy Chenf0fbdbe2019-08-22 23:58:37600 return results
Blink Reformat4c46d092018-04-07 15:32:37601
602
Mandy Chena6be46a2019-07-09 17:06:27603def _getAffectedFiles(input_api, parent_directories, excluded_actions, accepted_endings): # pylint: disable=invalid-name
Yang Guo75beda92019-10-28 07:29:25604 """Return absolute file paths of affected files (not due to an excluded action)
Mandy Chena6be46a2019-07-09 17:06:27605 under a parent directory with an accepted file ending.
Yang Guo75beda92019-10-28 07:29:25606 """
Mandy Chena6be46a2019-07-09 17:06:27607 local_paths = [
608 f.AbsoluteLocalPath() for f in input_api.AffectedFiles() if all(f.Action() != action for action in excluded_actions)
609 ]
610 affected_files = [
Tim van der Lippefb1dc172021-05-11 15:40:26611 file_name for file_name in local_paths
612 if any(parent_directory in file_name
613 for parent_directory in parent_directories) and (
614 len(accepted_endings) == 0 or any(
615 file_name.endswith(accepted_ending)
616 for accepted_ending in accepted_endings))
Mandy Chena6be46a2019-07-09 17:06:27617 ]
618 return affected_files
619
620
Tim van der Lippec4617122020-03-06 16:24:19621def _checkWithNodeScript(input_api, output_api, script_path, script_arguments=[]): # pylint: disable=invalid-name
Blink Reformat4c46d092018-04-07 15:32:37622 original_sys_path = sys.path
623 try:
Yang Guo75beda92019-10-28 07:29:25624 sys.path = sys.path + [input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts')]
Yang Guod8176982019-10-04 20:30:35625 import devtools_paths
Blink Reformat4c46d092018-04-07 15:32:37626 finally:
627 sys.path = original_sys_path
628
Tim van der Lippec4617122020-03-06 16:24:19629 return _ExecuteSubProcess(input_api, output_api, [devtools_paths.node_path(), script_path], script_arguments, [])
Mathias Bynens1b2c5e42020-06-18 06:29:21630
631
Jack Franklin324f3042020-09-03 10:28:29632def _checkWithTypeScript(input_api,
633 output_api,
634 tsc_arguments,
635 script_path,
636 script_arguments=[]): # pylint: disable=invalid-name
637 original_sys_path = sys.path
638 try:
639 sys.path = sys.path + [
640 input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts')
641 ]
642 import devtools_paths
643 finally:
644 sys.path = original_sys_path
645
646 # First run tsc to compile the TS script that we then run in the _ExecuteSubProcess call
647 tsc_compiler_process = input_api.subprocess.Popen(
648 [
649 devtools_paths.node_path(),
650 devtools_paths.typescript_compiler_path()
651 ] + tsc_arguments,
652 stdout=input_api.subprocess.PIPE,
653 stderr=input_api.subprocess.STDOUT)
654
655 out, _ = tsc_compiler_process.communicate()
656 if tsc_compiler_process.returncode != 0:
657 return [
658 output_api.PresubmitError('Error compiling briges regenerator:\n' +
Tim van der Lippefb1dc172021-05-11 15:40:26659 out.decode('utf-8'))
Jack Franklin324f3042020-09-03 10:28:29660 ]
661
662 return _checkWithNodeScript(input_api, output_api, script_path,
663 script_arguments)
664
665
Mathias Bynens1b2c5e42020-06-18 06:29:21666def _getFilesToLint(input_api, output_api, lint_config_files,
667 default_linted_directories, accepted_endings, results):
Mathias Bynens0ec56612020-06-19 07:14:03668 run_full_check = False
Mathias Bynens1b2c5e42020-06-18 06:29:21669 files_to_lint = []
670
671 # We are changing the lint configuration; run the full check.
Tim van der Lippefb1dc172021-05-11 15:40:26672 if len(lint_config_files) != 0:
Mathias Bynens1b2c5e42020-06-18 06:29:21673 results.append(
674 output_api.PresubmitNotifyResult('Running full lint check'))
Mathias Bynens0ec56612020-06-19 07:14:03675 run_full_check = True
Mathias Bynens1b2c5e42020-06-18 06:29:21676 else:
677 # Only run the linter on files that are relevant, to save PRESUBMIT time.
678 files_to_lint = _getAffectedFiles(input_api,
679 default_linted_directories, ['D'],
680 accepted_endings)
681
Paul Lewis2b9224f2020-09-08 17:13:10682 # Exclude front_end/third_party files.
Tim van der Lippefb1dc172021-05-11 15:40:26683 files_to_lint = [
684 file for file in files_to_lint if "third_party" not in file
685 ]
Paul Lewis2b9224f2020-09-08 17:13:10686
Tim van der Lippefb1dc172021-05-11 15:40:26687 if len(files_to_lint) == 0:
Mathias Bynens1b2c5e42020-06-18 06:29:21688 results.append(
689 output_api.PresubmitNotifyResult(
690 'No affected files for lint check'))
691
Tim van der Lippefb1dc172021-05-11 15:40:26692 should_bail_out = len(files_to_lint) == 0 and not run_full_check
Mathias Bynens0ec56612020-06-19 07:14:03693 return should_bail_out, files_to_lint