🐴 sparse.linalg: Work around a __new__ bug in mypy

Author: jorenham

.mypyignore

@@ -1,6 +1,9 @@
 # scipy-stubs internal helper types (typecheck-only)
 scipy(\.\w+)?\._typing
 
+# https://github.com/python/mypy/issues/17251
+scipy\.sparse\.linalg(\._?interface|\.matfuncs)?\.LinearOperator\.__init__
+
 # scipy tests
 scipy\.conftest
 scipy\.((_|\w)+\.)+(__test__|test|tests(\..+)?)

scipy-stubs/sparse/linalg/_interface.pyi

@@ -170,17 +170,21 @@ class LinearOperator(Generic[_SCT_co]):
         rmatmat: _FunMatMat | None = None,
     ) -> _CustomLinearOperator[Any]: ...
 
-    #
-    @overload
-    def __init__(self, /, dtype: onp.ToDType[_SCT_co], shape: _ToShape) -> None: ...
-    @overload
-    def __init__(self: LinearOperator[np.int_], /, dtype: onp.AnyIntDType, shape: _ToShape) -> None: ...
-    @overload
-    def __init__(self: LinearOperator[np.float64], /, dtype: onp.AnyFloat64DType, shape: _ToShape) -> None: ...
-    @overload
-    def __init__(self: LinearOperator[np.complex128], /, dtype: onp.AnyComplex128DType, shape: _ToShape) -> None: ...
-    @overload
-    def __init__(self: LinearOperator[Any], /, dtype: type | str | None, shape: _ToShape) -> None: ...
+    # NOTE: the `__init__` method cannot be annotated, because it will cause mypy to `__new__`:
+    # https://github.com/python/mypy/issues/17251
+
+    # ruff: noqa: ERA001
+
+    # @overload
+    # def __init__(self, /, dtype: onp.ToDType[_SCT_co], shape: _ToShape) -> None: ...
+    # @overload
+    # def __init__(self: LinearOperator[np.int_], /, dtype: onp.AnyIntDType, shape: _ToShape) -> None: ...
+    # @overload
+    # def __init__(self: LinearOperator[np.float64], /, dtype: onp.AnyFloat64DType, shape: _ToShape) -> None: ...
+    # @overload
+    # def __init__(self: LinearOperator[np.complex128], /, dtype: onp.AnyComplex128DType, shape: _ToShape) -> None: ...
+    # @overload
+    # def __init__(self: LinearOperator[Any], /, dtype: type | str | None, shape: _ToShape) -> None: ...
 
     #
     @property