Le 13/06/2014 12:47, Ricordisamoa a écrit : Hello, multichill on IRC pointed me to your mail. Turns out there is a flake8 extension around pep257: https://pypi.python.org/pypi/flake8-docstrings/ So I am proposing to add a new tox env 'flake8-docstrings' that runs the pep257 utility and only select errors starting with 'D' (thus ignoring pep8/pyflakes errors). The pywikibot/core change is: https://gerrit.wikimedia.org/r/#/c/139412/ The first run is: https://integration.wikimedia.org/ci/job/pywikibot-core-tox-flake8-docstrin… We can pick a different name :) The Jenkins and Zuul configurations are straight forward: https://gerrit.wikimedia.org/r/139417 https://gerrit.wikimedia.org/r/139418 Have a good weekend! -- Antoine "hashar" Musso _______________________________________________ Pywikipedia-l mailing list Pywikipedia-l(a)lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/pywikipedia-l

Is there a way/tool to automatize a part of this work: I mean Blank line missing between one-line summary and description Expected 1 blank line *before* class docstring, found 0 type errors -- this kind may be machine-corrected. Not the missing docstrings, of course. _______________________________________________ Pywikipedia-l mailing list Pywikipedia-l(a)lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/pywikipedia-l

The entire codebase now passes a mandatory jenkins job (pre-code-review) , which requires valid docstrings except for functions and methods. Thanks to everyone involved in bringing the documentation up to this standard. There is still lots to do, like adding docstrings for functions and methods; full list of missing docstrings at: https://integration.wikimedia.org/ci/job/pywikibot-core-tox-flake8-docstrin…