Docs

Author: jdunkerley

distribution/lib/Standard/Table/0.0.0-dev/docs/api/Set_Mode.md

@@ -4,3 +4,10 @@
     - Add
     - Add_Or_Update
     - Update
+- type Set_Mode_Many
+    - Add as:Standard.Base.Data.Text.Text=
+    - Add_Or_Update as:Standard.Base.Data.Text.Text=
+    - Update
+    - as_value self -> Standard.Base.Any.Any
+- Standard.Table.Set_Mode.Set_Mode.from that:Standard.Table.Set_Mode.Set_Mode_Many -> Standard.Table.Set_Mode.Set_Mode
+- Standard.Table.Set_Mode.Set_Mode_Many.from that:Standard.Table.Set_Mode.Set_Mode -> Standard.Table.Set_Mode.Set_Mode_Many

distribution/lib/Standard/Table/0.0.0-dev/docs/api/Table.md

@@ -0,0 +1,16 @@
+## Enso Signatures 1.0
+## module Standard.Table.Table_Selector
+- type Table_Selector
+    - By_Type by_type:Standard.Table.Value_Type.By_Type
+    - Index index:Standard.Base.Data.Numbers.Integer
+    - Name name:Standard.Base.Data.Text.Text
+    - Regex pattern:Standard.Base.Data.Text.Regex.Regex
+    - Vector selectors:(Standard.Base.Data.Vector.Vector Standard.Table.Table_Selector.Table_Selector)
+    - act_if_any self table:Standard.Table.Table.Table error_on_missing_columns:Standard.Base.Data.Boolean.Boolean action:Standard.Base.Any.Any -> Standard.Base.Any.Any
+    - resolve self table:Standard.Table.Table.Table error_on_missing_columns:Standard.Base.Data.Boolean.Boolean -> Standard.Base.Any.Any
+- Standard.Table.Table_Selector.Table_Selector.from that:Standard.Base.Data.Text.Text -> Standard.Table.Table_Selector.Table_Selector
+- Standard.Table.Table_Selector.Table_Selector.from that:Standard.Base.Data.Numbers.Integer -> Standard.Table.Table_Selector.Table_Selector
+- Standard.Table.Table_Selector.Table_Selector.from that:Standard.Base.Data.Text.Regex.Regex -> Standard.Table.Table_Selector.Table_Selector
+- Standard.Table.Table_Selector.Table_Selector.from that:Standard.Table.Value_Type.By_Type -> Standard.Table.Table_Selector.Table_Selector
+- Standard.Table.Table_Selector.Table_Selector.from that:Standard.Base.Function.Function -> Standard.Table.Table_Selector.Table_Selector
+- Standard.Table.Table_Selector.Table_Selector.from that:Standard.Base.Data.Vector.Vector -> Standard.Table.Table_Selector.Table_Selector

distribution/lib/Standard/Table/0.0.0-dev/docs/api/Table_Selector.md

@@ -1,3 +1,5 @@
+from Standard.Base import Text
+
 type Set_Mode
     ## Add a new column to the table.
        If already present an `Existing_Column` error is returned.
@@ -9,3 +11,34 @@ type Set_Mode
 
     ## Add the column to the table if not present, or update if present.
     Add_Or_Update
+
+type Set_Mode_Many
+    ## Update the column in the table.
+       If not present a `Missing_Column` error is returned.
+    Update
+
+    ## Add a new column to the table.
+       If already present an `Existing_Column` error is returned.
+    Add as:Text="New {{Column}}"
+
+    ## Add the column to the table if not present, or update if present.
+    Add_Or_Update as:Text="New {{Column}}"
+
+    ## ---
+       private: true
+       ---
+       Get the `as` value associated with the Set_Mode_Many variant.
+    as_value self = case self of
+        Set_Mode_Many.Update -> "{{Column}}"
+        Set_Mode_Many.Add as -> as
+        Set_Mode_Many.Add_Or_Update as -> as
+
+Set_Mode.from (that:Set_Mode_Many) = case that of
+    Set_Mode_Many.Update -> Set_Mode.Update
+    Set_Mode_Many.Add _ -> Set_Mode.Add
+    Set_Mode_Many.Add_Or_Update _ -> Set_Mode.Add_Or_Update
+
+Set_Mode_Many.from (that:Set_Mode) = case that of
+    Set_Mode.Add -> Set_Mode_Many.Add
+    Set_Mode.Update -> Set_Mode_Many.Update
+    Set_Mode.Add_Or_Update -> Set_Mode_Many.Add_Or_Update

distribution/lib/Standard/Table/0.0.0-dev/src/Set_Mode.enso

@@ -51,6 +51,7 @@ import project.Row.Row
 import project.Row_Limit.Row_Limit
 import project.Rows_To_Read.Rows_To_Read
 import project.Set_Mode.Set_Mode
+import project.Set_Mode.Set_Mode_Many
 import project.Simple_Expression.Simple_Expression
 import project.Sort_Column.Sort_Column
 import project.Table_Selector.Table_Selector
@@ -2618,6 +2619,46 @@ type Table
     set self (value : Text | Expression | Column | Constant_Column | Simple_Expression = Missing_Argument.throw "value") as:Text="" set_mode:Set_Mode=..Add_Or_Update on_problems:Problem_Behavior=..Report_Warning -> Table & Any ! Existing_Column | Missing_Column | No_Such_Column | Expression_Error =
         self.implementation.set self.underlying value as set_mode on_problems
 
+
+    ## ---
+       private: true
+       ---
+       Adds or updates multiple columns on the table.
+
+       All calculation are performed based on the original table, so that the
+       order of setting columns does not matter.
+
+       ## Arguments
+        - `columns`: The columns to set.
+        - `value`: The expression to create columns. Use `{{Column}}` as a
+          placeholder for the current column.
+        - `set_mode`: Specifies the expected behaviour in regards to existing
+          columns with the same name.
+          - `as`: If not in `Update` mode, the naming pattern for the new
+             columns. Use `{{Column}}` as a placeholder for the current column
+             name.
+        - `error_on_missing_columns`: If `True`, an error is raised if a
+          specified column is not found. If `False`, the missing column is
+          ignored.
+        - `on_problems`: Specifies how to handle problems with expression
+          evaluation.
+
+        ## Returns
+        - Returns the updated Table along with the newly created or updated
+          columns.
+    @columns (Widget_Helpers.make_column_name_multi_selector add_regex=True add_by_type=True)
+    set_many self (columns : Table_Selector = Missing_Argument.throw "columns") (value : Text = Missing_Argument.throw "value") set_mode:Set_Mode_Many=..Update error_on_missing_columns:Boolean=True on_problems:Problem_Behavior=..Report_Warning -> Table & Any ! Existing_Column | Missing_Column | No_Such_Column | Expression_Error =
+        col_name = self.make_temp_column_name
+        as = set_mode.as_value
+        value_expr = Expression.Value (value.replace "{{Column}}" "["+col_name+"]")
+        columns.act_if_any self error_on_missing_columns selected->
+            new_columns = selected.map column_name->
+                as_name = as.replace "{{Column}}" column_name
+                column = self.at column_name
+                result = self.set column col_name . set value_expr as_name on_problems=on_problems
+                result.at as_name
+            new_columns.fold self current->new-> current.set new new.name set_mode
+
     ## ---
        private: true
        ---

distribution/lib/Standard/Table/0.0.0-dev/src/Table.enso

@@ -29,9 +29,10 @@ type Table_Selector
                 Table_Selector.Index i -> i
                 Table_Selector.Regex r -> r
                 Table_Selector.By_Type bt -> bt
-            matched = table.select_columns flatten error_on_missing_columns=error_on_missing_columns on_problems=..Ignore . column_names
-            if error_on_missing_columns then matched else
-                matched.catch No_Output_Columns _->[]
+            if flatten.length == 0 then [] else
+                matched = table.select_columns flatten error_on_missing_columns=error_on_missing_columns on_problems=..Ignore . column_names
+                if error_on_missing_columns then matched else
+                    matched.catch No_Output_Columns _->[]
         _ -> Table_Selector.Vector [self] . resolve table error_on_missing_columns
 
     ## ---
@@ -51,6 +52,9 @@ Table_Selector.from (that:Regex) = Table_Selector.Regex that
 
 Table_Selector.from (that:By_Type) = Table_Selector.By_Type that
 
+Table_Selector.from (that:Function) =
+    Table_Selector.from (that:By_Type)
+
 Table_Selector.from (that:Vector) =
     selectors = that.map v-> v.to Table_Selector
     Table_Selector.Vector selectors