dataframe_from_dict -> dataframe_from_columns (#276)

Author: MarcoGorelli

spec/API_specification/dataframe_api/__init__.py

@@ -20,7 +20,7 @@
     "column_from_sequence",
     "column_from_1d_array",
     "concat",
-    "dataframe_from_dict",
+    "dataframe_from_columns",
     "dataframe_from_2d_array",
     "is_null",
     "null",
@@ -91,27 +91,20 @@ def column_from_sequence(sequence: Sequence[Any], *, dtype: DType, name: str = '
     """
     ...
 
-def dataframe_from_dict(data: Mapping[str, Column]) -> DataFrame:
+def dataframe_from_columns(*columns: Column) -> DataFrame:
     """
-    Construct DataFrame from map of column names to Columns.
+    Construct DataFrame from sequence of Columns.
 
     Parameters
     ----------
-    data : Mapping[str, Column]
-        Column must be of the corresponding type of the DataFrame.
+    columns : Column
+        Column(s) must be of the corresponding type of the DataFrame.
         For example, it is only supported to build a ``LibraryXDataFrame`` using
         ``LibraryXColumn`` instances.
 
     Returns
     -------
     DataFrame
-    
-    Raises
-    ------
-    ValueError
-        If any of the columns already has a name, and the corresponding key
-        in `data` doesn't match.
-
     """
     ...
 

spec/API_specification/dataframe_api/typing.py

@@ -118,9 +118,7 @@ def column_from_sequence(
         ...
 
     @staticmethod
-    def dataframe_from_dict(
-        data: Mapping[str, Column]
-    ) -> DataFrame:
+    def dataframe_from_columns(*columns: Column) -> DataFrame:
         ...
 
     @staticmethod

spec/API_specification/examples/02_plotting.py

@@ -20,7 +20,9 @@ def group_by_and_plot(
 
     namespace = x.__column_namespace__()
 
-    df = namespace.dataframe_from_dict({"x": x, "y": y, "color": color})
+    df = namespace.dataframe_from_columns(
+        x.rename('x'), y.rename('y'), color.rename('color')
+    )
 
     agg = df.group_by("color").mean()
     x = agg.get_column_by_name("x").to_array_object(namespace.Float64())

spec/API_specification/index.rst

@@ -34,7 +34,7 @@ of objects and functions in the top-level namespace. The latter are:
    is_dtype
    column_from_sequence
    column_from_1d_array
-   dataframe_from_dict
+   dataframe_from_columns
    dataframe_from_2d_array
 
 The ``DataFrame``, ``Column`` and ``GroupBy`` objects have the following