clean up config by removing legacy options (#9496)

# Description

This PR cleans up the deprecated legacy config options that were
deprecated in nushell version 0.72.0. These are the config points that
were in the root of the config but also duplicated in the nested
structures. For instance `use_ls_colors` was in the root of the config
and also in the `ls.use_ls_colors` nested structure. This was originally
done to preserve backwards compatibility when nested structures were
introduced in the config file.

Here's a list of the legacy config points that were removed.

- `use_ls_colors` - previously replaced with `ls.use_ls_colors`
- `rm_always_trash` - previously replaced with `rm.always_trash`
- `history_file_format` - previously replaced with `history.file_format`
- `sync_history_on_enter` - previously replaced with
`history.sync_on_enter`
- `max_history_size` - previously replaced with `history.max_size`
- `quick_completions` - previously replaced with `completions.quick`
- `partial_completions` - previously replaced with `completions.partial`
- `max_external_completion_results` - previously replaced with
`completions.external.max_results`
- `completion_algorithm` - previously replaced with
`completions.algorithm`
- `case_sensitive_completions` - previously replaced with
`completions.case_sensitive`
- `enable_external_completion` - previously replaced with
`completions.external.enable`
- `external_completer` - previously replaced with
`completions.external.completer`
- `table_mode` - previously replaced with `table.mode`
- `table_index_mode` - previously replaced with `table.index_mode`
- `table_trim` - previously replaced with `table.trim`
- `show_clickable_links_in_ls` - previously replaced with
`ls.clickable_links`
- `cd_with_abbreviations` - previously replaced with `cd.abbreviations`
- `filesize_metric` - previously replaced with `filesize.metric`
- `filesize_format` - previously replaced with `filesize.format`
- `cursor_shape_vi_insert` - previously replaced with
`cursor_shape.vi_insert`
- `cursor_shape_vi_normal` - previously replaced with
`cursor_shape.vi_normal`
- `cursor_shape_emacs` - previously replaced with `cursor_shape.emacs`

Removes log_level from the config since it doesn't do anything any
longer. We moved log-level to a nushell parameter some time ago.

Renames history_isolation to isolation in the config.nu for consistency.

Fixes a couple bugs where values weren't being set in the "//
Reconstruct" sections (history_isolation, table_show_empty).

Reorganized/Moved things around a tiny bit and added a few comments.

# User-Facing Changes

history.histor_isolation is now history.isolation.
If anyone is still using the legacy config points, deprecated since
0.72.0 2022-11-29, their config will break.

# 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 -A
clippy::needless_collect -A clippy::result_large_err` to check that
you're using the standard code style
- `cargo test --workspace` to check that all tests pass
- `cargo run -- crates/nu-std/tests/run.nu` 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.
-->
This commit is contained in:
Darren Schroeder 2023-06-23 06:17:10 -05:00 committed by GitHub
parent a0dafcb0f8
commit cbb9f8efe4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 54 additions and 267 deletions

View File

@ -38,7 +38,7 @@ fn table_collapse_0() {
#[test] #[test]
fn table_collapse_basic() { fn table_collapse_basic() {
let actual = nu!(nu_repl_code(&[ let actual = nu!(nu_repl_code(&[
"let-env config = { table_mode: basic };", "let-env config = { table: { mode: basic }};",
"[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse" "[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse"
])); ]));
assert_eq!( assert_eq!(
@ -60,7 +60,7 @@ fn table_collapse_basic() {
#[test] #[test]
fn table_collapse_heavy() { fn table_collapse_heavy() {
let actual = nu!(nu_repl_code(&[ let actual = nu!(nu_repl_code(&[
"let-env config = { table_mode: heavy };", "let-env config = { table: { mode: heavy }};",
"[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse" "[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse"
])); ]));
assert_eq!( assert_eq!(
@ -82,7 +82,7 @@ fn table_collapse_heavy() {
#[test] #[test]
fn table_collapse_compact() { fn table_collapse_compact() {
let actual = nu!(nu_repl_code(&[ let actual = nu!(nu_repl_code(&[
"let-env config = { table_mode: compact };", "let-env config = { table: { mode: compact }};",
"[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse" "[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse"
])); ]));
assert_eq!( assert_eq!(
@ -104,7 +104,7 @@ fn table_collapse_compact() {
#[test] #[test]
fn table_collapse_compact_double() { fn table_collapse_compact_double() {
let actual = nu!(nu_repl_code(&[ let actual = nu!(nu_repl_code(&[
"let-env config = { table_mode: compact_double };", "let-env config = { table: { mode: compact_double }};",
"[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse" "[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse"
])); ]));
assert_eq!( assert_eq!(
@ -126,7 +126,7 @@ fn table_collapse_compact_double() {
#[test] #[test]
fn table_collapse_compact_light() { fn table_collapse_compact_light() {
let actual = nu!(nu_repl_code(&[ let actual = nu!(nu_repl_code(&[
"let-env config = { table_mode: light };", "let-env config = { table: { mode: light }};",
"[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse" "[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse"
])); ]));
assert_eq!( assert_eq!(
@ -148,7 +148,7 @@ fn table_collapse_compact_light() {
#[test] #[test]
fn table_collapse_none() { fn table_collapse_none() {
let actual = nu!(nu_repl_code(&[ let actual = nu!(nu_repl_code(&[
"let-env config = { table_mode: none };", "let-env config = { table: { mode: none }};",
"[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse" "[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse"
])); ]));
assert_eq!( assert_eq!(
@ -166,7 +166,7 @@ fn table_collapse_none() {
#[test] #[test]
fn table_collapse_compact_reinforced() { fn table_collapse_compact_reinforced() {
let actual = nu!(nu_repl_code(&[ let actual = nu!(nu_repl_code(&[
"let-env config = { table_mode: reinforced };", "let-env config = { table: { mode: reinforced }};",
"[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse" "[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse"
])); ]));
assert_eq!( assert_eq!(
@ -188,7 +188,7 @@ fn table_collapse_compact_reinforced() {
#[test] #[test]
fn table_collapse_compact_thin() { fn table_collapse_compact_thin() {
let actual = nu!(nu_repl_code(&[ let actual = nu!(nu_repl_code(&[
"let-env config = { table_mode: thin };", "let-env config = { table: { mode: thin }};",
"[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse" "[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse"
])); ]));
assert_eq!( assert_eq!(
@ -210,7 +210,7 @@ fn table_collapse_compact_thin() {
#[test] #[test]
fn table_collapse_hearts() { fn table_collapse_hearts() {
let actual = nu!(nu_repl_code(&[ let actual = nu!(nu_repl_code(&[
"let-env config = { table_mode: with_love };", "let-env config = { table: { mode: with_love }};",
"[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse" "[[a b, c]; [1 2 3] [4 5 [1 2 3]]] | table --collapse"
])); ]));
assert_eq!( assert_eq!(

View File

@ -87,7 +87,6 @@ pub struct Config {
pub sync_history_on_enter: bool, pub sync_history_on_enter: bool,
pub history_file_format: HistoryFileFormat, pub history_file_format: HistoryFileFormat,
pub history_isolation: bool, pub history_isolation: bool,
pub log_level: String,
pub keybindings: Vec<ParsedKeybinding>, pub keybindings: Vec<ParsedKeybinding>,
pub menus: Vec<ParsedMenu>, pub menus: Vec<ParsedMenu>,
pub hooks: Hooks, pub hooks: Hooks,
@ -132,7 +131,6 @@ impl Default for Config {
sync_history_on_enter: true, sync_history_on_enter: true,
history_file_format: HistoryFileFormat::PlainText, history_file_format: HistoryFileFormat::PlainText,
history_isolation: false, history_isolation: false,
log_level: String::new(),
keybindings: Vec::new(), keybindings: Vec::new(),
menus: Vec::new(), menus: Vec::new(),
hooks: Hooks::new(), hooks: Hooks::new(),
@ -225,9 +223,7 @@ impl TrimStrategy {
impl Value { impl Value {
pub fn into_config(&mut self, config: &Config) -> (Config, Option<ShellError>) { pub fn into_config(&mut self, config: &Config) -> (Config, Option<ShellError>) {
// Clone the passed-in config rather than mutating it. // Clone the passed-in config rather than mutating it.
let mut config = config.clone(); let mut config = config.clone();
let mut legacy_options_used = false;
// Vec for storing errors. // Vec for storing errors.
// Current Nushell behaviour (Dec 2022) is that having some typo like "always_trash": tru in your config.nu's // Current Nushell behaviour (Dec 2022) is that having some typo like "always_trash": tru in your config.nu's
@ -423,7 +419,7 @@ impl Value {
let value = &vals[index]; let value = &vals[index];
let key2 = cols[index].as_str(); let key2 = cols[index].as_str();
match key2 { match key2 {
"history_isolation" => { "isolation" => {
try_bool!(cols, vals, index, span, history_isolation) try_bool!(cols, vals, index, span, history_isolation)
} }
"sync_on_enter" => { "sync_on_enter" => {
@ -478,11 +474,13 @@ impl Value {
"sync_on_enter".into(), "sync_on_enter".into(),
"max_size".into(), "max_size".into(),
"file_format".into(), "file_format".into(),
"isolation".into(),
], ],
vec![ vec![
Value::boolean(config.sync_history_on_enter, *span), Value::boolean(config.sync_history_on_enter, *span),
Value::int(config.max_history_size, *span), Value::int(config.max_history_size, *span),
reconstruct_history_file_format!(span), reconstruct_history_file_format!(span),
Value::boolean(config.history_isolation, *span),
], ],
*span, *span,
); );
@ -956,11 +954,17 @@ impl Value {
invalid!(vals[index].span().ok(), "should be a record"); invalid!(vals[index].span().ok(), "should be a record");
// Reconstruct // Reconstruct
vals[index] = Value::record( vals[index] = Value::record(
vec!["mode".into(), "index_mode".into(), "trim".into()], vec![
"mode".into(),
"index_mode".into(),
"trim".into(),
"show_empty".into(),
],
vec![ vec![
Value::string(config.table_mode.clone(), *span), Value::string(config.table_mode.clone(), *span),
reconstruct_index_mode!(span), reconstruct_index_mode!(span),
reconstruct_trim_strategy!(span), reconstruct_trim_strategy!(span),
Value::boolean(config.table_show_empty, *span),
], ],
*span, *span,
) )
@ -1074,15 +1078,26 @@ impl Value {
vals[index] = Value::string(config.edit_mode.clone(), *span); vals[index] = Value::string(config.edit_mode.clone(), *span);
} }
} }
"log_level" => { "shell_integration" => {
try_bool!(cols, vals, index, span, shell_integration);
}
"buffer_editor" => {
if let Ok(v) = value.as_string() { if let Ok(v) = value.as_string() {
config.log_level = v.to_lowercase(); config.buffer_editor = v.to_lowercase();
} else { } else {
invalid!(Some(*span), "should be a string"); invalid!(Some(*span), "should be a string");
// Reconstruct
vals[index] = Value::string(config.log_level.clone(), *span);
} }
} }
"show_banner" => {
try_bool!(cols, vals, index, span, show_banner);
}
"render_right_prompt_on_last_line" => {
try_bool!(cols, vals, index, span, render_right_prompt_on_last_line);
}
"bracketed_paste" => {
try_bool!(cols, vals, index, span, bracketed_paste);
}
// Menus
"menus" => match create_menus(value) { "menus" => match create_menus(value) {
Ok(map) => config.menus = map, Ok(map) => config.menus = map,
Err(e) => { Err(e) => {
@ -1128,6 +1143,7 @@ impl Value {
} }
} }
}, },
// Keybindings
"keybindings" => match create_keybindings(value) { "keybindings" => match create_keybindings(value) {
Ok(keybindings) => config.keybindings = keybindings, Ok(keybindings) => config.keybindings = keybindings,
Err(e) => { Err(e) => {
@ -1167,6 +1183,7 @@ impl Value {
} }
} }
}, },
// Hooks
"hooks" => match create_hooks(value) { "hooks" => match create_hooks(value) {
Ok(hooks) => config.hooks = hooks, Ok(hooks) => config.hooks = hooks,
Err(e) => { Err(e) => {
@ -1198,229 +1215,7 @@ impl Value {
}); });
} }
}, },
"shell_integration" => { // Catch all
try_bool!(cols, vals, index, span, shell_integration);
}
"buffer_editor" => {
if let Ok(v) = value.as_string() {
config.buffer_editor = v.to_lowercase();
} else {
invalid!(Some(*span), "should be a string");
}
}
"show_banner" => {
try_bool!(cols, vals, index, span, show_banner);
}
"render_right_prompt_on_last_line" => {
try_bool!(cols, vals, index, span, render_right_prompt_on_last_line);
}
"bracketed_paste" => {
try_bool!(cols, vals, index, span, bracketed_paste);
}
// Legacy config options (deprecated as of 2022-11-02)
// Legacy options do NOT reconstruct their values on error
"use_ls_colors" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, use_ls_colors);
}
"rm_always_trash" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, rm_always_trash);
}
"history_file_format" => {
legacy_options_used = true;
if let Ok(b) = value.as_string() {
let val_str = b.to_lowercase();
config.history_file_format = match val_str.as_ref() {
"sqlite" => HistoryFileFormat::Sqlite,
"plaintext" => HistoryFileFormat::PlainText,
_ => {
invalid!(
Some(*span),
"unrecognized $env.config.{key} '{val_str}'"
);
HistoryFileFormat::PlainText
}
};
} else {
invalid!(Some(*span), "should be a string");
}
}
"sync_history_on_enter" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, sync_history_on_enter);
}
"max_history_size" => {
legacy_options_used = true;
try_int!(cols, vals, index, span, max_history_size);
}
"quick_completions" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, quick_completions);
}
"partial_completions" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, partial_completions);
}
"max_external_completion_results" => {
legacy_options_used = true;
try_int!(cols, vals, index, span, max_external_completion_results);
}
"completion_algorithm" => {
legacy_options_used = true;
if let Ok(v) = value.as_string() {
let val_str = v.to_lowercase();
config.completion_algorithm = match val_str.as_ref() {
// This should match the MatchAlgorithm enum in completions::completion_options
"prefix" => val_str,
"fuzzy" => val_str,
_ => {
invalid!( Some(*span),
"unrecognized $env.config.{key} '{val_str}'; expected either 'prefix' or 'fuzzy'"
);
val_str
}
};
} else {
invalid!(Some(*span), "should be a string");
}
}
"case_sensitive_completions" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, case_sensitive_completions);
}
"enable_external_completion" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, enable_external_completion);
}
"external_completer" => {
legacy_options_used = true;
if let Ok(v) = value.as_block() {
config.external_completer = Some(v)
}
// No error here because external completers are optional.
// Idea: maybe error if this is a non-block, non-null?
}
"table_mode" => {
legacy_options_used = true;
if let Ok(v) = value.as_string() {
config.table_mode = v;
} else {
invalid!(Some(*span), "should be a string");
}
}
"table_index_mode" => {
legacy_options_used = true;
if let Ok(b) = value.as_string() {
let val_str = b.to_lowercase();
match val_str.as_ref() {
"always" => config.table_index_mode = TableIndexMode::Always,
"never" => config.table_index_mode = TableIndexMode::Never,
"auto" => config.table_index_mode = TableIndexMode::Auto,
_ => {
invalid!( Some(*span),
"unrecognized $env.config.table_index_mode '{val_str}'; expected either 'never', 'always' or 'auto'"
);
}
}
} else {
invalid!(Some(*span), "should be a string");
}
}
"table_trim" => {
legacy_options_used = true;
match try_parse_trim_strategy(value, &mut errors) {
Ok(v) => config.trim_strategy = v,
Err(e) => {
// try_parse_trim_strategy() already calls eprintln!() on error
cols.remove(index);
vals.remove(index);
errors.push(e);
}
}
}
"show_clickable_links_in_ls" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, show_clickable_links_in_ls);
}
"cd_with_abbreviations" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, cd_with_abbreviations);
}
"filesize_metric" => {
legacy_options_used = true;
try_bool!(cols, vals, index, span, filesize_metric);
}
"filesize_format" => {
legacy_options_used = true;
if let Ok(v) = value.as_string() {
config.filesize_format = v.to_lowercase();
} else {
invalid!(Some(*span), "should be a string");
}
}
"cursor_shape_vi_insert" => {
legacy_options_used = true;
if let Ok(b) = value.as_string() {
let val_str = b.to_lowercase();
config.cursor_shape_vi_insert = match val_str.as_ref() {
"block" => NuCursorShape::Block,
"underline" => NuCursorShape::UnderScore,
"line" => NuCursorShape::Line,
_ => {
invalid!(
Some(*span),
"unrecognized $env.config.{key} '{val_str}'"
);
NuCursorShape::Line
}
};
} else {
invalid!(Some(*span), "should be a string");
}
}
"cursor_shape_vi_normal" => {
legacy_options_used = true;
if let Ok(b) = value.as_string() {
let val_str = b.to_lowercase();
config.cursor_shape_vi_normal = match val_str.as_ref() {
"block" => NuCursorShape::Block,
"underline" => NuCursorShape::UnderScore,
"line" => NuCursorShape::Line,
_ => {
invalid!(
Some(*span),
"unrecognized $env.config.{key} '{val_str}'"
);
NuCursorShape::Line
}
};
} else {
invalid!(Some(*span), "should be a string");
}
}
"cursor_shape_emacs" => {
legacy_options_used = true;
if let Ok(b) = value.as_string() {
let val_str = b.to_lowercase();
config.cursor_shape_emacs = match val_str.as_ref() {
"block" => NuCursorShape::Block,
"underline" => NuCursorShape::UnderScore,
"line" => NuCursorShape::Line,
_ => {
invalid!(
Some(*span),
"unrecognized $env.config.{key} '{val_str}'"
);
NuCursorShape::Line
}
};
} else {
invalid!(Some(*span), "should be a string");
}
}
// End legacy options
x => { x => {
invalid_key!( invalid_key!(
cols, cols,
@ -1445,14 +1240,6 @@ impl Value {
); );
} }
if legacy_options_used {
// This is a notification message, not an error.
eprintln!(
r#"The format of $env.config has recently changed, and several options have been grouped into sub-records. You may need to update your config.nu file.
Please consult https://www.nushell.sh/blog/2022-11-29-nushell-0.72.html for details. Support for the old format will be removed in an upcoming Nu release."#
);
}
// Return the config and the vec of errors. // Return the config and the vec of errors.
( (
config, config,

View File

@ -268,7 +268,7 @@ let-env config = {
max_size: 100_000 # Session has to be reloaded for this to take effect max_size: 100_000 # Session has to be reloaded for this to take effect
sync_on_enter: true # Enable to share history between multiple sessions, else you have to close the session to write history to file sync_on_enter: true # Enable to share history between multiple sessions, else you have to close the session to write history to file
file_format: "plaintext" # "sqlite" or "plaintext" file_format: "plaintext" # "sqlite" or "plaintext"
history_isolation: true # true enables history isolation, false disables it. true will allow the history to be isolated to the current session. false will allow the history to be shared across all sessions. isolation: true # true enables history isolation, false disables it. true will allow the history to be isolated to the current session. false will allow the history to be shared across all sessions.
} }
completions: { completions: {
case_sensitive: false # set to true to enable case-sensitive completions case_sensitive: false # set to true to enable case-sensitive completions