search

PyCQA / pydocstyle

docstring style checker
http://pydocstyle.org
MIT License
1.11k stars 188 forks source link

Not detecting wrong DocStrings #638

Open borghoffd opened 1 year ago

borghoffd commented 1 year ago

Hey there,

I just stumbled upon an issue where pydocstyle doesn't recognize wrongly formatted DocStrings. Here is an example:

def test_query(self) -> None:
        """
            this is a wrongly formatted docstring
        """

I was pretty sure that this once worked, so I tried out some older versions of pydocstyle. With version 6.1.1 I get the notifications I was expecting, f.e. "DocString is over-intended" and "First line should end with a period, ...". I also tested versions 6.2.0 and 6.2.3 where I am missing those notifications.

Is this a bug or did something change so that these are not shown anymore?

Thanks for your answer! Dennis

niksite commented 1 year ago

It even passed some completely missed docstrings, starting from version 6.2.0!