e1b5d6d0b9
Add hacking checks to check dict.iteritems, dict.itervalues and dict.iterkeys should not be used in the future and raise error while running pep8 using tox. Trivial Fix Change-Id: Id7f0c8b963cfd5739ed3e2ecec2c0feebc290af4
199 lines
6.6 KiB
Python
199 lines
6.6 KiB
Python
# Copyright (c) 2014 OpenStack Foundation.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
# not use this file except in compliance with the License. You may obtain
|
|
# a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
|
|
import re
|
|
|
|
import pep8
|
|
|
|
"""
|
|
Guidelines for writing new hacking checks
|
|
|
|
- Use only for Glance-specific tests. OpenStack general tests
|
|
should be submitted to the common 'hacking' module.
|
|
- Pick numbers in the range G3xx. Find the current test with
|
|
the highest allocated number and then pick the next value.
|
|
If nova has an N3xx code for that test, use the same number.
|
|
- Keep the test method code in the source file ordered based
|
|
on the G3xx value.
|
|
- List the new rule in the top level HACKING.rst file
|
|
- Add test cases for each new rule to glance/tests/test_hacking.py
|
|
|
|
"""
|
|
|
|
|
|
asse_trueinst_re = re.compile(
|
|
r"(.)*assertTrue\(isinstance\((\w|\.|\'|\"|\[|\])+, "
|
|
"(\w|\.|\'|\"|\[|\])+\)\)")
|
|
asse_equal_type_re = re.compile(
|
|
r"(.)*assertEqual\(type\((\w|\.|\'|\"|\[|\])+\), "
|
|
"(\w|\.|\'|\"|\[|\])+\)")
|
|
asse_equal_end_with_none_re = re.compile(
|
|
r"(.)*assertEqual\((\w|\.|\'|\"|\[|\])+, None\)")
|
|
asse_equal_start_with_none_re = re.compile(
|
|
r"(.)*assertEqual\(None, (\w|\.|\'|\"|\[|\])+\)")
|
|
unicode_func_re = re.compile(r"(\s|\W|^)unicode\(")
|
|
log_translation = re.compile(
|
|
r"(.)*LOG\.(audit)\(\s*('|\")")
|
|
log_translation_info = re.compile(
|
|
r"(.)*LOG\.(info)\(\s*(_\(|'|\")")
|
|
log_translation_exception = re.compile(
|
|
r"(.)*LOG\.(exception)\(\s*(_\(|'|\")")
|
|
log_translation_error = re.compile(
|
|
r"(.)*LOG\.(error)\(\s*(_\(|'|\")")
|
|
log_translation_critical = re.compile(
|
|
r"(.)*LOG\.(critical)\(\s*(_\(|'|\")")
|
|
log_translation_warning = re.compile(
|
|
r"(.)*LOG\.(warning)\(\s*(_\(|'|\")")
|
|
dict_constructor_with_list_copy_re = re.compile(r".*\bdict\((\[)?(\(|\[)")
|
|
|
|
|
|
def assert_true_instance(logical_line):
|
|
"""Check for assertTrue(isinstance(a, b)) sentences
|
|
|
|
G316
|
|
"""
|
|
if asse_trueinst_re.match(logical_line):
|
|
yield (0, "G316: assertTrue(isinstance(a, b)) sentences not allowed")
|
|
|
|
|
|
def assert_equal_type(logical_line):
|
|
"""Check for assertEqual(type(A), B) sentences
|
|
|
|
G317
|
|
"""
|
|
if asse_equal_type_re.match(logical_line):
|
|
yield (0, "G317: assertEqual(type(A), B) sentences not allowed")
|
|
|
|
|
|
def assert_equal_none(logical_line):
|
|
"""Check for assertEqual(A, None) or assertEqual(None, A) sentences
|
|
|
|
G318
|
|
"""
|
|
res = (asse_equal_start_with_none_re.match(logical_line) or
|
|
asse_equal_end_with_none_re.match(logical_line))
|
|
if res:
|
|
yield (0, "G318: assertEqual(A, None) or assertEqual(None, A) "
|
|
"sentences not allowed")
|
|
|
|
|
|
def no_translate_debug_logs(logical_line, filename):
|
|
dirs = [
|
|
"glance/api",
|
|
"glance/cmd",
|
|
"glance/common",
|
|
"glance/db",
|
|
"glance/domain",
|
|
"glance/image_cache",
|
|
"glance/quota",
|
|
"glance/registry",
|
|
"glance/store",
|
|
"glance/tests",
|
|
]
|
|
|
|
if max([name in filename for name in dirs]):
|
|
if logical_line.startswith("LOG.debug(_("):
|
|
yield(0, "G319: Don't translate debug level logs")
|
|
|
|
|
|
def no_direct_use_of_unicode_function(logical_line):
|
|
"""Check for use of unicode() builtin
|
|
|
|
G320
|
|
"""
|
|
if unicode_func_re.match(logical_line):
|
|
yield(0, "G320: Use six.text_type() instead of unicode()")
|
|
|
|
|
|
def validate_log_translations(logical_line, physical_line, filename):
|
|
# Translations are not required in the test directory
|
|
if pep8.noqa(physical_line):
|
|
return
|
|
msg = "G322: LOG.info messages require translations `_LI()`!"
|
|
if log_translation_info.match(logical_line):
|
|
yield (0, msg)
|
|
msg = "G323: LOG.exception messages require translations `_LE()`!"
|
|
if log_translation_exception.match(logical_line):
|
|
yield (0, msg)
|
|
msg = "G324: LOG.error messages require translations `_LE()`!"
|
|
if log_translation_error.match(logical_line):
|
|
yield (0, msg)
|
|
msg = "G325: LOG.critical messages require translations `_LC()`!"
|
|
if log_translation_critical.match(logical_line):
|
|
yield (0, msg)
|
|
msg = "G326: LOG.warning messages require translations `_LW()`!"
|
|
if log_translation_warning.match(logical_line):
|
|
yield (0, msg)
|
|
msg = "G321: Log messages require translations!"
|
|
if log_translation.match(logical_line):
|
|
yield (0, msg)
|
|
|
|
|
|
def check_no_contextlib_nested(logical_line):
|
|
msg = ("G327: contextlib.nested is deprecated since Python 2.7. See "
|
|
"https://docs.python.org/2/library/contextlib.html#contextlib."
|
|
"nested for more information.")
|
|
if ("with contextlib.nested(" in logical_line or
|
|
"with nested(" in logical_line):
|
|
yield(0, msg)
|
|
|
|
|
|
def dict_constructor_with_list_copy(logical_line):
|
|
msg = ("G328: Must use a dict comprehension instead of a dict constructor "
|
|
"with a sequence of key-value pairs.")
|
|
if dict_constructor_with_list_copy_re.match(logical_line):
|
|
yield (0, msg)
|
|
|
|
|
|
def check_python3_xrange(logical_line):
|
|
if re.search(r"\bxrange\s*\(", logical_line):
|
|
yield(0, "G329: Do not use xrange. Use range, or six.moves.range for "
|
|
"large loops.")
|
|
|
|
|
|
def check_python3_no_iteritems(logical_line):
|
|
msg = ("G330: Use six.iteritems() or dict.items() instead of "
|
|
"dict.iteritems().")
|
|
if re.search(r".*\.iteritems\(\)", logical_line):
|
|
yield(0, msg)
|
|
|
|
|
|
def check_python3_no_iterkeys(logical_line):
|
|
msg = ("G331: Use six.iterkeys() or dict.keys() instead of "
|
|
"dict.iterkeys().")
|
|
if re.search(r".*\.iterkeys\(\)", logical_line):
|
|
yield(0, msg)
|
|
|
|
|
|
def check_python3_no_itervalues(logical_line):
|
|
msg = ("G332: Use six.itervalues() or dict.values instead of "
|
|
"dict.itervalues().")
|
|
if re.search(r".*\.itervalues\(\)", logical_line):
|
|
yield(0, msg)
|
|
|
|
|
|
def factory(register):
|
|
register(assert_true_instance)
|
|
register(assert_equal_type)
|
|
register(assert_equal_none)
|
|
register(no_translate_debug_logs)
|
|
register(no_direct_use_of_unicode_function)
|
|
register(validate_log_translations)
|
|
register(check_no_contextlib_nested)
|
|
register(dict_constructor_with_list_copy)
|
|
register(check_python3_xrange)
|
|
register(check_python3_no_iteritems)
|
|
register(check_python3_no_iterkeys)
|
|
register(check_python3_no_itervalues)
|