Configurable extra RST directives and roles

[peterjc]

This should close #7.

Example tested on a large code base - the following worked on the numpy master branch (they use Sphinx with their own numpydocs extension):

$ flake8 --select RST303,RST304 --rst-directives autosummary,data,currentmodule,deprecated,glossary,moduleauthor,plot,testcode,versionadded,versionchanged --rst-roles attr,class,func,meth,mod,obj,ref,term,c:member,py:func,py:mod numpy/

i.e. If they were using flake8, they could put this in their config file:

[flake8]
rst-directives =
    # These are sorted alphabetically - but that does not matter
    autosummary,data,currentmodule,deprecated,
    glossary,moduleauthor,plot,testcode,
    versionadded,versionchanged,
rst-roles =
    attr,class,func,meth,mod,obj,ref,term,
    # C programming language:
    c:member,
    # Python programming language:
    py:func,py:mod,

[sobolevn]

I love this! Thanks 👍

[peterjc]

Thanks @sobolevn.

I've got an afternoon meeting now, but barring any changes being suggested in the interim, I expect to do the merge and release later today.

[bskinn]

This looks like a really clean solution. Nice work!! Once the new release is out, I will definitely put it to use... strip out my blanket RST303/RST304 ignores and add the granularity.

Thanks!

[peterjc]

Please give v0.0.11 a shot now, up on PyPI - conda-forge to follow.

[bskinn]

CI passed just fine, with the new version of and config for flake8-rst-docstrings in place.

👍 🎊 🎉

[peterjc]

Excellent. Nice to see this being immediately useful, thanks for sharing that real world example.

[jlumbroso]

This feature is 👌🏻👌🏻👌🏻. 😁

@peterjc Thanks for implementation! @bskinn @sobolevn Thanks for testing!