make char command const (#11771)

# Description

This PR makes the `char` command a `const` command. The only real
changes are to get the arguments different and I extracted code into
functions so they could be called via run and run_cost. No algorithms
were harmed in the making of this PR.

# User-Facing Changes
<!-- List of all changes that impact the user experience here. This
helps us keep track of breaking changes. -->

# Tests + Formatting
<!--
Don't forget to add tests that cover your changes.

Make sure you've run and fixed any issues with these commands:

- `cargo fmt --all -- --check` to check standard code formatting (`cargo
fmt --all` applies these changes)
- `cargo clippy --workspace -- -D warnings -D clippy::unwrap_used` to
check that you're using the standard code style
- `cargo test --workspace` to check that all tests pass (on Windows make
sure to [enable developer
mode](https://learn.microsoft.com/en-us/windows/apps/get-started/developer-mode-features-and-debugging))
- `cargo run -- -c "use std testing; testing run-tests --path
crates/nu-std"` to run the tests for the standard library

> **Note**
> from `nushell` you can also use the `toolkit` as follows
> ```bash
> use toolkit.nu # or use an `env_change` hook to activate it
automatically
> toolkit check pr
> ```
-->

# After Submitting
<!-- If your PR had any user-facing changes, update [the
documentation](https://github.com/nushell/nushell.github.io) after the
PR is merged, if necessary. This will help us keep the docs up to date.
-->

crates/nu-command/src/strings/char_.rs

@@ -1,13 +1,14 @@
 use indexmap::indexmap;
 use indexmap::map::IndexMap;
 use nu_engine::CallExt;
-use nu_protocol::engine::{EngineState, Stack};
+use nu_protocol::engine::{EngineState, Stack, StateWorkingSet};
 use nu_protocol::record;
 use nu_protocol::{
     ast::Call, engine::Command, Category, Example, IntoInterruptiblePipelineData, IntoPipelineData,
     PipelineData, ShellError, Signature, Span, SyntaxShape, Type, Value,
 };
 use once_cell::sync::Lazy;
+use std::sync::{atomic::AtomicBool, Arc};
 
 // Character used to separate directories in a Path Environment variable on windows is ";"
 #[cfg(target_family = "windows")]
@@ -172,6 +173,10 @@ impl Command for Char {
             .category(Category::Strings)
     }
 
+    fn is_const(&self) -> bool {
+        true
+    }
+
     fn usage(&self) -> &str {
         "Output special characters (e.g., 'newline')."
     }
@@ -217,6 +222,40 @@ impl Command for Char {
         ]
     }
 
+    fn run_const(
+        &self,
+        working_set: &StateWorkingSet,
+        call: &Call,
+        _input: PipelineData,
+    ) -> Result<PipelineData, ShellError> {
+        let call_span = call.head;
+        let list = call.has_flag_const(working_set, "list")?;
+        let integer = call.has_flag_const(working_set, "integer")?;
+        let unicode = call.has_flag_const(working_set, "unicode")?;
+        let ctrlc = working_set.permanent().ctrlc.clone();
+
+        // handle -l flag
+        if list {
+            return generate_character_list(ctrlc, call.head);
+        }
+
+        // handle -i flag
+        if integer {
+            let int_args: Vec<i64> = call.rest_const(working_set, 0)?;
+            handle_integer_flag(int_args, call, call_span)
+        }
+        // handle -u flag
+        else if unicode {
+            let string_args: Vec<String> = call.rest_const(working_set, 0)?;
+            handle_unicode_flag(string_args, call, call_span)
+        }
+        // handle the rest
+        else {
+            let string_args: Vec<String> = call.rest_const(working_set, 0)?;
+            handle_the_rest(string_args, call, call_span)
+        }
+    }
+
     fn run(
         &self,
         engine_state: &EngineState,
@@ -225,84 +264,125 @@ impl Command for Char {
         _input: PipelineData,
     ) -> Result<PipelineData, ShellError> {
         let call_span = call.head;
-        // handle -l flag
+        let list = call.has_flag(engine_state, stack, "list")?;
-        if call.has_flag(engine_state, stack, "list")? {
+        let integer = call.has_flag(engine_state, stack, "integer")?;
-            return Ok(CHAR_MAP
+        let unicode = call.has_flag(engine_state, stack, "unicode")?;
-                .iter()
+        let ctrlc = engine_state.ctrlc.clone();
-                .map(move |(name, s)| {
-                    let unicode = Value::string(
-                        s.chars()
-                            .map(|c| format!("{:x}", c as u32))
-                            .collect::<Vec<String>>()
-                            .join(" "),
-                        call_span,
-                    );
-                    let record = record! {
-                        "name" => Value::string(*name, call_span),
-                        "character" => Value::string(s, call_span),
-                        "unicode" => unicode,
-                    };
 
-                    Value::record(record, call_span)
+        // handle -l flag
-                })
+        if list {
-                .into_pipeline_data(engine_state.ctrlc.clone()));
+            return generate_character_list(ctrlc, call_span);
+        }
+
+        // handle -i flag
+        if integer {
+            let int_args: Vec<i64> = call.rest(engine_state, stack, 0)?;
+            handle_integer_flag(int_args, call, call_span)
         }
         // handle -u flag
-        if call.has_flag(engine_state, stack, "integer")? {
+        else if unicode {
-            let args: Vec<i64> = call.rest(engine_state, stack, 0)?;
+            let string_args: Vec<String> = call.rest(engine_state, stack, 0)?;
-            if args.is_empty() {
+            handle_unicode_flag(string_args, call, call_span)
-                return Err(ShellError::MissingParameter {
-                    param_name: "missing at least one unicode character".into(),
-                    span: call_span,
-                });
-            }
-            let mut multi_byte = String::new();
-            for (i, &arg) in args.iter().enumerate() {
-                let span = call
-                    .positional_nth(i)
-                    .expect("Unexpected missing argument")
-                    .span;
-                multi_byte.push(integer_to_unicode_char(arg, span)?)
-            }
-            Ok(Value::string(multi_byte, call_span).into_pipeline_data())
-        } else if call.has_flag(engine_state, stack, "unicode")? {
-            let args: Vec<String> = call.rest(engine_state, stack, 0)?;
-            if args.is_empty() {
-                return Err(ShellError::MissingParameter {
-                    param_name: "missing at least one unicode character".into(),
-                    span: call_span,
-                });
-            }
-            let mut multi_byte = String::new();
-            for (i, arg) in args.iter().enumerate() {
-                let span = call
-                    .positional_nth(i)
-                    .expect("Unexpected missing argument")
-                    .span;
-                multi_byte.push(string_to_unicode_char(arg, span)?)
-            }
-            Ok(Value::string(multi_byte, call_span).into_pipeline_data())
-        } else {
-            let args: Vec<String> = call.rest(engine_state, stack, 0)?;
-            if args.is_empty() {
-                return Err(ShellError::MissingParameter {
-                    param_name: "missing name of the character".into(),
-                    span: call_span,
-                });
-            }
-            let special_character = str_to_character(&args[0]);
-            if let Some(output) = special_character {
-                Ok(Value::string(output, call_span).into_pipeline_data())
-            } else {
-                Err(ShellError::TypeMismatch {
-                    err_message: "error finding named character".into(),
-                    span: call
-                        .positional_nth(0)
-                        .expect("Unexpected missing argument")
-                        .span,
-                })
-            }
         }
+        // handle the rest
+        else {
+            let string_args: Vec<String> = call.rest(engine_state, stack, 0)?;
+            handle_the_rest(string_args, call, call_span)
+        }
+    }
+}
+
+fn generate_character_list(
+    ctrlc: Option<Arc<AtomicBool>>,
+    call_span: Span,
+) -> Result<PipelineData, ShellError> {
+    Ok(CHAR_MAP
+        .iter()
+        .map(move |(name, s)| {
+            let unicode = Value::string(
+                s.chars()
+                    .map(|c| format!("{:x}", c as u32))
+                    .collect::<Vec<String>>()
+                    .join(" "),
+                call_span,
+            );
+            let record = record! {
+                "name" => Value::string(*name, call_span),
+                "character" => Value::string(s, call_span),
+                "unicode" => unicode,
+            };
+
+            Value::record(record, call_span)
+        })
+        .into_pipeline_data(ctrlc))
+}
+
+fn handle_integer_flag(
+    int_args: Vec<i64>,
+    call: &Call,
+    call_span: Span,
+) -> Result<PipelineData, ShellError> {
+    if int_args.is_empty() {
+        return Err(ShellError::MissingParameter {
+            param_name: "missing at least one unicode character".into(),
+            span: call_span,
+        });
+    }
+    let mut multi_byte = String::new();
+    for (i, &arg) in int_args.iter().enumerate() {
+        let span = call
+            .positional_nth(i)
+            .expect("Unexpected missing argument")
+            .span;
+        multi_byte.push(integer_to_unicode_char(arg, span)?)
+    }
+    Ok(Value::string(multi_byte, call_span).into_pipeline_data())
+}
+
+fn handle_unicode_flag(
+    string_args: Vec<String>,
+    call: &Call,
+    call_span: Span,
+) -> Result<PipelineData, ShellError> {
+    if string_args.is_empty() {
+        return Err(ShellError::MissingParameter {
+            param_name: "missing at least one unicode character".into(),
+            span: call_span,
+        });
+    }
+    let mut multi_byte = String::new();
+    for (i, arg) in string_args.iter().enumerate() {
+        let span = call
+            .positional_nth(i)
+            .expect("Unexpected missing argument")
+            .span;
+        multi_byte.push(string_to_unicode_char(arg, span)?)
+    }
+    Ok(Value::string(multi_byte, call_span).into_pipeline_data())
+}
+
+fn handle_the_rest(
+    string_args: Vec<String>,
+    call: &Call,
+    call_span: Span,
+) -> Result<PipelineData, ShellError> {
+    if string_args.is_empty() {
+        return Err(ShellError::MissingParameter {
+            param_name: "missing name of the character".into(),
+            span: call_span,
+        });
+    }
+    let special_character = str_to_character(&string_args[0]);
+    if let Some(output) = special_character {
+        Ok(Value::string(output, call_span).into_pipeline_data())
+    } else {
+        Err(ShellError::TypeMismatch {
+            err_message: "error finding named character".into(),
+            span: call
+                .positional_nth(0)
+                .expect("Unexpected missing argument")
+                .span,
+        })
     }
 }