Add umkdir command (#10785)

A `mkdir` command, which uses `uu_mkdir` as backend.

close #10515.

crates/nu-command/src/default_context.rs

@@ -204,6 +204,7 @@ pub fn add_shell_command_context(mut engine_state: EngineState) -> EngineState {
             Cd,
             Ls,
             Mkdir,
+        UMkdir,
             Mv,
             Cp,
             UCp,

crates/nu-command/src/filesystem/mod.rs

@@ -10,6 +10,7 @@ mod save;
 mod start;
 mod touch;
 mod ucp;
+mod umkdir;
 mod util;
 mod watch;
 
@@ -25,4 +26,5 @@ pub use save::Save;
 pub use start::Start;
 pub use touch::Touch;
 pub use ucp::UCp;
+pub use umkdir::UMkdir;
 pub use watch::Watch;

crates/nu-command/src/filesystem/umkdir.rs

@@ -0,0 +1,98 @@
+use nu_engine::env::current_dir;
+use nu_engine::CallExt;
+use nu_protocol::ast::Call;
+use nu_protocol::engine::{Command, EngineState, Stack};
+use nu_protocol::{Category, Example, PipelineData, ShellError, Signature, SyntaxShape, Type};
+
+use uu_mkdir::mkdir;
+
+#[derive(Clone)]
+pub struct UMkdir;
+
+const IS_RECURSIVE: bool = true;
+// This is the same default as Rust's std uses:
+// https://doc.rust-lang.org/nightly/std/os/unix/fs/trait.DirBuilderExt.html#tymethod.mode
+const DEFAULT_MODE: u32 = 0o777;
+
+impl Command for UMkdir {
+    fn name(&self) -> &str {
+        "umkdir"
+    }
+
+    fn usage(&self) -> &str {
+        "Create directories, with intermediary directories if required using uutils/coreutils mkdir."
+    }
+
+    fn search_terms(&self) -> Vec<&str> {
+        vec!["directory", "folder", "create", "make_dirs", "coreutils"]
+    }
+
+    fn signature(&self) -> Signature {
+        Signature::build("umkdir")
+            .input_output_types(vec![(Type::Nothing, Type::Nothing)])
+            .rest(
+                "rest",
+                SyntaxShape::Directory,
+                "the name(s) of the path(s) to create",
+            )
+            .switch(
+                "verbose",
+                "print a message for each created directory.",
+                Some('v'),
+            )
+            .category(Category::FileSystem)
+    }
+
+    fn run(
+        &self,
+        engine_state: &EngineState,
+        stack: &mut Stack,
+        call: &Call,
+        _input: PipelineData,
+    ) -> Result<PipelineData, ShellError> {
+        let path = current_dir(engine_state, stack)?;
+        let mut directories = call
+            .rest::<String>(engine_state, stack, 0)?
+            .into_iter()
+            .map(|dir| path.join(dir))
+            .peekable();
+
+        let is_verbose = call.has_flag("verbose");
+
+        if directories.peek().is_none() {
+            return Err(ShellError::MissingParameter {
+                param_name: "requires directory paths".to_string(),
+                span: call.head,
+            });
+        }
+
+        for dir in directories {
+            if let Err(error) = mkdir(&dir, IS_RECURSIVE, DEFAULT_MODE, is_verbose) {
+                return Err(ShellError::GenericError(
+                    format!("{}", error),
+                    format!("{}", error),
+                    None,
+                    None,
+                    Vec::new(),
+                ));
+            }
+        }
+
+        Ok(PipelineData::empty())
+    }
+
+    fn examples(&self) -> Vec<Example> {
+        vec![
+            Example {
+                description: "Make a directory named foo",
+                example: "umkdir foo",
+                result: None,
+            },
+            Example {
+                description: "Make multiple directories and show the paths created",
+                example: "umkdir -v foo/bar foo2",
+                result: None,
+            },
+        ]
+    }
+}