From dc07f7ca9bf68785fe01829203d06e8af6a5ac51 Mon Sep 17 00:00:00 2001 From: Florian Bruhin Date: Sat, 30 Jan 2016 23:30:12 +0100 Subject: [PATCH] Add a .pydocstylerc. --- .pydocstylerc | 13 +++++++++++++ MANIFEST.in | 1 + tox.ini | 11 +---------- 3 files changed, 15 insertions(+), 10 deletions(-) create mode 100644 .pydocstylerc diff --git a/.pydocstylerc b/.pydocstylerc new file mode 100644 index 000000000..74eb0beff --- /dev/null +++ b/.pydocstylerc @@ -0,0 +1,13 @@ +[pydocstyle] +# Disabled checks: +# D102: Missing docstring in public method (will be handled by others) +# D103: Missing docstring in public function (will be handled by others) +# D104: Missing docstring in public package (will be handled by others) +# D105: Missing docstring in magic method (will be handled by others) +# D209: Blank line before closing """ (removed from PEP257) +# D211: No blank lines allowed before class docstring +# (PEP257 got changed, but let's stick to the old standard) +# D402: First line should not be function's signature (false-positives) +ignore = D102,D103,D104,D105,D209,D211,D402 +match = (?!resources|test_*).*\.py +inherit = false diff --git a/MANIFEST.in b/MANIFEST.in index e2dd15509..be33e3cfc 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -32,6 +32,7 @@ exclude .eslintignore exclude doc/help exclude .appveyor.yml exclude .travis.yml +exclude .pydocstylerc exclude misc/appveyor_install.py global-exclude __pycache__ *.pyc *.pyo diff --git a/tox.ini b/tox.ini index da3ac8e4a..532cfb27b 100644 --- a/tox.ini +++ b/tox.ini @@ -155,16 +155,7 @@ basepython = python3 skip_install = true passenv = PYTHON LANG deps = pydocstyle==1.0.0 -# Disabled checks: -# D102: Missing docstring in public method (will be handled by others) -# D103: Missing docstring in public function (will be handled by others) -# D104: Missing docstring in public package (will be handled by others) -# D105: Missing docstring in magic method (will be handled by others) -# D209: Blank line before closing """ (removed from PEP257) -# D211: No blank lines allowed before class docstring -# (PEP257 got changed, but let's stick to the old standard) -# D402: First line should not be function's signature (false-positives) -commands = {envpython} -m pydocstyle scripts tests qutebrowser --ignore=D102,D103,D104,D105,D209,D211,D402 '--match=(?!resources|test_*).*\.py' +commands = {envpython} -m pydocstyle scripts tests qutebrowser [testenv:flake8] basepython = python3