group-by command examples and notes

You can also output a table instead of a record ```nu > ['1' '3' '1' '3' '2' '1' '1'] | group-by --to-table ╭───┬───────┬───────────╮ │ # │ group │ items │ ├───┼───────┼───────────┤ │ 0 │ 1 │ ╭───┬───╮ │ │ │ │ │ 0 │ 1 │ │ │ │ │ │ 1 │ 1 │ │ │ │ │ │ 2 │ 1 │ │ │ │ │ │ 3 │ 1 │ │ │ │ │ ╰───┴───╯ │ │ 1 │ 3 │ ╭───┬───╮ │ │ │ │ │ 0 │ 3 │ │ │ │ │ │ 1 │ 3 │ │ │ │ │ ╰───┴───╯ │ │ 2 │ 2 │ ╭───┬───╮ │ │ │ │ │ 0 │ 2 │ │ │ │ │ ╰───┴───╯ │ ╰───┴───────┴───────────╯ ``` Group bools, whether they are strings or actual bools ```nu > [true "true" false "false"] | group-by ╭───────┬───────────────╮ │ │ ╭───┬──────╮ │ │ true │ │ 0 │ true │ │ │ │ │ 1 │ true │ │ │ │ ╰───┴──────╯ │ │ │ ╭───┬───────╮ │ │ false │ │ 0 │ false │ │ │ │ │ 1 │ false │ │ │ │ ╰───┴───────╯ │ ╰───────┴───────────────╯ ``` Group items by multiple columns' values ```nu > [ [name, lang, year]; [andres, rb, "2019"], [jt, rs, "2019"], [storm, rs, "2021"] ] | group-by lang year ╭────┬─────────────────────────────────────────╮ │ │ ╭──────┬──────────────────────────────╮ │ │ rb │ │ │ ╭───┬────────┬──────┬──────╮ │ │ │ │ │ 2019 │ │ # │ name │ lang │ year │ │ │ │ │ │ │ ├───┼────────┼──────┼──────┤ │ │ │ │ │ │ │ 0 │ andres │ rb │ 2019 │ │ │ │ │ │ │ ╰───┴────────┴──────┴──────╯ │ │ │ │ ╰──────┴──────────────────────────────╯ │ │ │ ╭──────┬─────────────────────────────╮ │ │ rs │ │ │ ╭───┬──────┬──────┬──────╮ │ │ │ │ │ 2019 │ │ # │ name │ lang │ year │ │ │ │ │ │ │ ├───┼──────┼──────┼──────┤ │ │ │ │ │ │ │ 0 │ jt │ rs │ 2019 │ │ │ │ │ │ │ ╰───┴──────┴──────┴──────╯ │ │ │ │ │ │ ╭───┬───────┬──────┬──────╮ │ │ │ │ │ 2021 │ │ # │ name │ lang │ year │ │ │ │ │ │ │ ├───┼───────┼──────┼──────┤ │ │ │ │ │ │ │ 0 │ storm │ rs │ 2021 │ │ │ │ │ │ │ ╰───┴───────┴──────┴──────╯ │ │ │ │ ╰──────┴─────────────────────────────╯ │ ╰────┴─────────────────────────────────────────╯ ``` Group items by multiple columns' values ```nu > [ [name, lang, year]; [andres, rb, "2019"], [jt, rs, "2019"], [storm, rs, "2021"] ] | group-by lang year --to-table ╭───┬──────┬──────┬──────────────────────────────╮ │ # │ lang │ year │ items │ ├───┼──────┼──────┼──────────────────────────────┤ │ 0 │ rb │ 2019 │ ╭───┬────────┬──────┬──────╮ │ │ │ │ │ │ # │ name │ lang │ year │ │ │ │ │ │ ├───┼────────┼──────┼──────┤ │ │ │ │ │ │ 0 │ andres │ rb │ 2019 │ │ │ │ │ │ ╰───┴────────┴──────┴──────╯ │ │ 1 │ rs │ 2019 │ ╭───┬──────┬──────┬──────╮ │ │ │ │ │ │ # │ name │ lang │ year │ │ │ │ │ │ ├───┼──────┼──────┼──────┤ │ │ │ │ │ │ 0 │ jt │ rs │ 2019 │ │ │ │ │ │ ╰───┴──────┴──────┴──────╯ │ │ 2 │ rs │ 2021 │ ╭───┬───────┬──────┬──────╮ │ │ │ │ │ │ # │ name │ lang │ year │ │ │ │ │ │ ├───┼───────┼──────┼──────┤ │ │ │ │ │ │ 0 │ storm │ rs │ 2021 │ │ │ │ │ │ ╰───┴───────┴──────┴──────╯ │ ╰───┴──────┴──────┴──────────────────────────────╯ ``` ## Notes the group-by command makes some assumptions: - if the input data is not a string, the grouper will convert the key to string but the values will remain in their original format. e.g. with bools, "true" and true would be in the same group (see example). - datetime is formatted based on your configuration setting. use `format date` to change the format. - filesize is formatted based on your configuration setting. use `format filesize` to change the format. - some nushell values are not supported, such as closures.

This section provides more examples of using the `group-by` command, including grouping boolean values, grouping by multiple columns, and outputting results as a table. It also highlights important notes about the command's behavior, such as its string conversion for non-string input, handling of datetime and filesize formats, and limitations regarding certain NuShell values like closures.