type freq in shift

Author: MarcoGorelli

pandas-stubs/core/frame.pyi

@@ -84,6 +84,7 @@ from pandas._typing import (
     FilePath,
     FillnaOptions,
     FormattersType,
+    Frequency,
     GroupByObjectNonScalar,
     HashableT,
     HashableT1,
@@ -855,7 +856,7 @@ class DataFrame(NDFrame, OpsMixin, _GetItemHack):
     def shift(
         self,
         periods: int = ...,
-        freq=...,
+        freq: Frequency | dt.timedelta | None = ...,
         axis: Axis = ...,
         fill_value: Hashable | None = ...,
     ) -> Self: ...

pandas-stubs/core/series.pyi

@@ -119,6 +119,7 @@ from pandas._typing import (
     FilePath,
     FillnaOptions,
     FloatDtypeArg,
+    Frequency,
     GroupByObjectNonScalar,
     HashableT1,
     IgnoreRaise,
@@ -1219,7 +1220,7 @@ class Series(IndexOpsMixin[S1], NDFrame):
     def shift(
         self,
         periods: int = ...,
-        freq=...,
+        freq: Frequency | timedelta | None = ...,
         axis: AxisIndex = ...,
         fill_value: object | None = ...,
     ) -> Series[S1]: ...

tests/test_frame.py

@@ -516,10 +516,13 @@ def test_types_sort_values_with_key() -> None:
 
 
 def test_types_shift() -> None:
-    df = pd.DataFrame(data={"col1": [1, 1], "col2": [3, 4]})
+    df = pd.DataFrame(
+        data={"col1": [1, 1], "col2": [3, 4]}, index=pd.date_range("2020", periods=2)
+    )
     df.shift()
     df.shift(1)
     df.shift(-1)
+    df.shift(freq="1D")
 
 
 def test_types_rank() -> None:

tests/test_series.py

@@ -416,10 +416,11 @@ def test_types_sort_values_with_key() -> None:
 
 
 def test_types_shift() -> None:
-    s = pd.Series([1, 2, 3])
+    s = pd.Series([1, 2, 3], index=pd.date_range("2020", periods=3))
     s.shift()
     s.shift(axis=0, periods=1)
     s.shift(-1, fill_value=0)
+    s.shift(freq="1D")
 
 
 def test_types_rank() -> None: