[libvirt] [PATCH 10/10] build: comment on why we're not adopting certain flake8 rules

Daniel P. Berrangé berrange at redhat.com
Wed Oct 9 12:58:44 UTC 2019


Simplify the list of ignored warnings now that we only have two left,
and document why we're not honouring them.

Signed-off-by: Daniel P. Berrangé <berrange at redhat.com>
---
 build-aux/syntax-check.mk | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/build-aux/syntax-check.mk b/build-aux/syntax-check.mk
index ebacb8312e..812c8baae8 100644
--- a/build-aux/syntax-check.mk
+++ b/build-aux/syntax-check.mk
@@ -878,13 +878,17 @@ sc_require_enum_last_marker:
 	  { echo '$(ME): enum impl needs _LAST marker on second line' 1>&2; \
 	    exit 1; } || :
 
-# Validate many python style rules
-FLAKE8_LINE_LENGTH = E501
-FLAKE8_WARNINGS = W504
-
-FLAKE8_IGNORE = $(FLAKE8_LINE_LENGTH),$\
-		$(FLAKE8_WARNINGS) \
-		$(NULL)
+# We're intentionally ignoring a few warnings
+#
+# E501: Force breaking lines at < 80 characters results in
+# some really unnatural code formatting which harms
+# readability.
+#
+# W504: Knuth code style requires the operators "or" and "and" etc
+# to be at the start of line in a multi-line conditional.
+# This the opposite to what is normal libvirt practice.
+#
+FLAKE8_IGNORE = E501,W504
 
 sc_flake8:
 	@if [ -n "$(FLAKE8)" ]; then \
-- 
2.21.0




More information about the libvir-list mailing list