blob: 66db9934b6c606383cd9417d45daad9f7047dc6d [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"
Tim van der Lippefb1dc172021-05-11 16:40:26 +010040USE_PYTHON3 = True
Mathias Bynensa0a6e292019-12-17 13:24:08 +010041
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000042
43def _ExecuteSubProcess(input_api, output_api, script_path, args, results):
Tim van der Lippef515fdc2020-03-06 16:18:25 +000044 if isinstance(script_path, six.string_types):
45 script_path = [input_api.python_executable, script_path]
46
Tim van der Lippefb023462020-08-21 14:10:06 +010047 start_time = time.time()
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +010048 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:01 +000051 out, _ = process.communicate()
Tim van der Lippefb023462020-08-21 14:10:06 +010052 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:01 +000056 if process.returncode != 0:
Tim van der Lippefb1dc172021-05-11 16:40:26 +010057 results.append(
58 output_api.PresubmitError(time_info + out.decode('utf-8')))
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000059 else:
Tim van der Lippefb1dc172021-05-11 16:40:26 +010060 results.append(
61 output_api.PresubmitNotifyResult(time_info + out.decode('utf-8')))
Tim van der Lippe4d004ec2020-03-03 18:32:01 +000062 return results
63
64
Yang Guoa7845d52019-10-31 11:30:23 +010065def _CheckChangesAreExclusiveToDirectory(input_api, output_api):
Tim van der Lippebc42a632019-11-28 14:22:55 +000066 if input_api.change.DISABLE_THIRD_PARTY_CHECK != None:
67 return []
Brandon Goddarde7028672020-01-30 09:31:04 -080068 results = [output_api.PresubmitNotifyResult('Directory Exclusivity Check:')]
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +010069
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
Tim van der Lippe4050a302021-04-13 10:21:21 +010082 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 10:21:21 +010089 '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 11:30:23 +010095 affected_files = input_api.LocalPaths()
Yang Guoa7845d52019-10-31 11:30:23 +010096 num_affected = len(affected_files)
97 for dirs in EXCLUSIVE_CHANGE_DIRECTORIES:
Paul Lewis14effba2019-12-02 14:56:40 +000098 dir_list = ', '.join(dirs)
Tim van der Lippefb1dc172021-05-11 16:40:26 +010099 affected_in_dir = [
100 file for file in affected_files if FileIsInDir(file, dirs)
101 ]
Yang Guoa7845d52019-10-31 11:30:23 +0100102 num_in_dir = len(affected_in_dir)
103 if num_in_dir == 0:
104 continue
Tim van der Lippeebb94a92019-11-19 17:07:53 +0000105 # 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 11:30:23 +0100108 if num_in_dir < num_affected:
Tim van der Lippe239963b2021-04-09 10:43:38 +0100109 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 09:31:04 -0800119 break
120
121 return results
Yang Guoa7845d52019-10-31 11:30:23 +0100122
Blink Reformat4c46d092018-04-07 15:32:37 +0000123
Sigurd Schneider5c9b4f92021-01-22 11:09:55 +0100124def _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:37 +0000148def _CheckBuildGN(input_api, output_api):
Brandon Goddarde7028672020-01-30 09:31:04 -0800149 results = [output_api.PresubmitNotifyResult('Running BUILD.GN check:')]
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +0100150 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
151 'scripts', 'check_gn.js')
Brandon Goddarde7028672020-01-30 09:31:04 -0800152 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
153 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000154
155
Brandon Goddard33104372020-08-13 08:49:23 -0700156def _CheckExperimentTelemetry(input_api, output_api):
Brandon Goddard33104372020-08-13 08:49:23 -0700157 experiment_telemetry_files = [
158 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
Christy Chenab9a44d2021-07-02 12:54:30 -0700159 'entrypoints', 'main', 'MainImpl.ts'),
Brandon Goddard33104372020-08-13 08:49:23 -0700160 input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end',
Tim van der Lippee0247312021-04-01 15:25:30 +0100161 'core', 'host', 'UserMetrics.ts')
Brandon Goddard33104372020-08-13 08:49:23 -0700162 ]
163 affected_main_files = _getAffectedFiles(input_api,
164 experiment_telemetry_files, [],
Christy Chenab9a44d2021-07-02 12:54:30 -0700165 ['.ts'])
Brandon Goddard33104372020-08-13 08:49:23 -0700166 if len(affected_main_files) == 0:
Tim van der Lippefb023462020-08-21 14:10:06 +0100167 return [
168 output_api.PresubmitNotifyResult(
169 'No affected files for telemetry check')
170 ]
Brandon Goddard33104372020-08-13 08:49:23 -0700171
Tim van der Lippefb023462020-08-21 14:10:06 +0100172 results = [
173 output_api.PresubmitNotifyResult('Running Experiment Telemetry check:')
174 ]
Brandon Goddard33104372020-08-13 08:49:23 -0700175 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 16:40:16 +0100181def _CheckJSON(input_api, output_api):
Brandon Goddarde7028672020-01-30 09:31:04 -0800182 results = [output_api.PresubmitNotifyResult('Running JSON Validator:')]
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +0100183 script_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
184 'scripts', 'json_validator',
185 'validate_module_json.js')
Brandon Goddarde7028672020-01-30 09:31:04 -0800186 results.extend(_checkWithNodeScript(input_api, output_api, script_path))
187 return results
Tim van der Lippee4bdd742019-12-17 16:40:16 +0100188
189
Blink Reformat4c46d092018-04-07 15:32:37 +0000190def _CheckFormat(input_api, output_api):
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +0100191 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 15:14:36 +0100194
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 09:31:04 -0800199 results = [output_api.PresubmitNotifyResult('Running Format Checks:')]
Blink Reformat4c46d092018-04-07 15:32:37 +0000200
Tim van der Lippef515fdc2020-03-06 16:18:25 +0000201 return _ExecuteSubProcess(input_api, output_api, ['git', 'cl', 'format', '--js'], [], results)
Blink Reformat4c46d092018-04-07 15:32:37 +0000202
Jack Franklin1aa212d2021-09-10 15:20:08 +0100203
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 14:40:56 +0100209 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 15:20:08 +0100217 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 14:40:56 +0100226 mocha_path = devtools_paths.mocha_path()
Jack Franklin1aa212d2021-09-10 15:20:08 +0100227 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 08:29:21 +0200239def _CheckDevToolsStyleJS(input_api, output_api):
Tim van der Lippefb023462020-08-21 14:10:06 +0100240 results = [output_api.PresubmitNotifyResult('JS style check:')]
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200241 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
242 'scripts', 'test',
Tim van der Lippef9e565e2021-11-08 16:22:11 +0000243 'run_lint_check_js.mjs')
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000244
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200245 front_end_directory = input_api.os_path.join(
246 input_api.PresubmitLocalPath(), 'front_end')
Jack Franklinbcfd6ad2021-02-17 10:12:50 +0000247 component_docs_directory = input_api.os_path.join(front_end_directory,
Tim van der Lippee622f552021-04-14 15:15:18 +0100248 'ui', 'components',
249 'docs')
Alex Rudenko5556a902020-09-29 09:37:23 +0000250 inspector_overlay_directory = input_api.os_path.join(
251 input_api.PresubmitLocalPath(), 'inspector_overlay')
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200252 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:06 +0000256
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200257 default_linted_directories = [
Alex Rudenko5556a902020-09-29 09:37:23 +0000258 front_end_directory, test_directory, scripts_directory,
259 inspector_overlay_directory
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200260 ]
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000261
262 eslint_related_files = [
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200263 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
264 'eslint'),
Tim van der Lippecf4ab402021-02-12 14:30:58 +0000265 input_api.os_path.join(input_api.PresubmitLocalPath(), 'node_modules',
266 '@typescript-eslint'),
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000267 input_api.os_path.join(input_api.PresubmitLocalPath(), '.eslintrc.js'),
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200268 input_api.os_path.join(input_api.PresubmitLocalPath(),
269 '.eslintignore'),
Tim van der Lippe33543ac2020-12-14 15:37:45 +0100270 input_api.os_path.join(front_end_directory, '.eslintrc.js'),
Jack Franklinbcfd6ad2021-02-17 10:12:50 +0000271 input_api.os_path.join(component_docs_directory, '.eslintrc.js'),
Tim van der Lippe406249f2020-12-14 15:59:10 +0100272 input_api.os_path.join(test_directory, '.eslintrc.js'),
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200273 input_api.os_path.join(scripts_directory, 'test',
274 'run_lint_check_js.py'),
275 input_api.os_path.join(scripts_directory, 'test',
Tim van der Lippef9e565e2021-11-08 16:22:11 +0000276 'run_lint_check_js.mjs'),
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000277 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 08:29:21 +0200281 lint_config_files = _getAffectedFiles(input_api, eslint_related_files, [],
282 ['.js', '.py', '.eslintignore'])
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000283
Mathias Bynens0ec56612020-06-19 09:14:03 +0200284 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 08:29:21 +0200288 return results
Tim van der Lippe2a4ae2b2020-03-11 17:28:06 +0000289
Brandon Goddarde34e94f2021-04-12 10:58:26 -0700290 # 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 08:29:21 +0200295 results.extend(
296 _checkWithNodeScript(input_api, output_api, lint_path, files_to_lint))
Tim van der Lippe98132242020-04-14 17:16:54 +0100297 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000298
299
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200300def _CheckDevToolsStyleCSS(input_api, output_api):
Tim van der Lippefb023462020-08-21 14:10:06 +0100301 results = [output_api.PresubmitNotifyResult('CSS style check:')]
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200302 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
303 'scripts', 'test',
Jack Franklinbc302342021-01-18 10:03:30 +0000304 'run_lint_check_css.js')
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200305
306 front_end_directory = input_api.os_path.join(
307 input_api.PresubmitLocalPath(), 'front_end')
Alex Rudenko5556a902020-09-29 09:37:23 +0000308 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 08:29:21 +0200313
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 10:44:28 +0100325 'run_lint_check_css.js'),
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200326 ]
327
328 lint_config_files = _getAffectedFiles(input_api, stylelint_related_files,
Sigurd Schneider6523c512021-02-12 10:44:28 +0100329 [], [])
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200330
Sigurd Schneidere3bf6c22021-02-11 15:35:23 +0100331 css_should_bail_out, css_files_to_lint = _getFilesToLint(
Mathias Bynens0ec56612020-06-19 09:14:03 +0200332 input_api, output_api, lint_config_files, default_linted_directories,
333 ['.css'], results)
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200334
Sigurd Schneiderf3a1ecd2021-03-02 15:46:03 +0100335 # If there are more than 50 files to check, don't bother and check
336 # everything, so as to not run into command line length limits on Windows.
337 if not css_should_bail_out:
338 if len(css_files_to_lint) < 50:
339 script_args = ["--files"] + css_files_to_lint
340 else:
341 script_args = [] # The defaults check all CSS files.
342 results.extend(
343 _checkWithNodeScript(input_api, output_api, lint_path,
344 script_args))
345
Jack Franklinbc302342021-01-18 10:03:30 +0000346 return results
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200347
348
Tim van der Lippea53672d2021-07-08 15:52:35 +0100349def _CheckDevToolsNonJSFileLicenseHeaders(input_api, output_api):
Tim van der Lippe81752502021-05-26 15:38:12 +0100350 results = [
351 output_api.PresubmitNotifyResult(
352 'Python-like file license header check:')
353 ]
Tim van der Lippea53672d2021-07-08 15:52:35 +0100354 lint_path = input_api.os_path.join(input_api.PresubmitLocalPath(),
355 'scripts', 'test',
356 'run_header_check_non_js_files.js')
Tim van der Lippe81752502021-05-26 15:38:12 +0100357
358 front_end_directory = input_api.os_path.join(
359 input_api.PresubmitLocalPath(), 'front_end')
360 inspector_overlay_directory = input_api.os_path.join(
361 input_api.PresubmitLocalPath(), 'inspector_overlay')
362 test_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
363 'test')
364 scripts_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
365 'scripts')
Tim van der Lippe8b929542021-05-26 15:54:20 +0100366 config_directory = input_api.os_path.join(input_api.PresubmitLocalPath(),
367 'config')
Tim van der Lippe81752502021-05-26 15:38:12 +0100368
369 default_linted_directories = [
370 front_end_directory, test_directory, scripts_directory,
Tim van der Lippe8b929542021-05-26 15:54:20 +0100371 inspector_overlay_directory, config_directory
Tim van der Lippe81752502021-05-26 15:38:12 +0100372 ]
373
374 check_related_files = [lint_path]
375
376 lint_config_files = _getAffectedFiles(input_api, check_related_files, [],
377 ['.js'])
378
379 should_bail_out, files_to_lint = _getFilesToLint(
380 input_api, output_api, lint_config_files, default_linted_directories,
Tim van der Lippea53672d2021-07-08 15:52:35 +0100381 ['BUILD.gn', '.gni', '.css'], results)
Tim van der Lippe81752502021-05-26 15:38:12 +0100382 if should_bail_out:
383 return results
384
385 # If there are more than 50 files to check, don't bother and check
386 # everything, so as to not run into command line length limits on Windows.
387 if len(files_to_lint) > 50:
388 files_to_lint = []
389
390 results.extend(
391 _checkWithNodeScript(input_api, output_api, lint_path, files_to_lint))
392 return results
393
394
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000395def _CheckGeneratedFiles(input_api, output_api):
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000396 v8_directory_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'v8')
397 blink_directory_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'blink')
398 protocol_location = input_api.os_path.join(blink_directory_path, 'public', 'devtools_protocol')
399 scripts_build_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'build')
Tim van der Lippe5d2d79b2020-03-23 11:45:04 +0000400 scripts_generated_output_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'front_end', 'generated')
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000401
402 generated_aria_path = input_api.os_path.join(scripts_build_path, 'generate_aria.py')
403 generated_supported_css_path = input_api.os_path.join(scripts_build_path, 'generate_supported_css.py')
404 generated_protocol_path = input_api.os_path.join(scripts_build_path, 'code_generator_frontend.py')
Tim van der Lippe2a1eac22021-05-13 16:19:29 +0100405 generated_protocol_typescript_path = input_api.os_path.join(
406 input_api.PresubmitLocalPath(), 'scripts', 'protocol_typescript')
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000407 concatenate_protocols_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party', 'inspector_protocol',
408 'concatenate_protocols.py')
409
410 affected_files = _getAffectedFiles(input_api, [
411 v8_directory_path,
412 blink_directory_path,
Tim van der Lippe2a1eac22021-05-13 16:19:29 +0100413 input_api.os_path.join(input_api.PresubmitLocalPath(), 'third_party',
414 'pyjson5'),
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000415 generated_aria_path,
416 generated_supported_css_path,
417 concatenate_protocols_path,
418 generated_protocol_path,
Tim van der Lippe5d2d79b2020-03-23 11:45:04 +0000419 scripts_generated_output_path,
Tim van der Lippe2a1eac22021-05-13 16:19:29 +0100420 generated_protocol_typescript_path,
421 ], [], ['.pdl', '.json5', '.py', '.js', '.ts'])
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000422
423 if len(affected_files) == 0:
Tim van der Lippefb023462020-08-21 14:10:06 +0100424 return [
425 output_api.PresubmitNotifyResult(
426 'No affected files for generated files check')
427 ]
Tim van der Lippeb3b90762020-03-04 15:21:52 +0000428
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000429 results = [output_api.PresubmitNotifyResult('Running Generated Files Check:')]
Tim van der Lippeb0d65f12020-03-05 12:15:24 +0000430 generate_protocol_resources_path = input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts', 'deps',
431 'generate_protocol_resources.py')
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000432
Tim van der Lippeb0d65f12020-03-05 12:15:24 +0000433 return _ExecuteSubProcess(input_api, output_api, generate_protocol_resources_path, [], results)
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000434
435
Christy Chen2d6d9a62020-09-22 09:04:09 -0700436def _CollectStrings(input_api, output_api):
437 devtools_root = input_api.PresubmitLocalPath()
438 devtools_front_end = input_api.os_path.join(devtools_root, 'front_end')
Tim van der Lippe25f11082021-06-24 16:28:08 +0100439 script_path = input_api.os_path.join(devtools_root, 'third_party', 'i18n',
440 'collect-strings.js')
441 affected_front_end_files = _getAffectedFiles(
442 input_api, [devtools_front_end, script_path], [], ['.js', '.ts'])
Christy Chen2d6d9a62020-09-22 09:04:09 -0700443 if len(affected_front_end_files) == 0:
444 return [
445 output_api.PresubmitNotifyResult(
446 'No affected files to run collect-strings')
447 ]
448
449 results = [
450 output_api.PresubmitNotifyResult('Collecting strings from front_end:')
451 ]
Tim van der Lippe25f11082021-06-24 16:28:08 +0100452 results.extend(
453 _checkWithNodeScript(input_api, output_api, script_path,
454 [devtools_front_end]))
Christy Chen2d6d9a62020-09-22 09:04:09 -0700455 results.append(
456 output_api.PresubmitNotifyResult(
Peter Marshalld67e9f12021-02-08 10:34:35 +0100457 'Please commit en-US.json/en-XL.json if changes are generated.'))
Christy Chen2d6d9a62020-09-22 09:04:09 -0700458 return results
459
460
Tim van der Lippe5279f842020-01-14 16:26:38 +0000461def _CheckNoUncheckedFiles(input_api, output_api):
462 results = []
463 process = input_api.subprocess.Popen(['git', 'diff', '--exit-code'],
464 stdout=input_api.subprocess.PIPE,
465 stderr=input_api.subprocess.STDOUT)
466 out, _ = process.communicate()
467 if process.returncode != 0:
Jack Franklin324f3042020-09-03 11:28:29 +0100468 files_changed_process = input_api.subprocess.Popen(
Tim van der Lippe25f11082021-06-24 16:28:08 +0100469 ['git', 'diff'],
Jack Franklin324f3042020-09-03 11:28:29 +0100470 stdout=input_api.subprocess.PIPE,
471 stderr=input_api.subprocess.STDOUT)
Tim van der Lippe9bb1cf62020-03-06 16:17:02 +0000472 files_changed, _ = files_changed_process.communicate()
473
474 return [
Tim van der Lippefb1dc172021-05-11 16:40:26 +0100475 output_api.PresubmitError(
476 'You have changed files that need to be committed:'),
477 output_api.PresubmitError(files_changed.decode('utf-8'))
Tim van der Lippe9bb1cf62020-03-06 16:17:02 +0000478 ]
Tim van der Lippe5279f842020-01-14 16:26:38 +0000479 return []
480
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000481def _CheckForTooLargeFiles(input_api, output_api):
Christy Chen1ab87e02020-01-30 16:32:16 -0800482 """Avoid large files, especially binary files, in the repository since
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000483 git doesn't scale well for those. They will be in everyone's repo
484 clones forever, forever making Chromium slower to clone and work
485 with."""
Christy Chen1ab87e02020-01-30 16:32:16 -0800486 # Uploading files to cloud storage is not trivial so we don't want
487 # to set the limit too low, but the upper limit for "normal" large
488 # files seems to be 1-2 MB, with a handful around 5-8 MB, so
489 # anything over 20 MB is exceptional.
490 TOO_LARGE_FILE_SIZE_LIMIT = 20 * 1024 * 1024 # 10 MB
491 too_large_files = []
492 for f in input_api.AffectedFiles():
493 # Check both added and modified files (but not deleted files).
494 if f.Action() in ('A', 'M'):
495 size = input_api.os_path.getsize(f.AbsoluteLocalPath())
496 if size > TOO_LARGE_FILE_SIZE_LIMIT:
497 too_large_files.append("%s: %d bytes" % (f.LocalPath(), size))
498 if too_large_files:
499 message = (
500 'Do not commit large files to git since git scales badly for those.\n' +
501 'Instead put the large files in cloud storage and use DEPS to\n' +
502 'fetch them.\n' + '\n'.join(too_large_files)
503 )
504 return [output_api.PresubmitError(
505 'Too large files found in commit', long_text=message + '\n')]
506 else:
507 return []
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000508
Tim van der Lippe5279f842020-01-14 16:26:38 +0000509
Tim van der Lippef8a87092020-09-14 13:01:18 +0100510def _RunCannedChecks(input_api, output_api):
511 results = []
512 results.extend(
513 input_api.canned_checks.CheckOwnersFormat(input_api, output_api))
514 results.extend(input_api.canned_checks.CheckOwners(input_api, output_api))
515 results.extend(
516 input_api.canned_checks.CheckChangeHasNoCrAndHasOnlyOneEol(
517 input_api, output_api))
518 results.extend(
519 input_api.canned_checks.CheckChangeHasNoStrayWhitespace(
Tim van der Lippe69775382021-05-27 17:06:12 +0100520 input_api,
521 output_api,
522 source_file_filter=lambda file: not file.LocalPath().startswith(
523 'node_modules')))
Tim van der Lippef8a87092020-09-14 13:01:18 +0100524 results.extend(
525 input_api.canned_checks.CheckGenderNeutral(input_api, output_api))
526 return results
527
528
Yang Guo4fd355c2019-09-19 10:59:03 +0200529def _CommonChecks(input_api, output_api):
Mathias Bynens032591d2019-10-21 11:51:31 +0200530 """Checks common to both upload and commit."""
531 results = []
Mathias Bynens011b0072020-08-05 10:17:35 +0200532 results.extend(
533 input_api.canned_checks.CheckAuthorizedAuthor(
534 input_api, output_api, bot_allowlist=[AUTOROLL_ACCOUNT]))
Blink Reformat4c46d092018-04-07 15:32:37 +0000535 results.extend(_CheckBuildGN(input_api, output_api))
Brandon Goddard33104372020-08-13 08:49:23 -0700536 results.extend(_CheckExperimentTelemetry(input_api, output_api))
Tim van der Lippe4d004ec2020-03-03 18:32:01 +0000537 results.extend(_CheckGeneratedFiles(input_api, output_api))
Tim van der Lippee4bdd742019-12-17 16:40:16 +0100538 results.extend(_CheckJSON(input_api, output_api))
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200539 results.extend(_CheckDevToolsStyleJS(input_api, output_api))
540 results.extend(_CheckDevToolsStyleCSS(input_api, output_api))
Jack Franklin1aa212d2021-09-10 15:20:08 +0100541 results.extend(_CheckDevToolsRunESLintTests(input_api, output_api))
Tim van der Lippea53672d2021-07-08 15:52:35 +0100542 results.extend(_CheckDevToolsNonJSFileLicenseHeaders(
543 input_api, output_api))
Jack Franklinb10193f2021-03-19 10:25:08 +0000544
Tim van der Lippe5497d482020-01-14 15:27:30 +0000545 results.extend(_CheckFormat(input_api, output_api))
Yang Guoa7845d52019-10-31 11:30:23 +0100546 results.extend(_CheckChangesAreExclusiveToDirectory(input_api, output_api))
Tim van der Lippef8a87092020-09-14 13:01:18 +0100547 # Run the canned checks from `depot_tools` after the custom DevTools checks.
548 # The canned checks for example check that lines have line endings. The
549 # DevTools presubmit checks automatically fix these issues. If we would run
550 # the canned checks before the DevTools checks, they would erroneously conclude
551 # that there are issues in the code. Since the canned checks are allowed to be
552 # ignored, a confusing message is shown that asks if the failed presubmit can
553 # be continued regardless. By fixing the issues before we reach the canned checks,
554 # we don't show the message to suppress these errors, which would otherwise be
555 # causing CQ to fail.
556 results.extend(_RunCannedChecks(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 05:43:25 -0800557 return results
558
559
560def _SideEffectChecks(input_api, output_api):
561 """Check side effects caused by other checks"""
562 results = []
Tim van der Lippe5279f842020-01-14 16:26:38 +0000563 results.extend(_CheckNoUncheckedFiles(input_api, output_api))
Tim van der Lippe8fdda112020-01-27 11:27:06 +0000564 results.extend(_CheckForTooLargeFiles(input_api, output_api))
Blink Reformat4c46d092018-04-07 15:32:37 +0000565 return results
566
567
Liviu Raud614e092020-01-08 10:56:33 +0100568def CheckChangeOnUpload(input_api, output_api):
569 results = []
570 results.extend(_CommonChecks(input_api, output_api))
Christy Chen2d6d9a62020-09-22 09:04:09 -0700571 results.extend(_CollectStrings(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 05:43:25 -0800572 # Run checks that rely on output from other DevTool checks
573 results.extend(_SideEffectChecks(input_api, output_api))
Sigurd Schneider5c9b4f92021-01-22 11:09:55 +0100574 results.extend(_CheckBugAssociation(input_api, output_api, False))
Liviu Raud614e092020-01-08 10:56:33 +0100575 return results
576
577
Blink Reformat4c46d092018-04-07 15:32:37 +0000578def CheckChangeOnCommit(input_api, output_api):
Mandy Chenf0fbdbe2019-08-22 23:58:37 +0000579 results = []
Yang Guo4fd355c2019-09-19 10:59:03 +0200580 results.extend(_CommonChecks(input_api, output_api))
Christy Chen2d6d9a62020-09-22 09:04:09 -0700581 results.extend(_CollectStrings(input_api, output_api))
Kalon Hindsd44fddf2020-12-10 05:43:25 -0800582 # Run checks that rely on output from other DevTool checks
583 results.extend(_SideEffectChecks(input_api, output_api))
Mathias Bynens032591d2019-10-21 11:51:31 +0200584 results.extend(input_api.canned_checks.CheckChangeHasDescription(input_api, output_api))
Sigurd Schneider5c9b4f92021-01-22 11:09:55 +0100585 results.extend(_CheckBugAssociation(input_api, output_api, True))
Mandy Chenf0fbdbe2019-08-22 23:58:37 +0000586 return results
Blink Reformat4c46d092018-04-07 15:32:37 +0000587
588
Mandy Chena6be46a2019-07-09 17:06:27 +0000589def _getAffectedFiles(input_api, parent_directories, excluded_actions, accepted_endings): # pylint: disable=invalid-name
Yang Guo75beda92019-10-28 08:29:25 +0100590 """Return absolute file paths of affected files (not due to an excluded action)
Mandy Chena6be46a2019-07-09 17:06:27 +0000591 under a parent directory with an accepted file ending.
Yang Guo75beda92019-10-28 08:29:25 +0100592 """
Mandy Chena6be46a2019-07-09 17:06:27 +0000593 local_paths = [
594 f.AbsoluteLocalPath() for f in input_api.AffectedFiles() if all(f.Action() != action for action in excluded_actions)
595 ]
596 affected_files = [
Tim van der Lippefb1dc172021-05-11 16:40:26 +0100597 file_name for file_name in local_paths
598 if any(parent_directory in file_name
599 for parent_directory in parent_directories) and (
600 len(accepted_endings) == 0 or any(
601 file_name.endswith(accepted_ending)
602 for accepted_ending in accepted_endings))
Mandy Chena6be46a2019-07-09 17:06:27 +0000603 ]
604 return affected_files
605
606
Tim van der Lippec4617122020-03-06 16:24:19 +0000607def _checkWithNodeScript(input_api, output_api, script_path, script_arguments=[]): # pylint: disable=invalid-name
Blink Reformat4c46d092018-04-07 15:32:37 +0000608 original_sys_path = sys.path
609 try:
Yang Guo75beda92019-10-28 08:29:25 +0100610 sys.path = sys.path + [input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts')]
Yang Guod8176982019-10-04 20:30:35 +0000611 import devtools_paths
Blink Reformat4c46d092018-04-07 15:32:37 +0000612 finally:
613 sys.path = original_sys_path
614
Tim van der Lippec4617122020-03-06 16:24:19 +0000615 return _ExecuteSubProcess(input_api, output_api, [devtools_paths.node_path(), script_path], script_arguments, [])
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200616
617
Jack Franklin324f3042020-09-03 11:28:29 +0100618def _checkWithTypeScript(input_api,
619 output_api,
620 tsc_arguments,
621 script_path,
622 script_arguments=[]): # pylint: disable=invalid-name
623 original_sys_path = sys.path
624 try:
625 sys.path = sys.path + [
626 input_api.os_path.join(input_api.PresubmitLocalPath(), 'scripts')
627 ]
628 import devtools_paths
629 finally:
630 sys.path = original_sys_path
631
632 # First run tsc to compile the TS script that we then run in the _ExecuteSubProcess call
633 tsc_compiler_process = input_api.subprocess.Popen(
634 [
635 devtools_paths.node_path(),
636 devtools_paths.typescript_compiler_path()
637 ] + tsc_arguments,
638 stdout=input_api.subprocess.PIPE,
639 stderr=input_api.subprocess.STDOUT)
640
641 out, _ = tsc_compiler_process.communicate()
642 if tsc_compiler_process.returncode != 0:
643 return [
644 output_api.PresubmitError('Error compiling briges regenerator:\n' +
Tim van der Lippefb1dc172021-05-11 16:40:26 +0100645 out.decode('utf-8'))
Jack Franklin324f3042020-09-03 11:28:29 +0100646 ]
647
648 return _checkWithNodeScript(input_api, output_api, script_path,
649 script_arguments)
650
651
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200652def _getFilesToLint(input_api, output_api, lint_config_files,
653 default_linted_directories, accepted_endings, results):
Mathias Bynens0ec56612020-06-19 09:14:03 +0200654 run_full_check = False
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200655 files_to_lint = []
656
657 # We are changing the lint configuration; run the full check.
Tim van der Lippefb1dc172021-05-11 16:40:26 +0100658 if len(lint_config_files) != 0:
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200659 results.append(
660 output_api.PresubmitNotifyResult('Running full lint check'))
Mathias Bynens0ec56612020-06-19 09:14:03 +0200661 run_full_check = True
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200662 else:
663 # Only run the linter on files that are relevant, to save PRESUBMIT time.
664 files_to_lint = _getAffectedFiles(input_api,
665 default_linted_directories, ['D'],
666 accepted_endings)
667
Paul Lewis2b9224f2020-09-08 18:13:10 +0100668 # Exclude front_end/third_party files.
Tim van der Lippefb1dc172021-05-11 16:40:26 +0100669 files_to_lint = [
670 file for file in files_to_lint if "third_party" not in file
671 ]
Paul Lewis2b9224f2020-09-08 18:13:10 +0100672
Tim van der Lippefb1dc172021-05-11 16:40:26 +0100673 if len(files_to_lint) == 0:
Mathias Bynens1b2c5e42020-06-18 08:29:21 +0200674 results.append(
675 output_api.PresubmitNotifyResult(
676 'No affected files for lint check'))
677
Tim van der Lippefb1dc172021-05-11 16:40:26 +0100678 should_bail_out = len(files_to_lint) == 0 and not run_full_check
Mathias Bynens0ec56612020-06-19 09:14:03 +0200679 return should_bail_out, files_to_lint