mirror of
https://github.com/nushell/nushell
synced 2025-01-21 01:24:33 +00:00
95b78eee25
# Description The meaning of the word usage is specific to describing how a command function is *used* and not a synonym for general description. Usage can be used to describe the SYNOPSIS or EXAMPLES sections of a man page where the permitted argument combinations are shown or example *uses* are given. Let's not confuse people and call it what it is a description. Our `help` command already creates its own *Usage* section based on the available arguments and doesn't refer to the description with usage. # User-Facing Changes `help commands` and `scope commands` will now use `description` or `extra_description` `usage`-> `description` `extra_usage` -> `extra_description` Breaking change in the plugin protocol: In the signature record communicated with the engine. `usage`-> `description` `extra_usage` -> `extra_description` The same rename also takes place for the methods on `SimplePluginCommand` and `PluginCommand` # Tests + Formatting - Updated plugin protocol specific changes # After Submitting - [ ] update plugin protocol doc
241 lines
6.8 KiB
Rust
241 lines
6.8 KiB
Rust
use super::util::get_rest_for_glob_pattern;
|
|
use crate::{DirBuilder, DirInfo, FileInfo};
|
|
#[allow(deprecated)]
|
|
use nu_engine::{command_prelude::*, current_dir};
|
|
use nu_glob::Pattern;
|
|
use nu_protocol::{NuGlob, Signals};
|
|
use serde::Deserialize;
|
|
use std::path::Path;
|
|
|
|
#[derive(Clone)]
|
|
pub struct Du;
|
|
|
|
#[derive(Deserialize, Clone, Debug)]
|
|
pub struct DuArgs {
|
|
path: Option<Spanned<NuGlob>>,
|
|
all: bool,
|
|
deref: bool,
|
|
exclude: Option<Spanned<NuGlob>>,
|
|
#[serde(rename = "max-depth")]
|
|
max_depth: Option<Spanned<i64>>,
|
|
#[serde(rename = "min-size")]
|
|
min_size: Option<Spanned<i64>>,
|
|
}
|
|
|
|
impl Command for Du {
|
|
fn name(&self) -> &str {
|
|
"du"
|
|
}
|
|
|
|
fn description(&self) -> &str {
|
|
"Find disk usage sizes of specified items."
|
|
}
|
|
|
|
fn signature(&self) -> Signature {
|
|
Signature::build("du")
|
|
.input_output_types(vec![(Type::Nothing, Type::table())])
|
|
.allow_variants_without_examples(true)
|
|
.rest(
|
|
"path",
|
|
SyntaxShape::OneOf(vec![SyntaxShape::GlobPattern, SyntaxShape::String]),
|
|
"Starting directory.",
|
|
)
|
|
.switch(
|
|
"all",
|
|
"Output file sizes as well as directory sizes",
|
|
Some('a'),
|
|
)
|
|
.switch(
|
|
"deref",
|
|
"Dereference symlinks to their targets for size",
|
|
Some('r'),
|
|
)
|
|
.named(
|
|
"exclude",
|
|
SyntaxShape::GlobPattern,
|
|
"Exclude these file names",
|
|
Some('x'),
|
|
)
|
|
.named(
|
|
"max-depth",
|
|
SyntaxShape::Int,
|
|
"Directory recursion limit",
|
|
Some('d'),
|
|
)
|
|
.named(
|
|
"min-size",
|
|
SyntaxShape::Int,
|
|
"Exclude files below this size",
|
|
Some('m'),
|
|
)
|
|
.category(Category::FileSystem)
|
|
}
|
|
|
|
fn run(
|
|
&self,
|
|
engine_state: &EngineState,
|
|
stack: &mut Stack,
|
|
call: &Call,
|
|
_input: PipelineData,
|
|
) -> Result<PipelineData, ShellError> {
|
|
let tag = call.head;
|
|
let min_size: Option<Spanned<i64>> = call.get_flag(engine_state, stack, "min-size")?;
|
|
let max_depth: Option<Spanned<i64>> = call.get_flag(engine_state, stack, "max-depth")?;
|
|
if let Some(ref max_depth) = max_depth {
|
|
if max_depth.item < 0 {
|
|
return Err(ShellError::NeedsPositiveValue {
|
|
span: max_depth.span,
|
|
});
|
|
}
|
|
}
|
|
if let Some(ref min_size) = min_size {
|
|
if min_size.item < 0 {
|
|
return Err(ShellError::NeedsPositiveValue {
|
|
span: min_size.span,
|
|
});
|
|
}
|
|
}
|
|
let all = call.has_flag(engine_state, stack, "all")?;
|
|
let deref = call.has_flag(engine_state, stack, "deref")?;
|
|
let exclude = call.get_flag(engine_state, stack, "exclude")?;
|
|
#[allow(deprecated)]
|
|
let current_dir = current_dir(engine_state, stack)?;
|
|
|
|
let paths = get_rest_for_glob_pattern(engine_state, stack, call, 0)?;
|
|
let paths = if !call.has_positional_args(stack, 0) {
|
|
None
|
|
} else {
|
|
Some(paths)
|
|
};
|
|
|
|
match paths {
|
|
None => {
|
|
let args = DuArgs {
|
|
path: None,
|
|
all,
|
|
deref,
|
|
exclude,
|
|
max_depth,
|
|
min_size,
|
|
};
|
|
Ok(
|
|
du_for_one_pattern(args, ¤t_dir, tag, engine_state.signals())?
|
|
.into_pipeline_data(tag, engine_state.signals().clone()),
|
|
)
|
|
}
|
|
Some(paths) => {
|
|
let mut result_iters = vec![];
|
|
for p in paths {
|
|
let args = DuArgs {
|
|
path: Some(p),
|
|
all,
|
|
deref,
|
|
exclude: exclude.clone(),
|
|
max_depth,
|
|
min_size,
|
|
};
|
|
result_iters.push(du_for_one_pattern(
|
|
args,
|
|
¤t_dir,
|
|
tag,
|
|
engine_state.signals(),
|
|
)?)
|
|
}
|
|
|
|
// chain all iterators on result.
|
|
Ok(result_iters
|
|
.into_iter()
|
|
.flatten()
|
|
.into_pipeline_data(tag, engine_state.signals().clone()))
|
|
}
|
|
}
|
|
}
|
|
|
|
fn examples(&self) -> Vec<Example> {
|
|
vec![Example {
|
|
description: "Disk usage of the current directory",
|
|
example: "du",
|
|
result: None,
|
|
}]
|
|
}
|
|
}
|
|
|
|
fn du_for_one_pattern(
|
|
args: DuArgs,
|
|
current_dir: &Path,
|
|
span: Span,
|
|
signals: &Signals,
|
|
) -> Result<impl Iterator<Item = Value> + Send, ShellError> {
|
|
let exclude = args.exclude.map_or(Ok(None), move |x| {
|
|
Pattern::new(x.item.as_ref())
|
|
.map(Some)
|
|
.map_err(|e| ShellError::InvalidGlobPattern {
|
|
msg: e.msg.into(),
|
|
span: x.span,
|
|
})
|
|
})?;
|
|
|
|
let include_files = args.all;
|
|
let mut paths = match args.path {
|
|
Some(p) => nu_engine::glob_from(&p, current_dir, span, None),
|
|
// The * pattern should never fail.
|
|
None => nu_engine::glob_from(
|
|
&Spanned {
|
|
item: NuGlob::Expand("*".into()),
|
|
span: Span::unknown(),
|
|
},
|
|
current_dir,
|
|
span,
|
|
None,
|
|
),
|
|
}
|
|
.map(|f| f.1)?
|
|
.filter(move |p| {
|
|
if include_files {
|
|
true
|
|
} else {
|
|
matches!(p, Ok(f) if f.is_dir())
|
|
}
|
|
});
|
|
|
|
let all = args.all;
|
|
let deref = args.deref;
|
|
let max_depth = args.max_depth.map(|f| f.item as u64);
|
|
let min_size = args.min_size.map(|f| f.item as u64);
|
|
|
|
let params = DirBuilder {
|
|
tag: span,
|
|
min: min_size,
|
|
deref,
|
|
exclude,
|
|
all,
|
|
};
|
|
|
|
let mut output: Vec<Value> = vec![];
|
|
for p in paths.by_ref() {
|
|
match p {
|
|
Ok(a) => {
|
|
if a.is_dir() {
|
|
output.push(DirInfo::new(a, ¶ms, max_depth, span, signals)?.into());
|
|
} else if let Ok(v) = FileInfo::new(a, deref, span) {
|
|
output.push(v.into());
|
|
}
|
|
}
|
|
Err(e) => {
|
|
output.push(Value::error(e, span));
|
|
}
|
|
}
|
|
}
|
|
Ok(output.into_iter())
|
|
}
|
|
|
|
#[cfg(test)]
|
|
mod tests {
|
|
use super::Du;
|
|
|
|
#[test]
|
|
fn examples_work_as_expected() {
|
|
use crate::test_examples;
|
|
test_examples(Du {})
|
|
}
|
|
}
|