use crate::command_registry::CommandRegistry; use crate::commands::WholeStreamCommand; use crate::prelude::*; use nu_errors::ShellError; use nu_protocol::{Signature, SyntaxShape, UntaggedValue}; use nu_source::Tagged; pub struct First; #[derive(Deserialize)] pub struct FirstArgs { rows: Option>, } #[async_trait] impl WholeStreamCommand for First { fn name(&self) -> &str { "first" } fn signature(&self) -> Signature { Signature::build("first").optional( "rows", SyntaxShape::Int, "starting from the front, the number of rows to return", ) } fn usage(&self) -> &str { "Show only the first number of rows." } async fn run( &self, args: CommandArgs, registry: &CommandRegistry, ) -> Result { first(args, registry).await } fn examples(&self) -> Vec { vec![ Example { description: "Return the first item of a list/table", example: "echo [1 2 3] | first", result: Some(vec![UntaggedValue::int(1).into()]), }, Example { description: "Return the first 2 items of a list/table", example: "echo [1 2 3] | first 2", result: Some(vec![ UntaggedValue::int(1).into(), UntaggedValue::int(2).into(), ]), }, ] } } async fn first(args: CommandArgs, registry: &CommandRegistry) -> Result { let registry = registry.clone(); let (FirstArgs { rows }, input) = args.process(®istry).await?; let rows_desired = if let Some(quantity) = rows { *quantity } else { 1 }; Ok(input.take(rows_desired).to_output_stream()) } #[cfg(test)] mod tests { use super::First; #[test] fn examples_work_as_expected() { use crate::examples::test as test_examples; test_examples(First {}) } }