[stubgenc] Don't render overloaded function umbrella (*args, **kwargs) signature

Overloaded function header in pybind11 was erroneously recognized as an extra overload.

Author: sizmailov

mypy/stubgenc.py

@@ -129,6 +129,11 @@ def is_c_type(obj: object) -> bool:
     return inspect.isclass(obj) or type(obj) is type(int)
 
 
+def is_pybind11_overloaded_function_docstring(docstr: str, name: str) -> bool:
+    return docstr.startswith("{}(*args, **kwargs)\n".format(name) +
+                             "Overloaded function.\n\n")
+
+
 def generate_c_function_stub(module: ModuleType,
                              name: str,
                              obj: object,
@@ -160,6 +165,9 @@ def generate_c_function_stub(module: ModuleType,
     else:
         docstr = getattr(obj, '__doc__', None)
         inferred = infer_sig_from_docstring(docstr, name)
+        if inferred and is_pybind11_overloaded_function_docstring(docstr, name):
+            # Remove pybind11 umbrella (*args, **kwargs) for overloaded functions
+            del inferred[-1]
         if not inferred:
             if class_name and name not in sigs:
                 inferred = [FunctionSig(name, args=infer_method_sig(name), ret_type=ret_type)]

test-data/stubgen/pybind11_mypy_demo/basics.pyi

@@ -48,13 +48,9 @@ class Point:
     @overload
     def __init__(self, x: float, y: float) -> None: ...
     @overload
-    def __init__(*args, **kwargs) -> Any: ...
-    @overload
     def distance_to(self, x: float, y: float) -> float: ...
     @overload
     def distance_to(self, other: Point) -> float: ...
-    @overload
-    def distance_to(*args, **kwargs) -> Any: ...
     @property
     def angle_unit(self) -> Point.AngleUnit: ...
     @angle_unit.setter