feat: Add support for Numpy docstrings

[aschmu]

This is an initial stab at supporting numpy style docstrings. The docstring_parser library is used, therefore not all errors are caught but I still think it's useful especially since the objective is to enable mkdocs to automatically document functions with the mkdocstrings plugin.

Speaking of mkdocstrings, I couldn't quite figure out how to switch (package-wide) to a different docstring style from the documentation 🤔 .

Fixes #7

[aschmu]

CI is failing given that mkdocs is a dependency of pytkdocs and requires a version number lower than the current one (0.10.1) :
mkdocstrings (>=0.13.1,<0.14.0) requires pytkdocs (>=0.2.0,<0.10.0)

Maybe mkdocstrings should relax the versio number requirements ?

[pawamoy]

I just upgraded mkdocstrings version in pyproject.toml to 0.14.0, which accepts pytkdocs <0.11. You can rebase on master to see how CI behaves now.

[aschmu]

Ok the CI is passing now !

[pawamoy]

Alright, looking good 🙂

Just a few nitpicks, and the new dependency should be made optional!

Thanks a lot 🙂

[aschmu]

I've tried to address all the comments. CI quality is failing for some reason (it didn't with make check locally).
Same for a build on windows :/

[aschmu]

Hello, did you have the time to review this PR ? Is there anything that can still be improved ?

[pawamoy]

Hi @aschmu, sorry for the delay! Thanks for addressing the previous comments! I've added a couple more. One of them could resolve the CI failure. If not I'll merge anyway, must simply be a CI cache issue 🙂

[pawamoy]

Merci Achille 😄 !