tentative solution for #896

Author: Laurent Mutricy

pandas-stubs/core/frame.pyi

@@ -272,13 +272,22 @@ class DataFrame(NDFrame, OpsMixin):
     def dot(self, other: Series) -> Series: ...
     def __matmul__(self, other): ...
     def __rmatmul__(self, other): ...
+    @overload
+    @classmethod
+    def from_dict(
+        cls,
+        data: dict[Any, Any],
+        orient: Literal["index"] = ...,
+        dtype: AstypeArg | None = ...,
+        columns: Axes | None = ...,
+    ) -> DataFrame: ...
+    @overload
     @classmethod
     def from_dict(
         cls,
         data: dict[Any, Any],
-        orient: Literal["columns", "index", "tight"] = ...,
-        dtype: _str = ...,
-        columns: list[_str] = ...,
+        orient: Literal["columns", "tight"] = ...,
+        dtype: AstypeArg | None = ...,
     ) -> DataFrame: ...
     def to_numpy(
         self,

tests/test_frame.py

@@ -1457,6 +1457,19 @@ def test_types_from_dict() -> None:
         },
         orient="tight",
     )
+    # added following #896
+    data = {"l1": [1, 2, 3], "l2": [4, 5, 6]}
+    # testing `dtype`
+    pd.DataFrame.from_dict(data, orient="index", dtype="float")
+    pd.DataFrame.from_dict(data, orient="index", dtype=float)
+    pd.DataFrame.from_dict(data, orient="index", dtype=None)
+    # testing `columns`
+    pd.DataFrame.from_dict(data, orient="index", columns=["a", "b", "c"])
+    pd.DataFrame.from_dict(
+        data, orient="index", columns=[1.0, 2, datetime.datetime.now()]
+    )
+    # with pytest.raises(ValueError):
+    #     pd.DataFrame.from_dict(data, orient='columns', columns=['a', 'b', 'c'])
 
 
 def test_pipe() -> None: