Skip to content

Slightly relax coding-style checks#1652

Draft
leftaroundabout wants to merge 1 commit intoodlgroup:masterfrom
leftaroundabout:style/relaxed-pep8speaks
Draft

Slightly relax coding-style checks#1652
leftaroundabout wants to merge 1 commit intoodlgroup:masterfrom
leftaroundabout:style/relaxed-pep8speaks

Conversation

@leftaroundabout
Copy link
Copy Markdown
Contributor

This topic is up for debate.

It is certainly good to adhere to a style guide and PEP 8 is established and mostly sensible. However, I find myself repeatedly clashing with the pep8speaks linter, particularly its very narrow understanding of where whitespace is and isn't allowed. In some cases I find the "fixed" version (according to these rules) to have significantly worse readability, because they require e.g. breaking lines in inconvenient spots and disallow aligning code in an eye-intuitive way.

This can be avoided by ignoring some of the linter rules. I would suggest reflecting that in the pep8speaks configuration, so it isn't a sticking point in every single pull request.

Particularly debatable is the 80-characters limit. In my opinion it is good to aim for 80 characters, but not to be dogmatic about it and to introduce a line break just to avoid having 3 characters too many in a line (especially when the line break also requires extra parentheses, and more indentation).

Some of the "errors" that pep8speaks / pycodestyle keeps complaining about
are merely about whitespace used in a way that does not conform to its
simplistic rules. Sometimes, such whitespace can make the code more
eye-friendly, and indeed PEP8 explicitly mentions that this is legitimate.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant