use crate::commands::WholeStreamCommand; use crate::prelude::*; use indexmap::indexmap; use nu_errors::ShellError; use nu_protocol::{ReturnSuccess, Signature, SyntaxShape, UntaggedValue, Value}; use nu_source::Tagged; pub struct GroupBy; #[derive(Deserialize)] pub struct GroupByArgs { column_name: Option>, } #[async_trait] impl WholeStreamCommand for GroupBy { fn name(&self) -> &str { "group-by" } fn signature(&self) -> Signature { Signature::build("group-by").optional( "column_name", SyntaxShape::String, "the name of the column to group by", ) } fn usage(&self) -> &str { "Creates a new table with the data from the table rows grouped by the column given." } async fn run( &self, args: CommandArgs, registry: &CommandRegistry, ) -> Result { group_by(args, registry).await } fn examples(&self) -> Vec { vec![ Example { description: "Group items by type", example: r#"ls | group-by type"#, result: None, }, Example { description: "Group items by their value", example: "echo [1 3 1 3 2 1 1] | group-by", result: Some(vec![UntaggedValue::row(indexmap! { "1".to_string() => UntaggedValue::Table(vec![ UntaggedValue::int(1).into(), UntaggedValue::int(1).into(), UntaggedValue::int(1).into(), UntaggedValue::int(1).into(), ]).into(), "3".to_string() => UntaggedValue::Table(vec![ UntaggedValue::int(3).into(), UntaggedValue::int(3).into(), ]).into(), "2".to_string() => UntaggedValue::Table(vec![ UntaggedValue::int(2).into(), ]).into(), }) .into()]), }, ] } } pub async fn group_by( args: CommandArgs, registry: &CommandRegistry, ) -> Result { let registry = registry.clone(); let name = args.call_info.name_tag.clone(); let (GroupByArgs { column_name }, input) = args.process(®istry).await?; let values: Vec = input.collect().await; if values.is_empty() { Err(ShellError::labeled_error( "Expected table from pipeline", "requires a table input", name, )) } else { match crate::utils::data::group(column_name, &values, None, &name) { Ok(grouped) => Ok(OutputStream::one(ReturnSuccess::value(grouped))), Err(err) => Err(err), } } } pub fn group( column_name: &Tagged, values: Vec, tag: impl Into, ) -> Result { crate::utils::data::group(Some(column_name.clone()), &values, None, tag) } #[cfg(test)] mod tests { use crate::commands::group_by::group; use indexmap::IndexMap; use nu_errors::ShellError; use nu_protocol::{UntaggedValue, Value}; use nu_source::*; fn string(input: impl Into) -> Value { UntaggedValue::string(input.into()).into_untagged_value() } fn row(entries: IndexMap) -> Value { UntaggedValue::row(entries).into_untagged_value() } fn table(list: &[Value]) -> Value { UntaggedValue::table(list).into_untagged_value() } fn nu_releases_commiters() -> Vec { vec![ row( indexmap! {"name".into() => string("AR"), "country".into() => string("EC"), "date".into() => string("August 23-2019")}, ), row( indexmap! {"name".into() => string("JT"), "country".into() => string("NZ"), "date".into() => string("August 23-2019")}, ), row( indexmap! {"name".into() => string("YK"), "country".into() => string("US"), "date".into() => string("October 10-2019")}, ), row( indexmap! {"name".into() => string("AR"), "country".into() => string("EC"), "date".into() => string("Sept 24-2019")}, ), row( indexmap! {"name".into() => string("JT"), "country".into() => string("NZ"), "date".into() => string("October 10-2019")}, ), row( indexmap! {"name".into() => string("YK"), "country".into() => string("US"), "date".into() => string("Sept 24-2019")}, ), row( indexmap! {"name".into() => string("AR"), "country".into() => string("EC"), "date".into() => string("October 10-2019")}, ), row( indexmap! {"name".into() => string("JT"), "country".into() => string("NZ"), "date".into() => string("Sept 24-2019")}, ), row( indexmap! {"name".into() => string("YK"), "country".into() => string("US"), "date".into() => string("August 23-2019")}, ), ] } #[test] fn groups_table_by_date_column() -> Result<(), ShellError> { let for_key = String::from("date").tagged_unknown(); assert_eq!( group(&for_key, nu_releases_commiters(), Tag::unknown())?, row(indexmap! { "August 23-2019".into() => table(&[ row(indexmap!{"name".into() => string("AR"), "country".into() => string("EC"), "date".into() => string("August 23-2019")}), row(indexmap!{"name".into() => string("JT"), "country".into() => string("NZ"), "date".into() => string("August 23-2019")}), row(indexmap!{"name".into() => string("YK"), "country".into() => string("US"), "date".into() => string("August 23-2019")}) ]), "October 10-2019".into() => table(&[ row(indexmap!{"name".into() => string("YK"), "country".into() => string("US"), "date".into() => string("October 10-2019")}), row(indexmap!{"name".into() => string("JT"), "country".into() => string("NZ"), "date".into() => string("October 10-2019")}), row(indexmap!{"name".into() => string("AR"), "country".into() => string("EC"), "date".into() => string("October 10-2019")}) ]), "Sept 24-2019".into() => table(&[ row(indexmap!{"name".into() => string("AR"), "country".into() => string("EC"), "date".into() => string("Sept 24-2019")}), row(indexmap!{"name".into() => string("YK"), "country".into() => string("US"), "date".into() => string("Sept 24-2019")}), row(indexmap!{"name".into() => string("JT"), "country".into() => string("NZ"), "date".into() => string("Sept 24-2019")}) ]), }) ); Ok(()) } #[test] fn groups_table_by_country_column() -> Result<(), ShellError> { let for_key = String::from("country").tagged_unknown(); assert_eq!( group(&for_key, nu_releases_commiters(), Tag::unknown())?, row(indexmap! { "EC".into() => table(&[ row(indexmap!{"name".into() => string("AR"), "country".into() => string("EC"), "date".into() => string("August 23-2019")}), row(indexmap!{"name".into() => string("AR"), "country".into() => string("EC"), "date".into() => string("Sept 24-2019")}), row(indexmap!{"name".into() => string("AR"), "country".into() => string("EC"), "date".into() => string("October 10-2019")}) ]), "NZ".into() => table(&[ row(indexmap!{"name".into() => string("JT"), "country".into() => string("NZ"), "date".into() => string("August 23-2019")}), row(indexmap!{"name".into() => string("JT"), "country".into() => string("NZ"), "date".into() => string("October 10-2019")}), row(indexmap!{"name".into() => string("JT"), "country".into() => string("NZ"), "date".into() => string("Sept 24-2019")}) ]), "US".into() => table(&[ row(indexmap!{"name".into() => string("YK"), "country".into() => string("US"), "date".into() => string("October 10-2019")}), row(indexmap!{"name".into() => string("YK"), "country".into() => string("US"), "date".into() => string("Sept 24-2019")}), row(indexmap!{"name".into() => string("YK"), "country".into() => string("US"), "date".into() => string("August 23-2019")}), ]), }) ); Ok(()) } #[test] fn examples_work_as_expected() { use super::GroupBy; use crate::examples::test as test_examples; test_examples(GroupBy {}) } }