0

[Android log] Fix presubmit check reports in base package

The presubmit check stop warning about Log calls from classes in the
org.chromium.base package.

Also does some refactoring to simplify logging related checks

BUG=498171

Review URL: https://codereview.chromium.org/1183493002

Cr-Commit-Position: refs/heads/master@{#334135}
This commit is contained in:
dgn
2015-06-12 02:15:12 -07:00
committed by Commit bot
parent f6d0a228e2
commit 87d9fb6e6c
2 changed files with 55 additions and 74 deletions

@@ -1311,9 +1311,13 @@ def _CheckAndroidCrLogUsage(input_api, output_api):
- Are using a tag that is shorter than 23 characters (error) - Are using a tag that is shorter than 23 characters (error)
""" """
cr_log_import_pattern = input_api.re.compile( cr_log_import_pattern = input_api.re.compile(
r'^import org\.chromium\.base\.Log;$', input_api.re.MULTILINE); r'^import org\.chromium\.base\.Log;$', input_api.re.MULTILINE)
class_in_base_pattern = input_api.re.compile(
r'^package org\.chromium\.base;$', input_api.re.MULTILINE)
has_some_log_import_pattern = input_api.re.compile(
r'^import .*\.Log;$', input_api.re.MULTILINE)
# Extract the tag from lines like `Log.d(TAG, "*");` or `Log.d("TAG", "*");` # Extract the tag from lines like `Log.d(TAG, "*");` or `Log.d("TAG", "*");`
cr_log_pattern = input_api.re.compile(r'^\s*Log\.\w\((?P<tag>\"?\w+\"?)\,') log_call_pattern = input_api.re.compile(r'^\s*Log\.\w\((?P<tag>\"?\w+\"?)\,')
log_decl_pattern = input_api.re.compile( log_decl_pattern = input_api.re.compile(
r'^\s*private static final String TAG = "(?P<name>(.*)")', r'^\s*private static final String TAG = "(?P<name>(.*)")',
input_api.re.MULTILINE) input_api.re.MULTILINE)
@@ -1322,26 +1326,36 @@ def _CheckAndroidCrLogUsage(input_api, output_api):
REF_MSG = ('See base/android/java/src/org/chromium/base/README_logging.md ' REF_MSG = ('See base/android/java/src/org/chromium/base/README_logging.md '
'or contact dgn@chromium.org for more info.') 'or contact dgn@chromium.org for more info.')
sources = lambda x: input_api.FilterSourceFile(x, white_list=(r'.*\.java$',)) sources = lambda x: input_api.FilterSourceFile(x, white_list=(r'.*\.java$',))
tag_errors = []
tag_decl_errors = [] tag_decl_errors = []
tag_length_errors = [] tag_length_errors = []
tag_errors = []
util_log_errors = []
for f in input_api.AffectedSourceFiles(sources): for f in input_api.AffectedSourceFiles(sources):
file_content = input_api.ReadFile(f) file_content = input_api.ReadFile(f)
has_modified_logs = False has_modified_logs = False
# Per line checks # Per line checks
if cr_log_import_pattern.search(file_content): if (cr_log_import_pattern.search(file_content) or
(class_in_base_pattern.search(file_content) and
not has_some_log_import_pattern.search(file_content))):
# Checks to run for files using cr log
for line_num, line in f.ChangedContents(): for line_num, line in f.ChangedContents():
# Check if the new line is doing some logging # Check if the new line is doing some logging
match = cr_log_pattern.search(line) match = log_call_pattern.search(line)
if match: if match:
has_modified_logs = True has_modified_logs = True
# Make sure it uses "TAG" # Make sure it uses "TAG"
if not match.group('tag') == 'TAG': if not match.group('tag') == 'TAG':
tag_errors.append("%s:%d" % (f.LocalPath(), line_num)) tag_errors.append("%s:%d" % (f.LocalPath(), line_num))
else:
# Report non cr Log function calls in changed lines
for line_num, line in f.ChangedContents():
if log_call_pattern.search(line):
util_log_errors.append("%s:%d" % (f.LocalPath(), line_num))
# Per file checks # Per file checks
if has_modified_logs: if has_modified_logs:
@@ -1371,36 +1385,11 @@ def _CheckAndroidCrLogUsage(input_api, output_api):
'Please use a variable named "TAG" for your log tags.\n' + REF_MSG, 'Please use a variable named "TAG" for your log tags.\n' + REF_MSG,
tag_errors)) tag_errors))
return results if util_log_errors:
# TODO(dgn): refactor with _CheckAndroidCrLogUsage
def _CheckNoNewUtilLogUsage(input_api, output_api):
"""Checks that new logs are using org.chromium.base.Log."""
chromium_log_import_pattern = input_api.re.compile(
r'^import org\.chromium\.base\.Log;$', input_api.re.MULTILINE);
log_pattern = input_api.re.compile(r'^\s*(android\.util\.)?Log\.\w')
sources = lambda x: input_api.FilterSourceFile(x, white_list=(r'.*\.java$',))
errors = []
for f in input_api.AffectedSourceFiles(sources):
if chromium_log_import_pattern.search(input_api.ReadFile(f)) is not None:
# Uses org.chromium.base.Log already
continue
for line_num, line in f.ChangedContents():
if log_pattern.search(line):
errors.append("%s:%d" % (f.LocalPath(), line_num))
results = []
if len(errors):
results.append(output_api.PresubmitPromptWarning( results.append(output_api.PresubmitPromptWarning(
'Please use org.chromium.base.Log for new logs.\n' + 'Please use org.chromium.base.Log for new logs.\n' + REF_MSG,
'See base/android/java/src/org/chromium/base/README_logging.md ' + util_log_errors))
'or contact dgn@chromium.org for more info.',
errors))
return results return results
@@ -1532,7 +1521,6 @@ def _CheckNoDeprecatedJS(input_api, output_api):
def _AndroidSpecificOnUploadChecks(input_api, output_api): def _AndroidSpecificOnUploadChecks(input_api, output_api):
"""Groups checks that target android code.""" """Groups checks that target android code."""
results = [] results = []
results.extend(_CheckNoNewUtilLogUsage(input_api, output_api))
results.extend(_CheckAndroidCrLogUsage(input_api, output_api)) results.extend(_CheckAndroidCrLogUsage(input_api, output_api))
return results return results

@@ -821,44 +821,6 @@ class UserMetricsActionTest(unittest.TestCase):
class LogUsageTest(unittest.TestCase): class LogUsageTest(unittest.TestCase):
def testCheckNoNewUtilLogUsage(self):
mock_input_api = MockInputApi()
mock_output_api = MockOutputApi()
mock_input_api.files = [
MockAffectedFile('RandomStuff.java', [
'random stuff'
]),
MockAffectedFile('HasCrLog.java', [
'import org.chromium.base.Log;',
'some random stuff',
'Log.d("TAG", "foo");',
]),
MockAffectedFile('HasAndroidLog.java', [
'import android.util.Log;',
'some random stuff',
'Log.d("TAG", "foo");',
]),
MockAffectedFile('HasExplicitLog.java', [
'some random stuff',
'android.util.Log.d("TAG", "foo");',
]),
MockAffectedFile('HasBothLog.java', [
'import org.chromium.base.Log;',
'some random stuff',
'Log.d("TAG", "foo");',
'android.util.Log.d("TAG", "foo");',
]),
]
warnings = PRESUBMIT._CheckNoNewUtilLogUsage(
mock_input_api, mock_output_api)
self.assertEqual(1, len(warnings))
self.assertEqual(2, len(warnings[0].items))
self.assertTrue('HasAndroidLog.java' in warnings[0].items[0])
self.assertTrue('HasExplicitLog.java' in warnings[0].items[1])
def testCheckAndroidCrLogUsage(self): def testCheckAndroidCrLogUsage(self):
mock_input_api = MockInputApi() mock_input_api = MockInputApi()
mock_output_api = MockOutputApi() mock_output_api = MockOutputApi()
@@ -867,6 +829,33 @@ class LogUsageTest(unittest.TestCase):
MockAffectedFile('RandomStuff.java', [ MockAffectedFile('RandomStuff.java', [
'random stuff' 'random stuff'
]), ]),
MockAffectedFile('HasAndroidLog.java', [
'import android.util.Log;',
'some random stuff',
'Log.d("TAG", "foo");',
]),
MockAffectedFile('HasExplicitUtilLog.java', [
'some random stuff',
'android.util.Log.d("TAG", "foo");',
]),
MockAffectedFile('IsInBasePackage.java', [
'package org.chromium.base;',
'private static final String TAG = "cr.Foo";',
'Log.d(TAG, "foo");',
]),
MockAffectedFile('IsInBasePackageButImportsLog.java', [
'package org.chromium.base;',
'import android.util.Log;',
'private static final String TAG = "cr.Foo";',
'Log.d(TAG, "foo");',
]),
MockAffectedFile('HasBothLog.java', [
'import org.chromium.base.Log;',
'some random stuff',
'private static final String TAG = "cr.Foo";',
'Log.d(TAG, "foo");',
'android.util.Log.d("TAG", "foo");',
]),
MockAffectedFile('HasCorrectTag.java', [ MockAffectedFile('HasCorrectTag.java', [
'import org.chromium.base.Log;', 'import org.chromium.base.Log;',
'some random stuff', 'some random stuff',
@@ -913,7 +902,7 @@ class LogUsageTest(unittest.TestCase):
msgs = PRESUBMIT._CheckAndroidCrLogUsage( msgs = PRESUBMIT._CheckAndroidCrLogUsage(
mock_input_api, mock_output_api) mock_input_api, mock_output_api)
self.assertEqual(3, len(msgs)) self.assertEqual(4, len(msgs))
# Declaration format # Declaration format
self.assertEqual(3, len(msgs[0].items)) self.assertEqual(3, len(msgs[0].items))
@@ -929,6 +918,10 @@ class LogUsageTest(unittest.TestCase):
self.assertEqual(1, len(msgs[2].items)) self.assertEqual(1, len(msgs[2].items))
self.assertTrue('HasInlineTag.java:4' in msgs[2].items) self.assertTrue('HasInlineTag.java:4' in msgs[2].items)
# Util Log usage
self.assertEqual(2, len(msgs[3].items))
self.assertTrue('HasAndroidLog.java:3' in msgs[3].items)
self.assertTrue('IsInBasePackageButImportsLog.java:4' in msgs[3].items)
if __name__ == '__main__': if __name__ == '__main__':