Support options from pydocstyle 6.2.0 and 6.3.0

[NMertsch]

What's new

• Support for --property-decorators (new in pydocstyle 6.2.0)
  • Exempt properties from D401 pydocstyle#546
  • D401 behaves differently in flake8-docstrings and pydocstyle #47
• Support for --ignore-self-only-init (new in pydocstyle 6.3.0)
  • Add ignore-self-only-init option pydocstyle#560

Implementation details

• Help messages were copied from pydocstyle.
• The pydocstyle version is checked, the options are only added to the CLI and passed to pydocstyle if the version supports it (previously: try-catch construct to check if --ignore-noqa from pydocstyle 6.0.0 is available).

How to test

Example file code.py:

"""This is my module."""
from functools import cached_property


class MyClass:
    """This is my class."""

    def __init__(self):
        # missing docstring, raises D107 unless '--ignore-self-only-init' is set
        pass

    @property
    def my_property(self) -> str:
        """This is my property."""
        # non-imperative docstring, raises D401 if 'property' is not in '--property-decorators'
        return "property"

    @cached_property
    def my_cached_property(self) -> str:
        """This is my cached property."""
        # non-imperative docstring, raises D401 if 'cached_property' is not in '--property-decorators'
        return "cached_property"

Addendum

Suggested HISTORY.rst entries for the next release:

- Add ``--ignore-self-only-init`` option to suppress D107 ("missing method
  docstring") if ``__init__`` has no parameters other than ``self``.
  (Requires pydocstyle >= 6.3.0)

- Add ``--property-decorators`` option to suppress D401 ("not in imperative
  mood") for docstrings of properties, defaulting to ``property``,
  ``cached_property``, and ``functools.cached_property``.
  (Requires pydocstyle >= 6.2.0)

[sigmavirus24]

Thank you for using kwargs here. pydocstyle has had a bunch of issues with other integrations using positional args