1 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 # Use of this source code is governed by a BSD-style license that can be
3 # found in the LICENSE file.
5 """Top-level presubmit script for Chromium.
7 See http://dev.chromium.org/developers/how-tos/depottools/presubmit-scripts
8 for more details about the presubmit API built into depot_tools.
14 r
"^native_client_sdk[\\\/]src[\\\/]build_tools[\\\/]make_rules.py",
15 r
"^native_client_sdk[\\\/]src[\\\/]build_tools[\\\/]make_simple.py",
16 r
"^native_client_sdk[\\\/]src[\\\/]tools[\\\/].*.mk",
17 r
"^net[\\\/]tools[\\\/]spdyshark[\\\/].*",
22 r
".+[\\\/]pnacl_shim\.c$",
23 r
"^gpu[\\\/]config[\\\/].*_list_json\.cc$",
24 r
"^chrome[\\\/]browser[\\\/]resources[\\\/]pdf[\\\/]index.js"
27 # The NetscapePlugIn library is excluded from pan-project as it will soon
28 # be deleted together with the rest of the NPAPI and it's not worthwhile to
29 # update the coding style until then.
31 r
"^content[\\\/]shell[\\\/]tools[\\\/]plugin[\\\/].*",
34 # Fragment of a regular expression that matches C++ and Objective-C++
35 # implementation files.
36 _IMPLEMENTATION_EXTENSIONS
= r
'\.(cc|cpp|cxx|mm)$'
38 # Regular expression that matches code only used for test binaries
40 _TEST_CODE_EXCLUDED_PATHS
= (
41 r
'.*[\\\/](fake_|test_|mock_).+%s' % _IMPLEMENTATION_EXTENSIONS
,
42 r
'.+_test_(base|support|util)%s' % _IMPLEMENTATION_EXTENSIONS
,
43 r
'.+_(api|browser|kif|perf|pixel|unit|ui)?test(_[a-z]+)?%s' %
44 _IMPLEMENTATION_EXTENSIONS
,
45 r
'.+profile_sync_service_harness%s' % _IMPLEMENTATION_EXTENSIONS
,
46 r
'.*[\\\/](test|tool(s)?)[\\\/].*',
47 # content_shell is used for running layout tests.
48 r
'content[\\\/]shell[\\\/].*',
49 # At request of folks maintaining this folder.
50 r
'chrome[\\\/]browser[\\\/]automation[\\\/].*',
51 # Non-production example code.
52 r
'mojo[\\\/]examples[\\\/].*',
53 # Launcher for running iOS tests on the simulator.
54 r
'testing[\\\/]iossim[\\\/]iossim\.mm$',
57 _TEST_ONLY_WARNING
= (
58 'You might be calling functions intended only for testing from\n'
59 'production code. It is OK to ignore this warning if you know what\n'
60 'you are doing, as the heuristics used to detect the situation are\n'
61 'not perfect. The commit queue will not block on this warning.')
64 _INCLUDE_ORDER_WARNING
= (
65 'Your #include order seems to be broken. Remember to use the right '
66 'collation (LC_COLLATE=C) and check\nhttps://google-styleguide.googlecode'
67 '.com/svn/trunk/cppguide.html#Names_and_Order_of_Includes')
69 _BANNED_OBJC_FUNCTIONS
= (
73 'The use of -[NSView addTrackingRect:owner:userData:assumeInside:] is'
74 'prohibited. Please use CrTrackingArea instead.',
75 'http://dev.chromium.org/developers/coding-style/cocoa-dos-and-donts',
82 'The use of NSTrackingAreas is prohibited. Please use CrTrackingArea',
84 'http://dev.chromium.org/developers/coding-style/cocoa-dos-and-donts',
89 'convertPointFromBase:',
91 'The use of -[NSView convertPointFromBase:] is almost certainly wrong.',
92 'Please use |convertPoint:(point) fromView:nil| instead.',
93 'http://dev.chromium.org/developers/coding-style/cocoa-dos-and-donts',
98 'convertPointToBase:',
100 'The use of -[NSView convertPointToBase:] is almost certainly wrong.',
101 'Please use |convertPoint:(point) toView:nil| instead.',
102 'http://dev.chromium.org/developers/coding-style/cocoa-dos-and-donts',
107 'convertRectFromBase:',
109 'The use of -[NSView convertRectFromBase:] is almost certainly wrong.',
110 'Please use |convertRect:(point) fromView:nil| instead.',
111 'http://dev.chromium.org/developers/coding-style/cocoa-dos-and-donts',
116 'convertRectToBase:',
118 'The use of -[NSView convertRectToBase:] is almost certainly wrong.',
119 'Please use |convertRect:(point) toView:nil| instead.',
120 'http://dev.chromium.org/developers/coding-style/cocoa-dos-and-donts',
125 'convertSizeFromBase:',
127 'The use of -[NSView convertSizeFromBase:] is almost certainly wrong.',
128 'Please use |convertSize:(point) fromView:nil| instead.',
129 'http://dev.chromium.org/developers/coding-style/cocoa-dos-and-donts',
134 'convertSizeToBase:',
136 'The use of -[NSView convertSizeToBase:] is almost certainly wrong.',
137 'Please use |convertSize:(point) toView:nil| instead.',
138 'http://dev.chromium.org/developers/coding-style/cocoa-dos-and-donts',
145 _BANNED_CPP_FUNCTIONS
= (
146 # Make sure that gtest's FRIEND_TEST() macro is not used; the
147 # FRIEND_TEST_ALL_PREFIXES() macro from base/gtest_prod_util.h should be
148 # used instead since that allows for FLAKY_ and DISABLED_ prefixes.
152 'Chromium code should not use gtest\'s FRIEND_TEST() macro. Include',
153 'base/gtest_prod_util.h and use FRIEND_TEST_ALL_PREFIXES() instead.',
161 'New code should not use ScopedAllowIO. Post a task to the blocking',
162 'pool or the FILE thread instead.',
166 r
"^base[\\\/]process[\\\/]process_metrics_linux\.cc$",
167 r
"^chrome[\\\/]browser[\\\/]chromeos[\\\/]boot_times_recorder\.cc$",
168 r
"^chrome[\\\/]browser[\\\/]chromeos[\\\/]"
169 "customization_document_browsertest\.cc$",
170 r
"^components[\\\/]crash[\\\/]app[\\\/]breakpad_mac\.mm$",
171 r
"^content[\\\/]shell[\\\/]browser[\\\/]shell_browser_main\.cc$",
172 r
"^content[\\\/]shell[\\\/]browser[\\\/]shell_message_filter\.cc$",
173 r
"^mojo[\\\/]edk[\\\/]embedder[\\\/]" +
174 r
"simple_platform_shared_buffer_posix\.cc$",
175 r
"^net[\\\/]disk_cache[\\\/]cache_util\.cc$",
176 r
"^net[\\\/]url_request[\\\/]test_url_fetcher_factory\.cc$",
177 r
"^ui[\\\/]ozone[\\\/]platform[\\\/]drm[\\\/]host[\\\/]"
178 "drm_display_host_manager\.cc$",
184 'The use of SkRefPtr is prohibited. ',
185 'Please use skia::RefPtr instead.'
193 'The indirect use of SkRefPtr via SkAutoRef is prohibited. ',
194 'Please use skia::RefPtr instead.'
202 'The use of SkAutoTUnref is dangerous because it implicitly ',
203 'converts to a raw pointer. Please use skia::RefPtr instead.'
211 'The indirect use of SkAutoTUnref through SkAutoUnref is dangerous ',
212 'because it implicitly converts to a raw pointer. ',
213 'Please use skia::RefPtr instead.'
219 r
'/HANDLE_EINTR\(.*close',
221 'HANDLE_EINTR(close) is invalid. If close fails with EINTR, the file',
222 'descriptor will be closed, and it is incorrect to retry the close.',
223 'Either call close directly and ignore its return value, or wrap close',
224 'in IGNORE_EINTR to use its return value. See http://crbug.com/269623'
230 r
'/IGNORE_EINTR\((?!.*close)',
232 'IGNORE_EINTR is only valid when wrapping close. To wrap other system',
233 'calls, use HANDLE_EINTR. See http://crbug.com/269623',
237 # Files that #define IGNORE_EINTR.
238 r
'^base[\\\/]posix[\\\/]eintr_wrapper\.h$',
239 r
'^ppapi[\\\/]tests[\\\/]test_broker\.cc$',
245 'Do not introduce new v8::Extensions into the code base, use',
246 'gin::Wrappable instead. See http://crbug.com/334679',
250 r
'extensions[\\\/]renderer[\\\/]safe_builtins\.*',
254 '\<MessageLoopProxy\>',
256 'MessageLoopProxy is deprecated. ',
257 'Please use SingleThreadTaskRunner or ThreadTaskRunnerHandle instead.'
261 # Internal message_loop related code may still use it.
262 r
'^base[\\\/]message_loop[\\\/].*',
267 _IPC_ENUM_TRAITS_DEPRECATED
= (
268 'You are using IPC_ENUM_TRAITS() in your code. It has been deprecated.\n'
269 'See http://www.chromium.org/Home/chromium-security/education/security-tips-for-ipc')
273 # Please keep sorted.
277 'OS_CAT', # For testing.
294 def _CheckNoProductionCodeUsingTestOnlyFunctions(input_api
, output_api
):
295 """Attempts to prevent use of functions intended only for testing in
296 non-testing code. For now this is just a best-effort implementation
297 that ignores header files and may have some false positives. A
298 better implementation would probably need a proper C++ parser.
300 # We only scan .cc files and the like, as the declaration of
301 # for-testing functions in header files are hard to distinguish from
302 # calls to such functions without a proper C++ parser.
303 file_inclusion_pattern
= r
'.+%s' % _IMPLEMENTATION_EXTENSIONS
305 base_function_pattern
= r
'[ :]test::[^\s]+|ForTest(ing)?|for_test(ing)?'
306 inclusion_pattern
= input_api
.re
.compile(r
'(%s)\s*\(' % base_function_pattern
)
307 comment_pattern
= input_api
.re
.compile(r
'//.*(%s)' % base_function_pattern
)
308 exclusion_pattern
= input_api
.re
.compile(
309 r
'::[A-Za-z0-9_]+(%s)|(%s)[^;]+\{' % (
310 base_function_pattern
, base_function_pattern
))
312 def FilterFile(affected_file
):
313 black_list
= (_EXCLUDED_PATHS
+
314 _TEST_CODE_EXCLUDED_PATHS
+
315 input_api
.DEFAULT_BLACK_LIST
)
316 return input_api
.FilterSourceFile(
318 white_list
=(file_inclusion_pattern
, ),
319 black_list
=black_list
)
322 for f
in input_api
.AffectedSourceFiles(FilterFile
):
323 local_path
= f
.LocalPath()
324 for line_number
, line
in f
.ChangedContents():
325 if (inclusion_pattern
.search(line
) and
326 not comment_pattern
.search(line
) and
327 not exclusion_pattern
.search(line
)):
329 '%s:%d\n %s' % (local_path
, line_number
, line
.strip()))
332 return [output_api
.PresubmitPromptOrNotify(_TEST_ONLY_WARNING
, problems
)]
337 def _CheckNoIOStreamInHeaders(input_api
, output_api
):
338 """Checks to make sure no .h files include <iostream>."""
340 pattern
= input_api
.re
.compile(r
'^#include\s*<iostream>',
341 input_api
.re
.MULTILINE
)
342 for f
in input_api
.AffectedSourceFiles(input_api
.FilterSourceFile
):
343 if not f
.LocalPath().endswith('.h'):
345 contents
= input_api
.ReadFile(f
)
346 if pattern
.search(contents
):
350 return [ output_api
.PresubmitError(
351 'Do not #include <iostream> in header files, since it inserts static '
352 'initialization into every file including the header. Instead, '
353 '#include <ostream>. See http://crbug.com/94794',
358 def _CheckNoUNIT_TESTInSourceFiles(input_api
, output_api
):
359 """Checks to make sure no source files use UNIT_TEST"""
361 for f
in input_api
.AffectedFiles():
362 if (not f
.LocalPath().endswith(('.cc', '.mm'))):
365 for line_num
, line
in f
.ChangedContents():
366 if 'UNIT_TEST ' in line
or line
.endswith('UNIT_TEST'):
367 problems
.append(' %s:%d' % (f
.LocalPath(), line_num
))
371 return [output_api
.PresubmitPromptWarning('UNIT_TEST is only for headers.\n' +
372 '\n'.join(problems
))]
375 def _FindHistogramNameInLine(histogram_name
, line
):
376 """Tries to find a histogram name or prefix in a line."""
377 if not "affected-histogram" in line
:
378 return histogram_name
in line
379 # A histogram_suffixes tag type has an affected-histogram name as a prefix of
380 # the histogram_name.
383 histogram_prefix
= line
.split('\"')[1]
384 return histogram_prefix
in histogram_name
387 def _CheckUmaHistogramChanges(input_api
, output_api
):
388 """Check that UMA histogram names in touched lines can still be found in other
389 lines of the patch or in histograms.xml. Note that this check would not catch
390 the reverse: changes in histograms.xml not matched in the code itself."""
391 touched_histograms
= []
392 histograms_xml_modifications
= []
393 pattern
= input_api
.re
.compile('UMA_HISTOGRAM.*\("(.*)"')
394 for f
in input_api
.AffectedFiles():
395 # If histograms.xml itself is modified, keep the modified lines for later.
396 if f
.LocalPath().endswith(('histograms.xml')):
397 histograms_xml_modifications
= f
.ChangedContents()
399 if not f
.LocalPath().endswith(('cc', 'mm', 'cpp')):
401 for line_num
, line
in f
.ChangedContents():
402 found
= pattern
.search(line
)
404 touched_histograms
.append([found
.group(1), f
, line_num
])
406 # Search for the touched histogram names in the local modifications to
407 # histograms.xml, and, if not found, on the base histograms.xml file.
408 unmatched_histograms
= []
409 for histogram_info
in touched_histograms
:
410 histogram_name_found
= False
411 for line_num
, line
in histograms_xml_modifications
:
412 histogram_name_found
= _FindHistogramNameInLine(histogram_info
[0], line
)
413 if histogram_name_found
:
415 if not histogram_name_found
:
416 unmatched_histograms
.append(histogram_info
)
418 histograms_xml_path
= 'tools/metrics/histograms/histograms.xml'
420 if unmatched_histograms
:
421 with
open(histograms_xml_path
) as histograms_xml
:
422 for histogram_name
, f
, line_num
in unmatched_histograms
:
423 histograms_xml
.seek(0)
424 histogram_name_found
= False
425 for line
in histograms_xml
:
426 histogram_name_found
= _FindHistogramNameInLine(histogram_name
, line
)
427 if histogram_name_found
:
429 if not histogram_name_found
:
430 problems
.append(' [%s:%d] %s' %
431 (f
.LocalPath(), line_num
, histogram_name
))
435 return [output_api
.PresubmitPromptWarning('Some UMA_HISTOGRAM lines have '
436 'been modified and the associated histogram name has no match in either '
437 '%s or the modifications of it:' % (histograms_xml_path
), problems
)]
440 def _CheckNoNewWStrings(input_api
, output_api
):
441 """Checks to make sure we don't introduce use of wstrings."""
443 for f
in input_api
.AffectedFiles():
444 if (not f
.LocalPath().endswith(('.cc', '.h')) or
445 f
.LocalPath().endswith(('test.cc', '_win.cc', '_win.h')) or
446 '/win/' in f
.LocalPath()):
450 for line_num
, line
in f
.ChangedContents():
451 if 'presubmit: allow wstring' in line
:
453 elif not allowWString
and 'wstring' in line
:
454 problems
.append(' %s:%d' % (f
.LocalPath(), line_num
))
461 return [output_api
.PresubmitPromptWarning('New code should not use wstrings.'
462 ' If you are calling a cross-platform API that accepts a wstring, '
464 '\n'.join(problems
))]
467 def _CheckNoDEPSGIT(input_api
, output_api
):
468 """Make sure .DEPS.git is never modified manually."""
469 if any(f
.LocalPath().endswith('.DEPS.git') for f
in
470 input_api
.AffectedFiles()):
471 return [output_api
.PresubmitError(
472 'Never commit changes to .DEPS.git. This file is maintained by an\n'
473 'automated system based on what\'s in DEPS and your changes will be\n'
475 'See https://sites.google.com/a/chromium.org/dev/developers/how-tos/get-the-code#Rolling_DEPS\n'
476 'for more information')]
480 def _CheckValidHostsInDEPS(input_api
, output_api
):
481 """Checks that DEPS file deps are from allowed_hosts."""
482 # Run only if DEPS file has been modified to annoy fewer bystanders.
483 if all(f
.LocalPath() != 'DEPS' for f
in input_api
.AffectedFiles()):
485 # Outsource work to gclient verify
487 input_api
.subprocess
.check_output(['gclient', 'verify'])
489 except input_api
.subprocess
.CalledProcessError
, error
:
490 return [output_api
.PresubmitError(
491 'DEPS file must have only git dependencies.',
492 long_text
=error
.output
)]
495 def _CheckNoBannedFunctions(input_api
, output_api
):
496 """Make sure that banned functions are not used."""
500 file_filter
= lambda f
: f
.LocalPath().endswith(('.mm', '.m', '.h'))
501 for f
in input_api
.AffectedFiles(file_filter
=file_filter
):
502 for line_num
, line
in f
.ChangedContents():
503 for func_name
, message
, error
in _BANNED_OBJC_FUNCTIONS
:
505 if func_name
[0:1] == '/':
506 regex
= func_name
[1:]
507 if input_api
.re
.search(regex
, line
):
509 elif func_name
in line
:
515 problems
.append(' %s:%d:' % (f
.LocalPath(), line_num
))
516 for message_line
in message
:
517 problems
.append(' %s' % message_line
)
519 file_filter
= lambda f
: f
.LocalPath().endswith(('.cc', '.mm', '.h'))
520 for f
in input_api
.AffectedFiles(file_filter
=file_filter
):
521 for line_num
, line
in f
.ChangedContents():
522 for func_name
, message
, error
, excluded_paths
in _BANNED_CPP_FUNCTIONS
:
523 def IsBlacklisted(affected_file
, blacklist
):
524 local_path
= affected_file
.LocalPath()
525 for item
in blacklist
:
526 if input_api
.re
.match(item
, local_path
):
529 if IsBlacklisted(f
, excluded_paths
):
532 if func_name
[0:1] == '/':
533 regex
= func_name
[1:]
534 if input_api
.re
.search(regex
, line
):
536 elif func_name
in line
:
542 problems
.append(' %s:%d:' % (f
.LocalPath(), line_num
))
543 for message_line
in message
:
544 problems
.append(' %s' % message_line
)
548 result
.append(output_api
.PresubmitPromptWarning(
549 'Banned functions were used.\n' + '\n'.join(warnings
)))
551 result
.append(output_api
.PresubmitError(
552 'Banned functions were used.\n' + '\n'.join(errors
)))
556 def _CheckNoPragmaOnce(input_api
, output_api
):
557 """Make sure that banned functions are not used."""
559 pattern
= input_api
.re
.compile(r
'^#pragma\s+once',
560 input_api
.re
.MULTILINE
)
561 for f
in input_api
.AffectedSourceFiles(input_api
.FilterSourceFile
):
562 if not f
.LocalPath().endswith('.h'):
564 contents
= input_api
.ReadFile(f
)
565 if pattern
.search(contents
):
569 return [output_api
.PresubmitError(
570 'Do not use #pragma once in header files.\n'
571 'See http://www.chromium.org/developers/coding-style#TOC-File-headers',
576 def _CheckNoTrinaryTrueFalse(input_api
, output_api
):
577 """Checks to make sure we don't introduce use of foo ? true : false."""
579 pattern
= input_api
.re
.compile(r
'\?\s*(true|false)\s*:\s*(true|false)')
580 for f
in input_api
.AffectedFiles():
581 if not f
.LocalPath().endswith(('.cc', '.h', '.inl', '.m', '.mm')):
584 for line_num
, line
in f
.ChangedContents():
585 if pattern
.match(line
):
586 problems
.append(' %s:%d' % (f
.LocalPath(), line_num
))
590 return [output_api
.PresubmitPromptWarning(
591 'Please consider avoiding the "? true : false" pattern if possible.\n' +
592 '\n'.join(problems
))]
595 def _CheckUnwantedDependencies(input_api
, output_api
):
596 """Runs checkdeps on #include statements added in this
597 change. Breaking - rules is an error, breaking ! rules is a
601 # We need to wait until we have an input_api object and use this
602 # roundabout construct to import checkdeps because this file is
603 # eval-ed and thus doesn't have __file__.
604 original_sys_path
= sys
.path
606 sys
.path
= sys
.path
+ [input_api
.os_path
.join(
607 input_api
.PresubmitLocalPath(), 'buildtools', 'checkdeps')]
609 from cpp_checker
import CppChecker
610 from rules
import Rule
612 # Restore sys.path to what it was before.
613 sys
.path
= original_sys_path
616 for f
in input_api
.AffectedFiles():
617 if not CppChecker
.IsCppFile(f
.LocalPath()):
620 changed_lines
= [line
for line_num
, line
in f
.ChangedContents()]
621 added_includes
.append([f
.LocalPath(), changed_lines
])
623 deps_checker
= checkdeps
.DepsChecker(input_api
.PresubmitLocalPath())
625 error_descriptions
= []
626 warning_descriptions
= []
627 for path
, rule_type
, rule_description
in deps_checker
.CheckAddedCppIncludes(
629 description_with_path
= '%s\n %s' % (path
, rule_description
)
630 if rule_type
== Rule
.DISALLOW
:
631 error_descriptions
.append(description_with_path
)
633 warning_descriptions
.append(description_with_path
)
636 if error_descriptions
:
637 results
.append(output_api
.PresubmitError(
638 'You added one or more #includes that violate checkdeps rules.',
640 if warning_descriptions
:
641 results
.append(output_api
.PresubmitPromptOrNotify(
642 'You added one or more #includes of files that are temporarily\n'
643 'allowed but being removed. Can you avoid introducing the\n'
644 '#include? See relevant DEPS file(s) for details and contacts.',
645 warning_descriptions
))
649 def _CheckFilePermissions(input_api
, output_api
):
650 """Check that all files have their permissions properly set."""
651 if input_api
.platform
== 'win32':
653 args
= [input_api
.python_executable
, 'tools/checkperms/checkperms.py',
654 '--root', input_api
.change
.RepositoryRoot()]
655 for f
in input_api
.AffectedFiles():
656 args
+= ['--file', f
.LocalPath()]
657 checkperms
= input_api
.subprocess
.Popen(args
,
658 stdout
=input_api
.subprocess
.PIPE
)
659 errors
= checkperms
.communicate()[0].strip()
661 return [output_api
.PresubmitError('checkperms.py failed.',
662 errors
.splitlines())]
666 def _CheckNoAuraWindowPropertyHInHeaders(input_api
, output_api
):
667 """Makes sure we don't include ui/aura/window_property.h
670 pattern
= input_api
.re
.compile(r
'^#include\s*"ui/aura/window_property.h"')
672 for f
in input_api
.AffectedFiles():
673 if not f
.LocalPath().endswith('.h'):
675 for line_num
, line
in f
.ChangedContents():
676 if pattern
.match(line
):
677 errors
.append(' %s:%d' % (f
.LocalPath(), line_num
))
681 results
.append(output_api
.PresubmitError(
682 'Header files should not include ui/aura/window_property.h', errors
))
686 def _CheckIncludeOrderForScope(scope
, input_api
, file_path
, changed_linenums
):
687 """Checks that the lines in scope occur in the right order.
689 1. C system files in alphabetical order
690 2. C++ system files in alphabetical order
691 3. Project's .h files
694 c_system_include_pattern
= input_api
.re
.compile(r
'\s*#include <.*\.h>')
695 cpp_system_include_pattern
= input_api
.re
.compile(r
'\s*#include <.*>')
696 custom_include_pattern
= input_api
.re
.compile(r
'\s*#include ".*')
698 C_SYSTEM_INCLUDES
, CPP_SYSTEM_INCLUDES
, CUSTOM_INCLUDES
= range(3)
700 state
= C_SYSTEM_INCLUDES
703 previous_line_num
= 0
704 problem_linenums
= []
705 out_of_order
= " - line belongs before previous line"
706 for line_num
, line
in scope
:
707 if c_system_include_pattern
.match(line
):
708 if state
!= C_SYSTEM_INCLUDES
:
709 problem_linenums
.append((line_num
, previous_line_num
,
710 " - C system include file in wrong block"))
711 elif previous_line
and previous_line
> line
:
712 problem_linenums
.append((line_num
, previous_line_num
,
714 elif cpp_system_include_pattern
.match(line
):
715 if state
== C_SYSTEM_INCLUDES
:
716 state
= CPP_SYSTEM_INCLUDES
717 elif state
== CUSTOM_INCLUDES
:
718 problem_linenums
.append((line_num
, previous_line_num
,
719 " - c++ system include file in wrong block"))
720 elif previous_line
and previous_line
> line
:
721 problem_linenums
.append((line_num
, previous_line_num
, out_of_order
))
722 elif custom_include_pattern
.match(line
):
723 if state
!= CUSTOM_INCLUDES
:
724 state
= CUSTOM_INCLUDES
725 elif previous_line
and previous_line
> line
:
726 problem_linenums
.append((line_num
, previous_line_num
, out_of_order
))
728 problem_linenums
.append((line_num
, previous_line_num
,
729 "Unknown include type"))
731 previous_line_num
= line_num
734 for (line_num
, previous_line_num
, failure_type
) in problem_linenums
:
735 if line_num
in changed_linenums
or previous_line_num
in changed_linenums
:
736 warnings
.append(' %s:%d:%s' % (file_path
, line_num
, failure_type
))
740 def _CheckIncludeOrderInFile(input_api
, f
, changed_linenums
):
741 """Checks the #include order for the given file f."""
743 system_include_pattern
= input_api
.re
.compile(r
'\s*#include \<.*')
744 # Exclude the following includes from the check:
745 # 1) #include <.../...>, e.g., <sys/...> includes often need to appear in a
747 # 2) <atlbase.h>, "build/build_config.h"
748 excluded_include_pattern
= input_api
.re
.compile(
749 r
'\s*#include (\<.*/.*|\<atlbase\.h\>|"build/build_config.h")')
750 custom_include_pattern
= input_api
.re
.compile(r
'\s*#include "(?P<FILE>.*)"')
751 # Match the final or penultimate token if it is xxxtest so we can ignore it
752 # when considering the special first include.
753 test_file_tag_pattern
= input_api
.re
.compile(
754 r
'_[a-z]+test(?=(_[a-zA-Z0-9]+)?\.)')
755 if_pattern
= input_api
.re
.compile(
756 r
'\s*#\s*(if|elif|else|endif|define|undef).*')
757 # Some files need specialized order of includes; exclude such files from this
759 uncheckable_includes_pattern
= input_api
.re
.compile(
761 '("ipc/.*macros\.h"|<windows\.h>|".*gl.*autogen.h")\s*')
763 contents
= f
.NewContents()
767 # Handle the special first include. If the first include file is
768 # some/path/file.h, the corresponding including file can be some/path/file.cc,
769 # some/other/path/file.cc, some/path/file_platform.cc, some/path/file-suffix.h
770 # etc. It's also possible that no special first include exists.
771 # If the included file is some/path/file_platform.h the including file could
772 # also be some/path/file_xxxtest_platform.h.
773 including_file_base_name
= test_file_tag_pattern
.sub(
774 '', input_api
.os_path
.basename(f
.LocalPath()))
776 for line
in contents
:
778 if system_include_pattern
.match(line
):
779 # No special first include -> process the line again along with normal
783 match
= custom_include_pattern
.match(line
)
785 match_dict
= match
.groupdict()
786 header_basename
= test_file_tag_pattern
.sub(
787 '', input_api
.os_path
.basename(match_dict
['FILE'])).replace('.h', '')
789 if header_basename
not in including_file_base_name
:
790 # No special first include -> process the line again along with normal
795 # Split into scopes: Each region between #if and #endif is its own scope.
798 for line
in contents
[line_num
:]:
800 if uncheckable_includes_pattern
.match(line
):
802 if if_pattern
.match(line
):
803 scopes
.append(current_scope
)
805 elif ((system_include_pattern
.match(line
) or
806 custom_include_pattern
.match(line
)) and
807 not excluded_include_pattern
.match(line
)):
808 current_scope
.append((line_num
, line
))
809 scopes
.append(current_scope
)
812 warnings
.extend(_CheckIncludeOrderForScope(scope
, input_api
, f
.LocalPath(),
817 def _CheckIncludeOrder(input_api
, output_api
):
818 """Checks that the #include order is correct.
820 1. The corresponding header for source files.
821 2. C system files in alphabetical order
822 3. C++ system files in alphabetical order
823 4. Project's .h files in alphabetical order
825 Each region separated by #if, #elif, #else, #endif, #define and #undef follows
826 these rules separately.
828 def FileFilterIncludeOrder(affected_file
):
829 black_list
= (_EXCLUDED_PATHS
+ input_api
.DEFAULT_BLACK_LIST
)
830 return input_api
.FilterSourceFile(affected_file
, black_list
=black_list
)
833 for f
in input_api
.AffectedFiles(file_filter
=FileFilterIncludeOrder
):
834 if f
.LocalPath().endswith(('.cc', '.h', '.mm')):
835 changed_linenums
= set(line_num
for line_num
, _
in f
.ChangedContents())
836 warnings
.extend(_CheckIncludeOrderInFile(input_api
, f
, changed_linenums
))
840 results
.append(output_api
.PresubmitPromptOrNotify(_INCLUDE_ORDER_WARNING
,
845 def _CheckForVersionControlConflictsInFile(input_api
, f
):
846 pattern
= input_api
.re
.compile('^(?:<<<<<<<|>>>>>>>) |^=======$')
848 for line_num
, line
in f
.ChangedContents():
849 if f
.LocalPath().endswith('.md'):
850 # First-level headers in markdown look a lot like version control
851 # conflict markers. http://daringfireball.net/projects/markdown/basics
853 if pattern
.match(line
):
854 errors
.append(' %s:%d %s' % (f
.LocalPath(), line_num
, line
))
858 def _CheckForVersionControlConflicts(input_api
, output_api
):
859 """Usually this is not intentional and will cause a compile failure."""
861 for f
in input_api
.AffectedFiles():
862 errors
.extend(_CheckForVersionControlConflictsInFile(input_api
, f
))
866 results
.append(output_api
.PresubmitError(
867 'Version control conflict markers found, please resolve.', errors
))
871 def _CheckHardcodedGoogleHostsInLowerLayers(input_api
, output_api
):
872 def FilterFile(affected_file
):
873 """Filter function for use with input_api.AffectedSourceFiles,
874 below. This filters out everything except non-test files from
875 top-level directories that generally speaking should not hard-code
876 service URLs (e.g. src/android_webview/, src/content/ and others).
878 return input_api
.FilterSourceFile(
880 white_list
=(r
'^(android_webview|base|content|net)[\\\/].*', ),
881 black_list
=(_EXCLUDED_PATHS
+
882 _TEST_CODE_EXCLUDED_PATHS
+
883 input_api
.DEFAULT_BLACK_LIST
))
885 base_pattern
= '"[^"]*google\.com[^"]*"'
886 comment_pattern
= input_api
.re
.compile('//.*%s' % base_pattern
)
887 pattern
= input_api
.re
.compile(base_pattern
)
888 problems
= [] # items are (filename, line_number, line)
889 for f
in input_api
.AffectedSourceFiles(FilterFile
):
890 for line_num
, line
in f
.ChangedContents():
891 if not comment_pattern
.search(line
) and pattern
.search(line
):
892 problems
.append((f
.LocalPath(), line_num
, line
))
895 return [output_api
.PresubmitPromptOrNotify(
896 'Most layers below src/chrome/ should not hardcode service URLs.\n'
897 'Are you sure this is correct?',
899 problem
[0], problem
[1], problem
[2]) for problem
in problems
])]
904 def _CheckNoAbbreviationInPngFileName(input_api
, output_api
):
905 """Makes sure there are no abbreviations in the name of PNG files.
906 The native_client_sdk directory is excluded because it has auto-generated PNG
907 files for documentation.
910 white_list
= (r
'.*_[a-z]_.*\.png$|.*_[a-z]\.png$',)
911 black_list
= (r
'^native_client_sdk[\\\/]',)
912 file_filter
= lambda f
: input_api
.FilterSourceFile(
913 f
, white_list
=white_list
, black_list
=black_list
)
914 for f
in input_api
.AffectedFiles(include_deletes
=False,
915 file_filter
=file_filter
):
916 errors
.append(' %s' % f
.LocalPath())
920 results
.append(output_api
.PresubmitError(
921 'The name of PNG files should not have abbreviations. \n'
922 'Use _hover.png, _center.png, instead of _h.png, _c.png.\n'
923 'Contact oshima@chromium.org if you have questions.', errors
))
927 def _FilesToCheckForIncomingDeps(re
, changed_lines
):
928 """Helper method for _CheckAddedDepsHaveTargetApprovals. Returns
929 a set of DEPS entries that we should look up.
931 For a directory (rather than a specific filename) we fake a path to
932 a specific filename by adding /DEPS. This is chosen as a file that
933 will seldom or never be subject to per-file include_rules.
935 # We ignore deps entries on auto-generated directories.
936 AUTO_GENERATED_DIRS
= ['grit', 'jni']
938 # This pattern grabs the path without basename in the first
939 # parentheses, and the basename (if present) in the second. It
940 # relies on the simple heuristic that if there is a basename it will
941 # be a header file ending in ".h".
942 pattern
= re
.compile(
943 r
"""['"]\+([^'"]+?)(/[a-zA-Z0-9_]+\.h)?['"].*""")
945 for changed_line
in changed_lines
:
946 m
= pattern
.match(changed_line
)
949 if path
.split('/')[0] not in AUTO_GENERATED_DIRS
:
951 results
.add('%s%s' % (path
, m
.group(2)))
953 results
.add('%s/DEPS' % path
)
957 def _CheckAddedDepsHaveTargetApprovals(input_api
, output_api
):
958 """When a dependency prefixed with + is added to a DEPS file, we
959 want to make sure that the change is reviewed by an OWNER of the
960 target file or directory, to avoid layering violations from being
961 introduced. This check verifies that this happens.
963 changed_lines
= set()
964 for f
in input_api
.AffectedFiles():
965 filename
= input_api
.os_path
.basename(f
.LocalPath())
966 if filename
== 'DEPS':
967 changed_lines |
= set(line
.strip()
969 in f
.ChangedContents())
970 if not changed_lines
:
973 virtual_depended_on_files
= _FilesToCheckForIncomingDeps(input_api
.re
,
975 if not virtual_depended_on_files
:
978 if input_api
.is_committing
:
980 return [output_api
.PresubmitNotifyResult(
981 '--tbr was specified, skipping OWNERS check for DEPS additions')]
982 if not input_api
.change
.issue
:
983 return [output_api
.PresubmitError(
984 "DEPS approval by OWNERS check failed: this change has "
985 "no Rietveld issue number, so we can't check it for approvals.")]
986 output
= output_api
.PresubmitError
988 output
= output_api
.PresubmitNotifyResult
990 owners_db
= input_api
.owners_db
991 owner_email
, reviewers
= input_api
.canned_checks
._RietveldOwnerAndReviewers
(
993 owners_db
.email_regexp
,
994 approval_needed
=input_api
.is_committing
)
996 owner_email
= owner_email
or input_api
.change
.author_email
998 reviewers_plus_owner
= set(reviewers
)
1000 reviewers_plus_owner
.add(owner_email
)
1001 missing_files
= owners_db
.files_not_covered_by(virtual_depended_on_files
,
1002 reviewers_plus_owner
)
1004 # We strip the /DEPS part that was added by
1005 # _FilesToCheckForIncomingDeps to fake a path to a file in a
1007 def StripDeps(path
):
1008 start_deps
= path
.rfind('/DEPS')
1009 if start_deps
!= -1:
1010 return path
[:start_deps
]
1013 unapproved_dependencies
= ["'+%s'," % StripDeps(path
)
1014 for path
in missing_files
]
1016 if unapproved_dependencies
:
1018 output('Missing LGTM from OWNERS of dependencies added to DEPS:\n %s' %
1019 '\n '.join(sorted(unapproved_dependencies
)))]
1020 if not input_api
.is_committing
:
1021 suggested_owners
= owners_db
.reviewers_for(missing_files
, owner_email
)
1022 output_list
.append(output(
1023 'Suggested missing target path OWNERS:\n %s' %
1024 '\n '.join(suggested_owners
or [])))
1030 def _CheckSpamLogging(input_api
, output_api
):
1031 file_inclusion_pattern
= r
'.+%s' % _IMPLEMENTATION_EXTENSIONS
1032 black_list
= (_EXCLUDED_PATHS
+
1033 _TEST_CODE_EXCLUDED_PATHS
+
1034 input_api
.DEFAULT_BLACK_LIST
+
1035 (r
"^base[\\\/]logging\.h$",
1036 r
"^base[\\\/]logging\.cc$",
1037 r
"^chrome[\\\/]app[\\\/]chrome_main_delegate\.cc$",
1038 r
"^chrome[\\\/]browser[\\\/]chrome_browser_main\.cc$",
1039 r
"^chrome[\\\/]browser[\\\/]ui[\\\/]startup[\\\/]"
1040 r
"startup_browser_creator\.cc$",
1041 r
"^chrome[\\\/]installer[\\\/]setup[\\\/].*",
1042 r
"chrome[\\\/]browser[\\\/]diagnostics[\\\/]" +
1043 r
"diagnostics_writer\.cc$",
1044 r
"^chrome_elf[\\\/]dll_hash[\\\/]dll_hash_main\.cc$",
1045 r
"^chromecast[\\\/]",
1046 r
"^cloud_print[\\\/]",
1047 r
"^content[\\\/]common[\\\/]gpu[\\\/]client[\\\/]"
1048 r
"gl_helper_benchmark\.cc$",
1049 r
"^courgette[\\\/]courgette_tool\.cc$",
1050 r
"^extensions[\\\/]renderer[\\\/]logging_native_handler\.cc$",
1051 r
"^ipc[\\\/]ipc_logging\.cc$",
1052 r
"^native_client_sdk[\\\/]",
1053 r
"^remoting[\\\/]base[\\\/]logging\.h$",
1054 r
"^remoting[\\\/]host[\\\/].*",
1055 r
"^sandbox[\\\/]linux[\\\/].*",
1057 r
"^ui[\\\/]aura[\\\/]bench[\\\/]bench_main\.cc$",
1058 r
"^storage[\\\/]browser[\\\/]fileapi[\\\/]" +
1059 r
"dump_file_system.cc$",))
1060 source_file_filter
= lambda x
: input_api
.FilterSourceFile(
1061 x
, white_list
=(file_inclusion_pattern
,), black_list
=black_list
)
1066 for f
in input_api
.AffectedSourceFiles(source_file_filter
):
1067 contents
= input_api
.ReadFile(f
, 'rb')
1068 if input_api
.re
.search(r
"\bD?LOG\s*\(\s*INFO\s*\)", contents
):
1069 log_info
.append(f
.LocalPath())
1070 elif input_api
.re
.search(r
"\bD?LOG_IF\s*\(\s*INFO\s*,", contents
):
1071 log_info
.append(f
.LocalPath())
1073 if input_api
.re
.search(r
"\bprintf\(", contents
):
1074 printf
.append(f
.LocalPath())
1075 elif input_api
.re
.search(r
"\bfprintf\((stdout|stderr)", contents
):
1076 printf
.append(f
.LocalPath())
1079 return [output_api
.PresubmitError(
1080 'These files spam the console log with LOG(INFO):',
1083 return [output_api
.PresubmitError(
1084 'These files spam the console log with printf/fprintf:',
1089 def _CheckForAnonymousVariables(input_api
, output_api
):
1090 """These types are all expected to hold locks while in scope and
1091 so should never be anonymous (which causes them to be immediately
1093 they_who_must_be_named
= [
1097 'SkAutoAlphaRestore',
1098 'SkAutoBitmapShaderInstall',
1099 'SkAutoBlitterChoose',
1100 'SkAutoBounderCommit',
1102 'SkAutoCanvasRestore',
1103 'SkAutoCommentBlock',
1105 'SkAutoDisableDirectionCheck',
1106 'SkAutoDisableOvalCheck',
1113 'SkAutoMaskFreeImage',
1114 'SkAutoMutexAcquire',
1115 'SkAutoPathBoundsUpdate',
1117 'SkAutoRasterClipValidate',
1123 anonymous
= r
'(%s)\s*[({]' % '|'.join(they_who_must_be_named
)
1124 # bad: base::AutoLock(lock.get());
1125 # not bad: base::AutoLock lock(lock.get());
1126 bad_pattern
= input_api
.re
.compile(anonymous
)
1127 # good: new base::AutoLock(lock.get())
1128 good_pattern
= input_api
.re
.compile(r
'\bnew\s*' + anonymous
)
1131 for f
in input_api
.AffectedFiles():
1132 if not f
.LocalPath().endswith(('.cc', '.h', '.inl', '.m', '.mm')):
1134 for linenum
, line
in f
.ChangedContents():
1135 if bad_pattern
.search(line
) and not good_pattern
.search(line
):
1136 errors
.append('%s:%d' % (f
.LocalPath(), linenum
))
1139 return [output_api
.PresubmitError(
1140 'These lines create anonymous variables that need to be named:',
1145 def _CheckCygwinShell(input_api
, output_api
):
1146 source_file_filter
= lambda x
: input_api
.FilterSourceFile(
1147 x
, white_list
=(r
'.+\.(gyp|gypi)$',))
1150 for f
in input_api
.AffectedSourceFiles(source_file_filter
):
1151 for linenum
, line
in f
.ChangedContents():
1152 if 'msvs_cygwin_shell' in line
:
1153 cygwin_shell
.append(f
.LocalPath())
1157 return [output_api
.PresubmitError(
1158 'These files should not use msvs_cygwin_shell (the default is 0):',
1159 items
=cygwin_shell
)]
1163 def _CheckUserActionUpdate(input_api
, output_api
):
1164 """Checks if any new user action has been added."""
1165 if any('actions.xml' == input_api
.os_path
.basename(f
) for f
in
1166 input_api
.LocalPaths()):
1167 # If actions.xml is already included in the changelist, the PRESUBMIT
1168 # for actions.xml will do a more complete presubmit check.
1171 file_filter
= lambda f
: f
.LocalPath().endswith(('.cc', '.mm'))
1172 action_re
= r
'[^a-zA-Z]UserMetricsAction\("([^"]*)'
1173 current_actions
= None
1174 for f
in input_api
.AffectedFiles(file_filter
=file_filter
):
1175 for line_num
, line
in f
.ChangedContents():
1176 match
= input_api
.re
.search(action_re
, line
)
1178 # Loads contents in tools/metrics/actions/actions.xml to memory. It's
1180 if not current_actions
:
1181 with
open('tools/metrics/actions/actions.xml') as actions_f
:
1182 current_actions
= actions_f
.read()
1183 # Search for the matched user action name in |current_actions|.
1184 for action_name
in match
.groups():
1185 action
= 'name="{0}"'.format(action_name
)
1186 if action
not in current_actions
:
1187 return [output_api
.PresubmitPromptWarning(
1188 'File %s line %d: %s is missing in '
1189 'tools/metrics/actions/actions.xml. Please run '
1190 'tools/metrics/actions/extract_actions.py to update.'
1191 % (f
.LocalPath(), line_num
, action_name
))]
1195 def _GetJSONParseError(input_api
, filename
, eat_comments
=True):
1197 contents
= input_api
.ReadFile(filename
)
1199 json_comment_eater
= input_api
.os_path
.join(
1200 input_api
.PresubmitLocalPath(),
1201 'tools', 'json_comment_eater', 'json_comment_eater.py')
1202 process
= input_api
.subprocess
.Popen(
1203 [input_api
.python_executable
, json_comment_eater
],
1204 stdin
=input_api
.subprocess
.PIPE
,
1205 stdout
=input_api
.subprocess
.PIPE
,
1206 universal_newlines
=True)
1207 (contents
, _
) = process
.communicate(input=contents
)
1209 input_api
.json
.loads(contents
)
1210 except ValueError as e
:
1215 def _GetIDLParseError(input_api
, filename
):
1217 contents
= input_api
.ReadFile(filename
)
1218 idl_schema
= input_api
.os_path
.join(
1219 input_api
.PresubmitLocalPath(),
1220 'tools', 'json_schema_compiler', 'idl_schema.py')
1221 process
= input_api
.subprocess
.Popen(
1222 [input_api
.python_executable
, idl_schema
],
1223 stdin
=input_api
.subprocess
.PIPE
,
1224 stdout
=input_api
.subprocess
.PIPE
,
1225 stderr
=input_api
.subprocess
.PIPE
,
1226 universal_newlines
=True)
1227 (_
, error
) = process
.communicate(input=contents
)
1228 return error
or None
1229 except ValueError as e
:
1233 def _CheckParseErrors(input_api
, output_api
):
1234 """Check that IDL and JSON files do not contain syntax errors."""
1236 '.idl': _GetIDLParseError
,
1237 '.json': _GetJSONParseError
,
1239 # These paths contain test data and other known invalid JSON files.
1240 excluded_patterns
= [
1241 r
'test[\\\/]data[\\\/]',
1242 r
'^components[\\\/]policy[\\\/]resources[\\\/]policy_templates\.json$',
1244 # Most JSON files are preprocessed and support comments, but these do not.
1245 json_no_comments_patterns
= [
1248 # Only run IDL checker on files in these directories.
1249 idl_included_patterns
= [
1250 r
'^chrome[\\\/]common[\\\/]extensions[\\\/]api[\\\/]',
1251 r
'^extensions[\\\/]common[\\\/]api[\\\/]',
1254 def get_action(affected_file
):
1255 filename
= affected_file
.LocalPath()
1256 return actions
.get(input_api
.os_path
.splitext(filename
)[1])
1258 def MatchesFile(patterns
, path
):
1259 for pattern
in patterns
:
1260 if input_api
.re
.search(pattern
, path
):
1264 def FilterFile(affected_file
):
1265 action
= get_action(affected_file
)
1268 path
= affected_file
.LocalPath()
1270 if MatchesFile(excluded_patterns
, path
):
1273 if (action
== _GetIDLParseError
and
1274 not MatchesFile(idl_included_patterns
, path
)):
1279 for affected_file
in input_api
.AffectedFiles(
1280 file_filter
=FilterFile
, include_deletes
=False):
1281 action
= get_action(affected_file
)
1283 if (action
== _GetJSONParseError
and
1284 MatchesFile(json_no_comments_patterns
, affected_file
.LocalPath())):
1285 kwargs
['eat_comments'] = False
1286 parse_error
= action(input_api
,
1287 affected_file
.AbsoluteLocalPath(),
1290 results
.append(output_api
.PresubmitError('%s could not be parsed: %s' %
1291 (affected_file
.LocalPath(), parse_error
)))
1295 def _CheckJavaStyle(input_api
, output_api
):
1296 """Runs checkstyle on changed java files and returns errors if any exist."""
1298 original_sys_path
= sys
.path
1300 sys
.path
= sys
.path
+ [input_api
.os_path
.join(
1301 input_api
.PresubmitLocalPath(), 'tools', 'android', 'checkstyle')]
1304 # Restore sys.path to what it was before.
1305 sys
.path
= original_sys_path
1307 return checkstyle
.RunCheckstyle(
1308 input_api
, output_api
, 'tools/android/checkstyle/chromium-style-5.0.xml',
1309 black_list
=_EXCLUDED_PATHS
+ input_api
.DEFAULT_BLACK_LIST
)
1312 def _CheckAndroidCrLogUsage(input_api
, output_api
):
1313 """Checks that new logs using org.chromium.base.Log:
1314 - Are using 'TAG' as variable name for the tags (warn)
1315 - Are using the suggested name format for the tags: "cr.<PackageTag>" (warn)
1316 - Are using a tag that is shorter than 23 characters (error)
1318 cr_log_import_pattern
= input_api
.re
.compile(
1319 r
'^import org\.chromium\.base\.Log;$', input_api
.re
.MULTILINE
)
1320 class_in_base_pattern
= input_api
.re
.compile(
1321 r
'^package org\.chromium\.base;$', input_api
.re
.MULTILINE
)
1322 has_some_log_import_pattern
= input_api
.re
.compile(
1323 r
'^import .*\.Log;$', input_api
.re
.MULTILINE
)
1324 # Extract the tag from lines like `Log.d(TAG, "*");` or `Log.d("TAG", "*");`
1325 log_call_pattern
= input_api
.re
.compile(r
'^\s*Log\.\w\((?P<tag>\"?\w+\"?)\,')
1326 log_decl_pattern
= input_api
.re
.compile(
1327 r
'^\s*private static final String TAG = "(?P<name>(.*)")',
1328 input_api
.re
.MULTILINE
)
1329 log_name_pattern
= input_api
.re
.compile(r
'^cr[.\w]*')
1331 REF_MSG
= ('See base/android/java/src/org/chromium/base/README_logging.md '
1332 'or contact dgn@chromium.org for more info.')
1333 sources
= lambda x
: input_api
.FilterSourceFile(x
, white_list
=(r
'.*\.java$',))
1335 tag_decl_errors
= []
1336 tag_length_errors
= []
1338 util_log_errors
= []
1340 for f
in input_api
.AffectedSourceFiles(sources
):
1341 file_content
= input_api
.ReadFile(f
)
1342 has_modified_logs
= False
1345 if (cr_log_import_pattern
.search(file_content
) or
1346 (class_in_base_pattern
.search(file_content
) and
1347 not has_some_log_import_pattern
.search(file_content
))):
1348 # Checks to run for files using cr log
1349 for line_num
, line
in f
.ChangedContents():
1351 # Check if the new line is doing some logging
1352 match
= log_call_pattern
.search(line
)
1354 has_modified_logs
= True
1356 # Make sure it uses "TAG"
1357 if not match
.group('tag') == 'TAG':
1358 tag_errors
.append("%s:%d" % (f
.LocalPath(), line_num
))
1360 # Report non cr Log function calls in changed lines
1361 for line_num
, line
in f
.ChangedContents():
1362 if log_call_pattern
.search(line
):
1363 util_log_errors
.append("%s:%d" % (f
.LocalPath(), line_num
))
1366 if has_modified_logs
:
1367 # Make sure the tag is using the "cr" prefix and is not too long
1368 match
= log_decl_pattern
.search(file_content
)
1369 tag_name
= match
.group('name') if match
else ''
1370 if not log_name_pattern
.search(tag_name
):
1371 tag_decl_errors
.append(f
.LocalPath())
1372 if len(tag_name
) > 23:
1373 tag_length_errors
.append(f
.LocalPath())
1377 results
.append(output_api
.PresubmitPromptWarning(
1378 'Please define your tags using the suggested format: .\n'
1379 '"private static final String TAG = "cr.<package tag>".\n' + REF_MSG
,
1382 if tag_length_errors
:
1383 results
.append(output_api
.PresubmitError(
1384 'The tag length is restricted by the system to be at most '
1385 '23 characters.\n' + REF_MSG
,
1389 results
.append(output_api
.PresubmitPromptWarning(
1390 'Please use a variable named "TAG" for your log tags.\n' + REF_MSG
,
1394 results
.append(output_api
.PresubmitPromptWarning(
1395 'Please use org.chromium.base.Log for new logs.\n' + REF_MSG
,
1401 def _CheckForCopyrightedCode(input_api
, output_api
):
1402 """Verifies that newly added code doesn't contain copyrighted material
1403 and is properly licensed under the standard Chromium license.
1405 As there can be false positives, we maintain a whitelist file. This check
1406 also verifies that the whitelist file is up to date.
1409 original_sys_path
= sys
.path
1411 sys
.path
= sys
.path
+ [input_api
.os_path
.join(
1412 input_api
.PresubmitLocalPath(), 'tools')]
1413 from copyright_scanner
import copyright_scanner
1415 # Restore sys.path to what it was before.
1416 sys
.path
= original_sys_path
1418 return copyright_scanner
.ScanAtPresubmit(input_api
, output_api
)
1421 def _CheckSingletonInHeaders(input_api
, output_api
):
1422 """Checks to make sure no header files have |Singleton<|."""
1423 def FileFilter(affected_file
):
1424 # It's ok for base/memory/singleton.h to have |Singleton<|.
1425 black_list
= (_EXCLUDED_PATHS
+
1426 input_api
.DEFAULT_BLACK_LIST
+
1427 (r
"^base[\\\/]memory[\\\/]singleton\.h$",))
1428 return input_api
.FilterSourceFile(affected_file
, black_list
=black_list
)
1430 pattern
= input_api
.re
.compile(r
'(?<!class\s)Singleton\s*<')
1432 for f
in input_api
.AffectedSourceFiles(FileFilter
):
1433 if (f
.LocalPath().endswith('.h') or f
.LocalPath().endswith('.hxx') or
1434 f
.LocalPath().endswith('.hpp') or f
.LocalPath().endswith('.inl')):
1435 contents
= input_api
.ReadFile(f
)
1436 for line
in contents
.splitlines(False):
1437 if (not input_api
.re
.match(r
'//', line
) and # Strip C++ comment.
1438 pattern
.search(line
)):
1443 return [ output_api
.PresubmitError(
1444 'Found Singleton<T> in the following header files.\n' +
1445 'Please move them to an appropriate source file so that the ' +
1446 'template gets instantiated in a single compilation unit.',
1453 ( "-webkit-box", "flex" ),
1454 ( "-webkit-inline-box", "inline-flex" ),
1455 ( "-webkit-flex", "flex" ),
1456 ( "-webkit-inline-flex", "inline-flex" ),
1457 ( "-webkit-min-content", "min-content" ),
1458 ( "-webkit-max-content", "max-content" ),
1461 ( "-webkit-background-clip", "background-clip" ),
1462 ( "-webkit-background-origin", "background-origin" ),
1463 ( "-webkit-background-size", "background-size" ),
1464 ( "-webkit-box-shadow", "box-shadow" ),
1467 ( "-webkit-gradient", "gradient" ),
1468 ( "-webkit-repeating-gradient", "repeating-gradient" ),
1469 ( "-webkit-linear-gradient", "linear-gradient" ),
1470 ( "-webkit-repeating-linear-gradient", "repeating-linear-gradient" ),
1471 ( "-webkit-radial-gradient", "radial-gradient" ),
1472 ( "-webkit-repeating-radial-gradient", "repeating-radial-gradient" ),
1475 def _CheckNoDeprecatedCSS(input_api
, output_api
):
1476 """ Make sure that we don't use deprecated CSS
1477 properties, functions or values. Our external
1478 documentation and iOS CSS for dom distiller
1479 (reader mode) are ignored by the hooks as it
1480 needs to be consumed by WebKit. """
1482 file_inclusion_pattern
= (r
".+\.css$",)
1483 black_list
= (_EXCLUDED_PATHS
+
1484 _TEST_CODE_EXCLUDED_PATHS
+
1485 input_api
.DEFAULT_BLACK_LIST
+
1486 (r
"^chrome/common/extensions/docs",
1488 r
"^components/dom_distiller/core/css/distilledpage_ios.css",
1489 r
"^native_client_sdk"))
1490 file_filter
= lambda f
: input_api
.FilterSourceFile(
1491 f
, white_list
=file_inclusion_pattern
, black_list
=black_list
)
1492 for fpath
in input_api
.AffectedFiles(file_filter
=file_filter
):
1493 for line_num
, line
in fpath
.ChangedContents():
1494 for (deprecated_value
, value
) in _DEPRECATED_CSS
:
1495 if deprecated_value
in line
:
1496 results
.append(output_api
.PresubmitError(
1497 "%s:%d: Use of deprecated CSS %s, use %s instead" %
1498 (fpath
.LocalPath(), line_num
, deprecated_value
, value
)))
1503 ( "__lookupGetter__", "Object.getOwnPropertyDescriptor" ),
1504 ( "__defineGetter__", "Object.defineProperty" ),
1505 ( "__defineSetter__", "Object.defineProperty" ),
1508 def _CheckNoDeprecatedJS(input_api
, output_api
):
1509 """Make sure that we don't use deprecated JS in Chrome code."""
1511 file_inclusion_pattern
= (r
".+\.js$",) # TODO(dbeam): .html?
1512 black_list
= (_EXCLUDED_PATHS
+ _TEST_CODE_EXCLUDED_PATHS
+
1513 input_api
.DEFAULT_BLACK_LIST
)
1514 file_filter
= lambda f
: input_api
.FilterSourceFile(
1515 f
, white_list
=file_inclusion_pattern
, black_list
=black_list
)
1516 for fpath
in input_api
.AffectedFiles(file_filter
=file_filter
):
1517 for lnum
, line
in fpath
.ChangedContents():
1518 for (deprecated
, replacement
) in _DEPRECATED_JS
:
1519 if deprecated
in line
:
1520 results
.append(output_api
.PresubmitError(
1521 "%s:%d: Use of deprecated JS %s, use %s instead" %
1522 (fpath
.LocalPath(), lnum
, deprecated
, replacement
)))
1526 def _AndroidSpecificOnUploadChecks(input_api
, output_api
):
1527 """Groups checks that target android code."""
1529 results
.extend(_CheckAndroidCrLogUsage(input_api
, output_api
))
1533 def _CommonChecks(input_api
, output_api
):
1534 """Checks common to both upload and commit."""
1536 results
.extend(input_api
.canned_checks
.PanProjectChecks(
1537 input_api
, output_api
,
1538 excluded_paths
=_EXCLUDED_PATHS
+ _TESTRUNNER_PATHS
))
1539 results
.extend(_CheckAuthorizedAuthor(input_api
, output_api
))
1541 _CheckNoProductionCodeUsingTestOnlyFunctions(input_api
, output_api
))
1542 results
.extend(_CheckNoIOStreamInHeaders(input_api
, output_api
))
1543 results
.extend(_CheckNoUNIT_TESTInSourceFiles(input_api
, output_api
))
1544 results
.extend(_CheckNoNewWStrings(input_api
, output_api
))
1545 results
.extend(_CheckNoDEPSGIT(input_api
, output_api
))
1546 results
.extend(_CheckNoBannedFunctions(input_api
, output_api
))
1547 results
.extend(_CheckNoPragmaOnce(input_api
, output_api
))
1548 results
.extend(_CheckNoTrinaryTrueFalse(input_api
, output_api
))
1549 results
.extend(_CheckUnwantedDependencies(input_api
, output_api
))
1550 results
.extend(_CheckFilePermissions(input_api
, output_api
))
1551 results
.extend(_CheckNoAuraWindowPropertyHInHeaders(input_api
, output_api
))
1552 results
.extend(_CheckIncludeOrder(input_api
, output_api
))
1553 results
.extend(_CheckForVersionControlConflicts(input_api
, output_api
))
1554 results
.extend(_CheckPatchFiles(input_api
, output_api
))
1555 results
.extend(_CheckHardcodedGoogleHostsInLowerLayers(input_api
, output_api
))
1556 results
.extend(_CheckNoAbbreviationInPngFileName(input_api
, output_api
))
1557 results
.extend(_CheckForInvalidOSMacros(input_api
, output_api
))
1558 results
.extend(_CheckForInvalidIfDefinedMacros(input_api
, output_api
))
1559 # TODO(danakj): Remove this when base/move.h is removed.
1560 results
.extend(_CheckForUsingSideEffectsOfPass(input_api
, output_api
))
1561 results
.extend(_CheckAddedDepsHaveTargetApprovals(input_api
, output_api
))
1563 input_api
.canned_checks
.CheckChangeHasNoTabs(
1566 source_file_filter
=lambda x
: x
.LocalPath().endswith('.grd')))
1567 results
.extend(_CheckSpamLogging(input_api
, output_api
))
1568 results
.extend(_CheckForAnonymousVariables(input_api
, output_api
))
1569 results
.extend(_CheckCygwinShell(input_api
, output_api
))
1570 results
.extend(_CheckUserActionUpdate(input_api
, output_api
))
1571 results
.extend(_CheckNoDeprecatedCSS(input_api
, output_api
))
1572 results
.extend(_CheckNoDeprecatedJS(input_api
, output_api
))
1573 results
.extend(_CheckParseErrors(input_api
, output_api
))
1574 results
.extend(_CheckForIPCRules(input_api
, output_api
))
1575 results
.extend(_CheckForCopyrightedCode(input_api
, output_api
))
1576 results
.extend(_CheckForWindowsLineEndings(input_api
, output_api
))
1577 results
.extend(_CheckSingletonInHeaders(input_api
, output_api
))
1579 if any('PRESUBMIT.py' == f
.LocalPath() for f
in input_api
.AffectedFiles()):
1580 results
.extend(input_api
.canned_checks
.RunUnitTestsInDirectory(
1581 input_api
, output_api
,
1582 input_api
.PresubmitLocalPath(),
1583 whitelist
=[r
'^PRESUBMIT_test\.py$']))
1587 def _CheckAuthorizedAuthor(input_api
, output_api
):
1588 """For non-googler/chromites committers, verify the author's email address is
1591 # TODO(maruel): Add it to input_api?
1594 author
= input_api
.change
.author_email
1596 input_api
.logging
.info('No author, skipping AUTHOR check')
1598 authors_path
= input_api
.os_path
.join(
1599 input_api
.PresubmitLocalPath(), 'AUTHORS')
1601 input_api
.re
.match(r
'[^#]+\s+\<(.+?)\>\s*$', line
)
1602 for line
in open(authors_path
))
1603 valid_authors
= [item
.group(1).lower() for item
in valid_authors
if item
]
1604 if not any(fnmatch
.fnmatch(author
.lower(), valid
) for valid
in valid_authors
):
1605 input_api
.logging
.info('Valid authors are %s', ', '.join(valid_authors
))
1606 return [output_api
.PresubmitPromptWarning(
1607 ('%s is not in AUTHORS file. If you are a new contributor, please visit'
1609 'http://www.chromium.org/developers/contributing-code and read the '
1611 'If you are a chromite, verify the contributor signed the CLA.') %
1616 def _CheckPatchFiles(input_api
, output_api
):
1617 problems
= [f
.LocalPath() for f
in input_api
.AffectedFiles()
1618 if f
.LocalPath().endswith(('.orig', '.rej'))]
1620 return [output_api
.PresubmitError(
1621 "Don't commit .rej and .orig files.", problems
)]
1626 def _DidYouMeanOSMacro(bad_macro
):
1628 return {'A': 'OS_ANDROID',
1638 'W': 'OS_WIN'}[bad_macro
[3].upper()]
1643 def _CheckForInvalidOSMacrosInFile(input_api
, f
):
1644 """Check for sensible looking, totally invalid OS macros."""
1645 preprocessor_statement
= input_api
.re
.compile(r
'^\s*#')
1646 os_macro
= input_api
.re
.compile(r
'defined\((OS_[^)]+)\)')
1648 for lnum
, line
in f
.ChangedContents():
1649 if preprocessor_statement
.search(line
):
1650 for match
in os_macro
.finditer(line
):
1651 if not match
.group(1) in _VALID_OS_MACROS
:
1652 good
= _DidYouMeanOSMacro(match
.group(1))
1653 did_you_mean
= ' (did you mean %s?)' % good
if good
else ''
1654 results
.append(' %s:%d %s%s' % (f
.LocalPath(),
1661 def _CheckForInvalidOSMacros(input_api
, output_api
):
1662 """Check all affected files for invalid OS macros."""
1664 for f
in input_api
.AffectedFiles():
1665 if not f
.LocalPath().endswith(('.py', '.js', '.html', '.css')):
1666 bad_macros
.extend(_CheckForInvalidOSMacrosInFile(input_api
, f
))
1671 return [output_api
.PresubmitError(
1672 'Possibly invalid OS macro[s] found. Please fix your code\n'
1673 'or add your macro to src/PRESUBMIT.py.', bad_macros
)]
1676 def _CheckForInvalidIfDefinedMacrosInFile(input_api
, f
):
1677 """Check all affected files for invalid "if defined" macros."""
1678 ALWAYS_DEFINED_MACROS
= (
1687 "TARGET_IPHONE_SIMULATOR",
1688 "TARGET_OS_EMBEDDED",
1694 ifdef_macro
= input_api
.re
.compile(r
'^\s*#.*(?:ifdef\s|defined\()([^\s\)]+)')
1696 for lnum
, line
in f
.ChangedContents():
1697 for match
in ifdef_macro
.finditer(line
):
1698 if match
.group(1) in ALWAYS_DEFINED_MACROS
:
1699 always_defined
= ' %s is always defined. ' % match
.group(1)
1700 did_you_mean
= 'Did you mean \'#if %s\'?' % match
.group(1)
1701 results
.append(' %s:%d %s\n\t%s' % (f
.LocalPath(),
1708 def _CheckForInvalidIfDefinedMacros(input_api
, output_api
):
1709 """Check all affected files for invalid "if defined" macros."""
1711 for f
in input_api
.AffectedFiles():
1712 if f
.LocalPath().endswith(('.h', '.c', '.cc', '.m', '.mm')):
1713 bad_macros
.extend(_CheckForInvalidIfDefinedMacrosInFile(input_api
, f
))
1718 return [output_api
.PresubmitError(
1719 'Found ifdef check on always-defined macro[s]. Please fix your code\n'
1720 'or check the list of ALWAYS_DEFINED_MACROS in src/PRESUBMIT.py.',
1724 def _CheckForUsingSideEffectsOfPass(input_api
, output_api
):
1725 """Check all affected files for using side effects of Pass."""
1727 for f
in input_api
.AffectedFiles():
1728 if f
.LocalPath().endswith(('.h', '.c', '.cc', '.m', '.mm')):
1729 for lnum
, line
in f
.ChangedContents():
1730 # Disallow Foo(*my_scoped_thing.Pass()); See crbug.com/418297.
1731 if input_api
.re
.search(r
'\*[a-zA-Z0-9_]+\.Pass\(\)', line
):
1732 errors
.append(output_api
.PresubmitError(
1733 ('%s:%d uses *foo.Pass() to delete the contents of scoped_ptr. ' +
1734 'See crbug.com/418297.') % (f
.LocalPath(), lnum
)))
1738 def _CheckForIPCRules(input_api
, output_api
):
1739 """Check for same IPC rules described in
1740 http://www.chromium.org/Home/chromium-security/education/security-tips-for-ipc
1742 base_pattern
= r
'IPC_ENUM_TRAITS\('
1743 inclusion_pattern
= input_api
.re
.compile(r
'(%s)' % base_pattern
)
1744 comment_pattern
= input_api
.re
.compile(r
'//.*(%s)' % base_pattern
)
1747 for f
in input_api
.AffectedSourceFiles(None):
1748 local_path
= f
.LocalPath()
1749 if not local_path
.endswith('.h'):
1751 for line_number
, line
in f
.ChangedContents():
1752 if inclusion_pattern
.search(line
) and not comment_pattern
.search(line
):
1754 '%s:%d\n %s' % (local_path
, line_number
, line
.strip()))
1757 return [output_api
.PresubmitPromptWarning(
1758 _IPC_ENUM_TRAITS_DEPRECATED
, problems
)]
1763 def _CheckForWindowsLineEndings(input_api
, output_api
):
1764 """Check source code and known ascii text files for Windows style line
1767 known_text_files
= r
'.*\.(txt|html|htm|mhtml|py|gyp|gypi|gn|isolate)$'
1769 file_inclusion_pattern
= (
1771 r
'.+%s' % _IMPLEMENTATION_EXTENSIONS
1774 filter = lambda f
: input_api
.FilterSourceFile(
1775 f
, white_list
=file_inclusion_pattern
, black_list
=None)
1776 files
= [f
.LocalPath() for f
in
1777 input_api
.AffectedSourceFiles(filter)]
1782 fp
= open(file, 'r')
1784 if line
.endswith('\r\n'):
1785 problems
.append(file)
1790 return [output_api
.PresubmitPromptWarning('Are you sure that you want '
1791 'these files to contain Windows style line endings?\n' +
1792 '\n'.join(problems
))]
1797 def CheckChangeOnUpload(input_api
, output_api
):
1799 results
.extend(_CommonChecks(input_api
, output_api
))
1800 results
.extend(_CheckValidHostsInDEPS(input_api
, output_api
))
1801 results
.extend(_CheckJavaStyle(input_api
, output_api
))
1803 input_api
.canned_checks
.CheckGNFormatted(input_api
, output_api
))
1804 results
.extend(_CheckUmaHistogramChanges(input_api
, output_api
))
1805 results
.extend(_AndroidSpecificOnUploadChecks(input_api
, output_api
))
1809 def GetTryServerMasterForBot(bot
):
1810 """Returns the Try Server master for the given bot.
1812 It tries to guess the master from the bot name, but may still fail
1813 and return None. There is no longer a default master.
1815 # Potentially ambiguous bot names are listed explicitly.
1817 'chromium_presubmit': 'tryserver.chromium.linux',
1818 'blink_presubmit': 'tryserver.chromium.linux',
1819 'tools_build_presubmit': 'tryserver.chromium.linux',
1821 master
= master_map
.get(bot
)
1823 if 'linux' in bot
or 'android' in bot
or 'presubmit' in bot
:
1824 master
= 'tryserver.chromium.linux'
1826 master
= 'tryserver.chromium.win'
1827 elif 'mac' in bot
or 'ios' in bot
:
1828 master
= 'tryserver.chromium.mac'
1832 def GetDefaultTryConfigs(bots
):
1833 """Returns a list of ('bot', set(['tests']), filtered by [bots].
1836 builders_and_tests
= dict((bot
, set(['defaulttests'])) for bot
in bots
)
1838 # Build up the mapping from tryserver master to bot/test.
1840 for bot
, tests
in builders_and_tests
.iteritems():
1841 out
.setdefault(GetTryServerMasterForBot(bot
), {})[bot
] = tests
1845 def CheckChangeOnCommit(input_api
, output_api
):
1847 results
.extend(_CommonChecks(input_api
, output_api
))
1848 # TODO(thestig) temporarily disabled, doesn't work in third_party/
1849 #results.extend(input_api.canned_checks.CheckSvnModifiedDirectories(
1850 # input_api, output_api, sources))
1851 # Make sure the tree is 'open'.
1852 results
.extend(input_api
.canned_checks
.CheckTreeIsOpen(
1855 json_url
='http://chromium-status.appspot.com/current?format=json'))
1857 results
.extend(input_api
.canned_checks
.CheckChangeHasBugField(
1858 input_api
, output_api
))
1859 results
.extend(input_api
.canned_checks
.CheckChangeHasDescription(
1860 input_api
, output_api
))
1864 def GetPreferredTryMasters(project
, change
):
1870 cq_config_path
= os
.path
.join(
1871 change
.RepositoryRoot(), 'infra', 'config', 'cq.cfg')
1872 # commit_queue.py below is a script in depot_tools directory, which has a
1873 # 'builders' command to retrieve a list of CQ builders from the CQ config.
1874 is_win
= platform
.system() == 'Windows'
1875 masters
= json
.loads(subprocess
.check_output(
1876 ['commit_queue', 'builders', cq_config_path
], shell
=is_win
))
1879 for master
in masters
:
1880 try_config
.setdefault(master
, {})
1881 for builder
in masters
[master
]:
1882 # Do not trigger presubmit builders, since they're likely to fail
1883 # (e.g. OWNERS checks before finished code review), and we're
1884 # running local presubmit anyway.
1885 if 'presubmit' not in builder
:
1886 try_config
[master
][builder
] = ['defaulttests']