[feature] Add stubs for the python bindings

[melMass]

Is your feature request related to a problem? Please describe.
I'm always frustrated when autocomplete doesn't work

Describe the solution you'd like
Whatever fit best the maintainer's workflow, a few ideas:

• pybind11-stubgen
• mypy's stubgen (used in the POC)

Describe alternatives you've considered
For a working POC I tried mypy's stubgen:

pip install mypy
stubgen -m f3d
stubgen -m f3d.pyf3d

Then copy the generated pyi files to site-packages/f3d

Additional context
The POC output
f3d-stubs.zip

Contribution
Probably easier if it's done by maintainers but if I'm pointed to the process I can dig into it yes!

[mwestphal]

@snoyer @Meakk

[Meakk]

Let's come back to this after #962 is merged

[mwestphal]

It is now merged, what about this issue then ? :)

[Meakk]

I think it's important to add the stub files so let's target 2.3.
Additionally, we should improve the bindings to name all arguments and document each function.

[mwestphal]

@snoyer @Meakk do you think you could improve this issue so that a python expert could pick it up ?