Repository: nushell/nushell
File: crates/nu-command/src/filters/prepend.rs (Rust)

Code before:
                SyntaxShape::Any,
                "The row, list, or table to prepend.",
            )
            .category(Category::Filters)
    }

    fn description(&self) -> &str {
        "Prepend any number of rows to a table."
    }

    fn extra_description(&self) -> &str {
        r#"Be aware that this command 'unwraps' lists passed to it. So, if you pass a variable to it,
and you want the variable's contents to be prepended without being unwrapped, it's wise to
pre-emptively wrap the variable in a list, like so: `prepend [$val]`. This way, `prepend` will
only unwrap the outer list, and leave the variable's contents untouched."#
    }

    fn search_terms(&self) -> Vec<&str> {
        vec!["add", "concatenate"]
    }

    fn examples(&self) -> Vec<Example<'_>> {
        vec![
            Example {
                example: "0 | prepend [1 2 3]",
                description: "prepend a list to an item.",
                result: Some(Value::test_list(vec![
                    Value::test_int(1),
                    Value::test_int(2),
                    Value::test_int(3),
                    Value::test_int(0),
                ])),
            },
            Example {
                example: r#""a" | prepend ["b"] "#,
                description: "Prepend a list of strings to a string.",
                result: Some(Value::test_list(vec![
                    Value::test_string("b"),
                    Value::test_string("a"),
                ])),
            },
            Example {
                example: "[1 2 3 4] | prepend 0",
                description: "Prepend one int item.",
                result: Some(Value::test_list(vec![
                    Value::test_int(0),
                    Value::test_int(1),
                    Value::test_int(2),
                    Value::test_int(3),
                    Value::test_int(4),
                ])),

Review comment (suggestion):
```suggestion
                description: "Prepend a list to an item.",
```

Code after:
                SyntaxShape::Any,
                "The row, list, or table to prepend.",
            )
            .category(Category::Filters)
    }

    fn description(&self) -> &str {
        "Prepend any number of rows to a table."
    }

    fn extra_description(&self) -> &str {
        r#"Be aware that this command 'unwraps' lists passed to it. So, if you pass a variable to it,
and you want the variable's contents to be prepended without being unwrapped, it's wise to
pre-emptively wrap the variable in a list, like so: `prepend [$val]`. This way, `prepend` will
only unwrap the outer list, and leave the variable's contents untouched."#
    }

    fn search_terms(&self) -> Vec<&str> {
        vec!["add", "concatenate"]
    }

    fn examples(&self) -> Vec<Example<'_>> {
        vec![
            Example {
                example: "0 | prepend [1 2 3]",
                description: "Prepend a list to an item.",
                result: Some(Value::test_list(vec![
                    Value::test_int(1),
                    Value::test_int(2),
                    Value::test_int(3),
                    Value::test_int(0),
                ])),
            },
            Example {
                example: r#""a" | prepend ["b"] "#,
                description: "Prepend a list of strings to a string.",
                result: Some(Value::test_list(vec![
                    Value::test_string("b"),
                    Value::test_string("a"),
                ])),
            },
            Example {
                example: "[1 2 3 4] | prepend 0",
                description: "Prepend one int item.",
                result: Some(Value::test_list(vec![
                    Value::test_int(0),
                    Value::test_int(1),
                    Value::test_int(2),
                    Value::test_int(3),
                    Value::test_int(4),
                ])),