Type DataFrame methods: __dataframe__, first, last, asfreq, where (#1470)

* Type `DataFrame` methods: `__dataframe__`, `first`, `last`, `asfreq`,
`where`

* remove deprecated dataframe protocol

Author: MarcoGorelli

pandas-stubs/api/interchange/__init__.pyi

@@ -1,2 +1 @@
-from pandas.core.interchange.dataframe_protocol import DataFrame as DataFrame
 from pandas.core.interchange.from_dataframe import from_dataframe as from_dataframe

pandas-stubs/core/frame.pyi

@@ -54,7 +54,6 @@ from pandas.core.indexing import (
     _IndexSliceTuple,
     _LocIndexer,
 )
-from pandas.core.interchange.dataframe_protocol import DataFrame as DataFrameXchg
 from pandas.core.reshape.pivot import (
     _PivotTableColumnsTypes,
     _PivotTableIndexTypes,
@@ -382,24 +381,21 @@ class DataFrame(NDFrame, OpsMixin, _GetItemHack):
             | dict[Any, Any]
             | Iterable[ListLikeU | tuple[Hashable, ListLikeU] | dict[Any, Any]]
             | None
-        ) = ...,
-        index: Axes | None = ...,
-        columns: Axes | None = ...,
-        dtype=...,
-        copy: _bool = ...,
+        ) = None,
+        index: Axes | None = None,
+        columns: Axes | None = None,
+        dtype: Dtype | None = None,
+        copy: _bool | None = None,
     ) -> Self: ...
     @overload
     def __new__(
         cls,
         data: Scalar,
         index: Axes,
         columns: Axes,
-        dtype=...,
-        copy: _bool = ...,
+        dtype: Dtype | None = None,
+        copy: _bool | None = None,
     ) -> Self: ...
-    def __dataframe__(
-        self, nan_as_null: bool = ..., allow_copy: bool = ...
-    ) -> DataFrameXchg: ...
     def __arrow_c_stream__(self, requested_schema: object | None = None) -> object: ...
     @property
     def axes(self) -> list[Index]: ...
@@ -1852,7 +1848,7 @@ class DataFrame(NDFrame, OpsMixin, _GetItemHack):
     @final
     def asfreq(
         self,
-        freq,
+        freq: Frequency,
         method: FillnaOptions | None = None,
         how: Literal["start", "end"] | None = ...,
         normalize: _bool = False,
@@ -2069,8 +2065,6 @@ class DataFrame(NDFrame, OpsMixin, _GetItemHack):
         axis: Axis | None = None,
     ) -> Self: ...
     @final
-    def first(self, offset) -> Self: ...
-    @final
     def first_valid_index(self) -> Scalar: ...
     def floordiv(
         self,
@@ -2133,8 +2127,6 @@ class DataFrame(NDFrame, OpsMixin, _GetItemHack):
         **kwargs: Any,
     ) -> Series: ...
     @final
-    def last(self, offset) -> Self: ...
-    @final
     def last_valid_index(self) -> Scalar: ...
     def le(self, other, axis: Axis = "columns", level: Level | None = ...) -> Self: ...
     def lt(self, other, axis: Axis = "columns", level: Level | None = ...) -> Self: ...
@@ -2605,7 +2597,7 @@ class DataFrame(NDFrame, OpsMixin, _GetItemHack):
             | Callable[[DataFrame], DataFrame]
             | Callable[[Any], _bool]
         ),
-        other=...,
+        other: Scalar | Self | Callable[..., Scalar | Self] = ...,
         *,
         inplace: Literal[True],
         axis: Axis | None = ...,
@@ -2621,7 +2613,7 @@ class DataFrame(NDFrame, OpsMixin, _GetItemHack):
             | Callable[[DataFrame], DataFrame]
             | Callable[[Any], _bool]
         ),
-        other=...,
+        other: Scalar | Self | Callable[..., Scalar | Self] = ...,
         *,
         inplace: Literal[False] = False,
         axis: Axis | None = ...,