OLD | NEW |
| (Empty) |
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. | |
4 | |
5 """Top-level presubmit script for cc. | |
6 | |
7 See http://dev.chromium.org/developers/how-tos/depottools/presubmit-scripts | |
8 for more details about the presubmit API built into depot_tools. | |
9 """ | |
10 | |
11 import re | |
12 import string | |
13 | |
14 CC_SOURCE_FILES=(r'^cc[\\/].*\.(cc|h)$',) | |
15 | |
16 def CheckChangeLintsClean(input_api, output_api): | |
17 source_filter = lambda x: input_api.FilterSourceFile( | |
18 x, white_list=CC_SOURCE_FILES, black_list=None) | |
19 | |
20 return input_api.canned_checks.CheckChangeLintsClean( | |
21 input_api, output_api, source_filter, lint_filters=[], verbose_level=1) | |
22 | |
23 def CheckAsserts(input_api, output_api, white_list=CC_SOURCE_FILES, black_list=N
one): | |
24 black_list = tuple(black_list or input_api.DEFAULT_BLACK_LIST) | |
25 source_file_filter = lambda x: input_api.FilterSourceFile(x, white_list, black
_list) | |
26 | |
27 assert_files = [] | |
28 notreached_files = [] | |
29 | |
30 for f in input_api.AffectedSourceFiles(source_file_filter): | |
31 contents = input_api.ReadFile(f, 'rb') | |
32 # WebKit ASSERT() is not allowed. | |
33 if re.search(r"\bASSERT\(", contents): | |
34 assert_files.append(f.LocalPath()) | |
35 # WebKit ASSERT_NOT_REACHED() is not allowed. | |
36 if re.search(r"ASSERT_NOT_REACHED\(", contents): | |
37 notreached_files.append(f.LocalPath()) | |
38 | |
39 if assert_files: | |
40 return [output_api.PresubmitError( | |
41 'These files use ASSERT instead of using DCHECK:', | |
42 items=assert_files)] | |
43 if notreached_files: | |
44 return [output_api.PresubmitError( | |
45 'These files use ASSERT_NOT_REACHED instead of using NOTREACHED:', | |
46 items=notreached_files)] | |
47 return [] | |
48 | |
49 def CheckStdAbs(input_api, output_api, | |
50 white_list=CC_SOURCE_FILES, black_list=None): | |
51 black_list = tuple(black_list or input_api.DEFAULT_BLACK_LIST) | |
52 source_file_filter = lambda x: input_api.FilterSourceFile(x, | |
53 white_list, | |
54 black_list) | |
55 | |
56 using_std_abs_files = [] | |
57 found_fabs_files = [] | |
58 missing_std_prefix_files = [] | |
59 | |
60 for f in input_api.AffectedSourceFiles(source_file_filter): | |
61 contents = input_api.ReadFile(f, 'rb') | |
62 if re.search(r"using std::f?abs;", contents): | |
63 using_std_abs_files.append(f.LocalPath()) | |
64 if re.search(r"\bfabsf?\(", contents): | |
65 found_fabs_files.append(f.LocalPath()); | |
66 | |
67 no_std_prefix = r"(?<!std::)" | |
68 # Matches occurrences of abs/absf/fabs/fabsf without a "std::" prefix. | |
69 abs_without_prefix = r"%s(\babsf?\()" % no_std_prefix | |
70 fabs_without_prefix = r"%s(\bfabsf?\()" % no_std_prefix | |
71 # Skips matching any lines that have "// NOLINT". | |
72 no_nolint = r"(?![^\n]*//\s+NOLINT)" | |
73 | |
74 expression = re.compile("(%s|%s)%s" % | |
75 (abs_without_prefix, fabs_without_prefix, no_nolint)) | |
76 if expression.search(contents): | |
77 missing_std_prefix_files.append(f.LocalPath()) | |
78 | |
79 result = [] | |
80 if using_std_abs_files: | |
81 result.append(output_api.PresubmitError( | |
82 'These files have "using std::abs" which is not permitted.', | |
83 items=using_std_abs_files)) | |
84 if found_fabs_files: | |
85 result.append(output_api.PresubmitError( | |
86 'std::abs() should be used instead of std::fabs() for consistency.', | |
87 items=found_fabs_files)) | |
88 if missing_std_prefix_files: | |
89 result.append(output_api.PresubmitError( | |
90 'These files use abs(), absf(), fabs(), or fabsf() without qualifying ' | |
91 'the std namespace. Please use std::abs() in all places.', | |
92 items=missing_std_prefix_files)) | |
93 return result | |
94 | |
95 def CheckPassByValue(input_api, | |
96 output_api, | |
97 white_list=CC_SOURCE_FILES, | |
98 black_list=None): | |
99 black_list = tuple(black_list or input_api.DEFAULT_BLACK_LIST) | |
100 source_file_filter = lambda x: input_api.FilterSourceFile(x, | |
101 white_list, | |
102 black_list) | |
103 | |
104 local_errors = [] | |
105 | |
106 # Well-defined simple classes containing only <= 4 ints, or <= 2 floats. | |
107 pass_by_value_types = ['base::Time', | |
108 'base::TimeTicks', | |
109 ] | |
110 | |
111 for f in input_api.AffectedSourceFiles(source_file_filter): | |
112 contents = input_api.ReadFile(f, 'rb') | |
113 match = re.search( | |
114 r'\bconst +' + '(?P<type>(%s))&' % | |
115 string.join(pass_by_value_types, '|'), | |
116 contents) | |
117 if match: | |
118 local_errors.append(output_api.PresubmitError( | |
119 '%s passes %s by const ref instead of by value.' % | |
120 (f.LocalPath(), match.group('type')))) | |
121 return local_errors | |
122 | |
123 def CheckTodos(input_api, output_api): | |
124 errors = [] | |
125 | |
126 source_file_filter = lambda x: x | |
127 for f in input_api.AffectedSourceFiles(source_file_filter): | |
128 contents = input_api.ReadFile(f, 'rb') | |
129 if ('FIX'+'ME') in contents: | |
130 errors.append(f.LocalPath()) | |
131 | |
132 if errors: | |
133 return [output_api.PresubmitError( | |
134 'All TODO comments should be of the form TODO(name). ' + | |
135 'Use TODO instead of FIX' + 'ME', | |
136 items=errors)] | |
137 return [] | |
138 | |
139 def CheckDoubleAngles(input_api, output_api, white_list=CC_SOURCE_FILES, | |
140 black_list=None): | |
141 errors = [] | |
142 | |
143 source_file_filter = lambda x: input_api.FilterSourceFile(x, | |
144 white_list, | |
145 black_list) | |
146 for f in input_api.AffectedSourceFiles(source_file_filter): | |
147 contents = input_api.ReadFile(f, 'rb') | |
148 if ('> >') in contents: | |
149 errors.append(f.LocalPath()) | |
150 | |
151 if errors: | |
152 return [output_api.PresubmitError('Use >> instead of > >:', items=errors)] | |
153 return [] | |
154 | |
155 def CheckScopedPtr(input_api, output_api, | |
156 white_list=CC_SOURCE_FILES, black_list=None): | |
157 black_list = tuple(black_list or input_api.DEFAULT_BLACK_LIST) | |
158 source_file_filter = lambda x: input_api.FilterSourceFile(x, | |
159 white_list, | |
160 black_list) | |
161 errors = [] | |
162 for f in input_api.AffectedSourceFiles(source_file_filter): | |
163 for line_number, line in f.ChangedContents(): | |
164 # Disallow: | |
165 # return scoped_ptr<T>(foo); | |
166 # bar = scoped_ptr<T>(foo); | |
167 # But allow: | |
168 # return scoped_ptr<T[]>(foo); | |
169 # bar = scoped_ptr<T[]>(foo); | |
170 if re.search(r'(=|\breturn)\s*scoped_ptr<.*?(?<!])>\([^)]+\)', line): | |
171 errors.append(output_api.PresubmitError( | |
172 ('%s:%d uses explicit scoped_ptr constructor. ' + | |
173 'Use make_scoped_ptr() instead.') % (f.LocalPath(), line_number))) | |
174 # Disallow: | |
175 # scoped_ptr<T>() | |
176 if re.search(r'\bscoped_ptr<.*?>\(\)', line): | |
177 errors.append(output_api.PresubmitError( | |
178 '%s:%d uses scoped_ptr<T>(). Use nullptr instead.' % | |
179 (f.LocalPath(), line_number))) | |
180 return errors | |
181 | |
182 def FindUnquotedQuote(contents, pos): | |
183 match = re.search(r"(?<!\\)(?P<quote>\")", contents[pos:]) | |
184 return -1 if not match else match.start("quote") + pos | |
185 | |
186 def FindUselessIfdefs(input_api, output_api): | |
187 errors = [] | |
188 source_file_filter = lambda x: x | |
189 for f in input_api.AffectedSourceFiles(source_file_filter): | |
190 contents = input_api.ReadFile(f, 'rb') | |
191 if re.search(r'#if\s*0\s', contents): | |
192 errors.append(f.LocalPath()) | |
193 if errors: | |
194 return [output_api.PresubmitError( | |
195 'Don\'t use #if '+'0; just delete the code.', | |
196 items=errors)] | |
197 return [] | |
198 | |
199 def FindNamespaceInBlock(pos, namespace, contents, whitelist=[]): | |
200 open_brace = -1 | |
201 close_brace = -1 | |
202 quote = -1 | |
203 name = -1 | |
204 brace_count = 1 | |
205 quote_count = 0 | |
206 while pos < len(contents) and brace_count > 0: | |
207 if open_brace < pos: open_brace = contents.find("{", pos) | |
208 if close_brace < pos: close_brace = contents.find("}", pos) | |
209 if quote < pos: quote = FindUnquotedQuote(contents, pos) | |
210 if name < pos: name = contents.find(("%s::" % namespace), pos) | |
211 | |
212 if name < 0: | |
213 return False # The namespace is not used at all. | |
214 if open_brace < 0: | |
215 open_brace = len(contents) | |
216 if close_brace < 0: | |
217 close_brace = len(contents) | |
218 if quote < 0: | |
219 quote = len(contents) | |
220 | |
221 next = min(open_brace, min(close_brace, min(quote, name))) | |
222 | |
223 if next == open_brace: | |
224 brace_count += 1 | |
225 elif next == close_brace: | |
226 brace_count -= 1 | |
227 elif next == quote: | |
228 quote_count = 0 if quote_count else 1 | |
229 elif next == name and not quote_count: | |
230 in_whitelist = False | |
231 for w in whitelist: | |
232 if re.match(w, contents[next:]): | |
233 in_whitelist = True | |
234 break | |
235 if not in_whitelist: | |
236 return True | |
237 pos = next + 1 | |
238 return False | |
239 | |
240 # Checks for the use of cc:: within the cc namespace, which is usually | |
241 # redundant. | |
242 def CheckNamespace(input_api, output_api): | |
243 errors = [] | |
244 | |
245 source_file_filter = lambda x: x | |
246 for f in input_api.AffectedSourceFiles(source_file_filter): | |
247 contents = input_api.ReadFile(f, 'rb') | |
248 match = re.search(r'namespace\s*cc\s*{', contents) | |
249 if match: | |
250 whitelist = [ | |
251 r"cc::remove_if\b", | |
252 ] | |
253 if FindNamespaceInBlock(match.end(), 'cc', contents, whitelist=whitelist): | |
254 errors.append(f.LocalPath()) | |
255 | |
256 if errors: | |
257 return [output_api.PresubmitError( | |
258 'Do not use cc:: inside of the cc namespace.', | |
259 items=errors)] | |
260 return [] | |
261 | |
262 def CheckForUseOfWrongClock(input_api, | |
263 output_api, | |
264 white_list=CC_SOURCE_FILES, | |
265 black_list=None): | |
266 """Make sure new lines of code don't use a clock susceptible to skew.""" | |
267 black_list = tuple(black_list or input_api.DEFAULT_BLACK_LIST) | |
268 source_file_filter = lambda x: input_api.FilterSourceFile(x, | |
269 white_list, | |
270 black_list) | |
271 # Regular expression that should detect any explicit references to the | |
272 # base::Time type (or base::Clock/DefaultClock), whether in using decls, | |
273 # typedefs, or to call static methods. | |
274 base_time_type_pattern = r'(^|\W)base::(Time|Clock|DefaultClock)(\W|$)' | |
275 | |
276 # Regular expression that should detect references to the base::Time class | |
277 # members, such as a call to base::Time::Now. | |
278 base_time_member_pattern = r'(^|\W)(Time|Clock|DefaultClock)::' | |
279 | |
280 # Regular expression to detect "using base::Time" declarations. We want to | |
281 # prevent these from triggerring a warning. For example, it's perfectly | |
282 # reasonable for code to be written like this: | |
283 # | |
284 # using base::Time; | |
285 # ... | |
286 # int64 foo_us = foo_s * Time::kMicrosecondsPerSecond; | |
287 using_base_time_decl_pattern = r'^\s*using\s+(::)?base::Time\s*;' | |
288 | |
289 # Regular expression to detect references to the kXXX constants in the | |
290 # base::Time class. We want to prevent these from triggerring a warning. | |
291 base_time_konstant_pattern = r'(^|\W)Time::k\w+' | |
292 | |
293 problem_re = input_api.re.compile( | |
294 r'(' + base_time_type_pattern + r')|(' + base_time_member_pattern + r')') | |
295 exception_re = input_api.re.compile( | |
296 r'(' + using_base_time_decl_pattern + r')|(' + | |
297 base_time_konstant_pattern + r')') | |
298 problems = [] | |
299 for f in input_api.AffectedSourceFiles(source_file_filter): | |
300 for line_number, line in f.ChangedContents(): | |
301 if problem_re.search(line): | |
302 if not exception_re.search(line): | |
303 problems.append( | |
304 ' %s:%d\n %s' % (f.LocalPath(), line_number, line.strip())) | |
305 | |
306 if problems: | |
307 return [output_api.PresubmitPromptOrNotify( | |
308 'You added one or more references to the base::Time class and/or one\n' | |
309 'of its member functions (or base::Clock/DefaultClock). In cc code,\n' | |
310 'it is most certainly incorrect! Instead use base::TimeTicks.\n\n' | |
311 '\n'.join(problems))] | |
312 else: | |
313 return [] | |
314 | |
315 def CheckChangeOnUpload(input_api, output_api): | |
316 results = [] | |
317 results += CheckAsserts(input_api, output_api) | |
318 results += CheckStdAbs(input_api, output_api) | |
319 results += CheckPassByValue(input_api, output_api) | |
320 results += CheckChangeLintsClean(input_api, output_api) | |
321 results += CheckTodos(input_api, output_api) | |
322 results += CheckDoubleAngles(input_api, output_api) | |
323 results += CheckScopedPtr(input_api, output_api) | |
324 results += CheckNamespace(input_api, output_api) | |
325 results += CheckForUseOfWrongClock(input_api, output_api) | |
326 results += FindUselessIfdefs(input_api, output_api) | |
327 results += input_api.canned_checks.CheckPatchFormatted(input_api, output_api) | |
328 return results | |
OLD | NEW |