use super::super::values::{Column, NuDataFrame}; use nu_engine::CallExt; use nu_protocol::{ ast::Call, engine::{Command, EngineState, Stack}, Category, Example, PipelineData, ShellError, Signature, Span, SyntaxShape, Type, Value, }; #[derive(Clone)] pub struct FirstDF; impl Command for FirstDF { fn name(&self) -> &str { "first" } fn usage(&self) -> &str { "Show only the first number of rows." } fn signature(&self) -> Signature { Signature::build(self.name()) .optional( "rows", SyntaxShape::Int, "starting from the front, the number of rows to return", ) .input_type(Type::Custom("dataframe".into())) .output_type(Type::Custom("dataframe".into())) .category(Category::Custom("dataframe".into())) } fn examples(&self) -> Vec { vec![ Example { description: "Return the first row of a dataframe", example: "[[a b]; [1 2] [3 4]] | into df | first", result: Some( NuDataFrame::try_from_columns(vec![ Column::new("a".to_string(), vec![Value::test_int(1)]), Column::new("b".to_string(), vec![Value::test_int(2)]), ]) .expect("should not fail") .into_value(Span::test_data()), ), }, Example { description: "Return the first two rows of a dataframe", example: "[[a b]; [1 2] [3 4]] | into df | first 2", result: Some( NuDataFrame::try_from_columns(vec![ Column::new( "a".to_string(), vec![Value::test_int(1), Value::test_int(3)], ), Column::new( "b".to_string(), vec![Value::test_int(2), Value::test_int(4)], ), ]) .expect("should not fail") .into_value(Span::test_data()), ), }, ] } fn run( &self, engine_state: &EngineState, stack: &mut Stack, call: &Call, input: PipelineData, ) -> Result { let df = NuDataFrame::try_from_pipeline(input, call.head)?; command(engine_state, stack, call, df) } } fn command( engine_state: &EngineState, stack: &mut Stack, call: &Call, df: NuDataFrame, ) -> Result { let rows: Option = call.opt(engine_state, stack, 0)?; let rows = rows.unwrap_or(1); let res = df.as_ref().head(Some(rows)); Ok(PipelineData::Value( NuDataFrame::dataframe_into_value(res, call.head), None, )) } #[cfg(test)] mod test { use super::super::super::test_dataframe::test_dataframe; use super::*; #[test] fn test_examples() { test_dataframe(vec![Box::new(FirstDF {})]) } }