chore(comment): #1397 (comment)

Author: cmp0xff

pandas-stubs/core/indexes/base.pyi

@@ -754,7 +754,8 @@ class Index(IndexOpsMixin[S1]):
     def __mul__(self, other: np_ndarray_dt) -> Never: ...
     @overload
     def __mul__(self: Index[complex], other: np_ndarray_td) -> Never: ...
-    # pandas-dev/pandas#62524
+    # pandas-dev/pandas#62524: An index of Python native timedeltas can be
+    # produced, instead of a TimedeltaIndex, hence the overload
     @overload
     def __mul__(  # type: ignore[overload-overlap]
         self: Index[bool] | Index[int] | Index[float], other: Sequence[timedelta]
@@ -837,7 +838,8 @@ class Index(IndexOpsMixin[S1]):
     def __rmul__(self, other: np_ndarray_dt) -> Never: ...
     @overload
     def __rmul__(self: Index[complex], other: np_ndarray_td) -> Never: ...
-    # pandas-dev/pandas#62524
+    # pandas-dev/pandas#62524: An index of Python native timedeltas can be
+    # produced, instead of a TimedeltaIndex, hence the overload
     @overload
     def __rmul__(  # type: ignore[overload-overlap]
         self: Index[bool] | Index[int] | Index[float], other: Sequence[timedelta]

tests/indexes/arithmetic/int/test_mul.py

@@ -60,7 +60,8 @@ def test_mul_py_sequence(left: "pd.Index[int]") -> None:
     check(assert_type(left * c, "pd.Index[complex]"), pd.Index, np.complexfloating)
     if TYPE_CHECKING_INVALID_USAGE:
         _05 = left * s  # type: ignore[operator] # pyright: ignore[reportOperatorIssue]
-    # pandas-dev/pandas#62524
+    # pandas-dev/pandas#62524: An index of Python native timedeltas can be
+    # produced, instead of a TimedeltaIndex, hence the test
     check(assert_type(left * d, "pd.Index[pd.Timedelta]"), pd.Index, timedelta)
 
     check(assert_type(b * left, "pd.Index[int]"), pd.Index, np.integer)
@@ -69,7 +70,8 @@ def test_mul_py_sequence(left: "pd.Index[int]") -> None:
     check(assert_type(c * left, "pd.Index[complex]"), pd.Index, np.complexfloating)
     if TYPE_CHECKING_INVALID_USAGE:
         _15 = s * left  # type: ignore[operator] # pyright: ignore[reportOperatorIssue]
-    # pandas-dev/pandas#62524
+    # pandas-dev/pandas#62524: An index of Python native timedeltas can be
+    # produced, instead of a TimedeltaIndex, hence the test
     check(assert_type(d * left, "pd.Index[pd.Timedelta]"), pd.Index, timedelta)
 
 

tests/indexes/arithmetic/timedelta/test_mul.py

@@ -19,7 +19,8 @@
 @pytest.fixture
 def left() -> "pd.Index[pd.Timedelta]":
     """left operand"""
-    # pandas-dev/pandas#62524
+    # pandas-dev/pandas#62524: An index of Python native timedeltas can be
+    # produced, instead of a TimedeltaIndex, hence this test file
     lo = pd.Index([1]) * [timedelta(seconds=1)]  # left operand
     return check(assert_type(lo, "pd.Index[pd.Timedelta]"), pd.Index, timedelta)