I have recently updated the flake8 toolchain for science pipelines such that we are now running pycodestyle 2.5.0 and flake8 3.7.5. The big difference is the addition of the new
--max-doc-length argument (added by @brianv0). The developer guide says that docstrings and comments should not go past column 79. Previously this was impossible to verify and much of our codebase violates this requirement. Now you can add
max-doc-length = 79 to your
setup.cfg file (under the
max-line-length definition) and flake8 will check the code as part of its normal checks and issue a W505 warning.
As you make your code compliant please add the new check to your package. I have added this check to