Contribute all good stuff to mypy.stubgenc and freeze this repo

[sizmailov]

At the point when mypy.stubgen (or other) will be able to generate full-featured stubs for pybind11 there would be no need in this tool.

Things to ship:

• function signatures
• default argument parsing
• attribute types
• attribute values
• nested classes
• functions with positional-only arguments
• pybind11-specific type transformations (e.g. iterator -> typing.Iterator)

[virtuald]

FWIW, I like the smallness of this dependency. Just copy a single file to a repo and we're good to go. :)

[sizmailov]

Finally I've managed to make some progress here (see https://github.com/sizmailov/mypy/tree/enhance-stubgenc-pybind-compatibility).

Hopefully I'll be able to split mentioned branch into a couple of PRs and make it's way to official mypy repo.

I'll keep this issue update along the progress with PRs. Comments/reviews as always are very welcome.

[sizmailov]

First PR is merged 🎉 python/mypy#9877
A bit more is on the way.
With those two stubgen will be dangerously really close to pybind11-stubgen output :)

[hiaselhans]

thanks for the good work @sizmailov !! :)

[allanleal]

Great work. Please keep it on!

[varunsh-xilinx]

@sizmailov are you also planning on contributing your docstring parsing? Currently, the stubs from mypy don't have docstrings and there's an open issue suggesting it could be an added option.