mirror of
https://github.com/nushell/nushell.git
synced 2025-02-16 10:32:29 +01:00
<!--
if this PR closes one or more issues, you can automatically link the PR
with
them by using one of the [*linking
keywords*](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword),
e.g.
- this PR should close #xxxx
- fixes #xxxx
you can also mention related issues, PRs or discussions!
-->
# Description
<!--
Thank you for improving Nushell. Please, check our [contributing
guide](../CONTRIBUTING.md) and talk to the core team before making major
changes.
Description of your pull request goes here. **Provide examples and/or
screenshots** if your changes affect the user experience.
-->
As mentioned in #10698, we have too many `ShellError` variants, with
some even overlapping in meaning. This PR simplifies and improves I/O
error handling by restructuring `ShellError` related to I/O issues.
Previously, `ShellError::IOError` only contained a message string,
making it convenient but overly generic. It was widely used without
providing spans (#4323).
This PR introduces a new `ShellError::Io` variant that consolidates
multiple I/O-related errors (except for `ShellError::NetworkFailure`,
which remains distinct for now). The new `ShellError::Io` variant
replaces the following:
- `FileNotFound`
- `FileNotFoundCustom`
- `IOInterrupted`
- `IOError`
- `IOErrorSpanned`
- `NotADirectory`
- `DirectoryNotFound`
- `MoveNotPossible`
- `CreateNotPossible`
- `ChangeAccessTimeNotPossible`
- `ChangeModifiedTimeNotPossible`
- `RemoveNotPossible`
- `ReadingFile`
## The `IoError`
`IoError` includes the following fields:
1. **`kind`**: Extends `std::io::ErrorKind` to specify the type of I/O
error without needing new `ShellError` variants. This aligns with the
approach used in `std::io::Error`. This adds a second dimension to error
reporting by combining the `kind` field with `ShellError` variants,
making it easier to describe errors in more detail. As proposed by
@kubouch in [#design-discussion on
Discord](https://discord.com/channels/601130461678272522/615329862395101194/1323699197165178930),
this helps reduce the number of `ShellError` variants. In the error
report, the `kind` field is displayed as the "source" of the error,
e.g., "I/O error," followed by the specific kind of I/O error.
2. **`span`**: A non-optional field to encourage providing spans for
better error reporting (#4323).
3. **`path`**: Optional `PathBuf` to give context about the file or
directory involved in the error (#7695). If provided, it’s shown as a
help entry in error reports.
4. **`additional_context`**: Allows adding custom messages when the
span, kind, and path are insufficient. This is rendered in the error
report at the labeled span.
5. **`location`**: Sometimes, I/O errors occur in the engine itself and
are not caused directly by user input. In such cases, if we don’t have a
span and must set it to `Span::unknown()`, we need another way to
reference the error. For this, the `location` field uses the new
`Location` struct, which records the Rust file and line number where the
error occurred. This ensures that we at least know the Rust code
location that failed, helping with debugging. To make this work, a new
`location!` macro was added, which retrieves `file!`, `line!`, and
`column!` values accurately. If `Location::new` is used directly, it
issues a warning to remind developers to use the macro instead, ensuring
consistent and correct usage.
### Constructor Behavior
`IoError` provides five constructor methods:
- `new` and `new_with_additional_context`: Used for errors caused by
user input and require a valid (non-unknown) span to ensure precise
error reporting.
- `new_internal` and `new_internal_with_path`: Used for internal errors
where a span is not available. These methods require additional context
and the `Location` struct to pinpoint the source of the error in the
engine code.
- `factory`: Returns a closure that maps an `std::io::Error` to an
`IoError`. This is useful for handling multiple I/O errors that share
the same span and path, streamlining error handling in such cases.
## New Report Look
This is simulation how the I/O errors look like (the `open crates` is
simulated to show how internal errors are referenced now):
![Screenshot 2025-01-25
190426](https://github.com/user-attachments/assets/a41b6aa6-a440-497d-bbcc-3ac0121c9226)
## `Span::test_data()`
To enable better testing, `Span::test_data()` now returns a value
distinct from `Span::unknown()`. Both `Span::test_data()` and
`Span::unknown()` refer to invalid source code, but having a separate
value for test data helps identify issues during testing while keeping
spans unique.
## Cursed Sneaky Error Transfers
I removed the conversions between `std::io::Error` and `ShellError` as
they often removed important information and were used too broadly to
handle I/O errors. This also removed the problematic implementation
found here:
7ea4895513/crates/nu-protocol/src/errors/shell_error.rs (L1534-L1583)
which hid some downcasting from I/O errors and made it hard to trace
where `ShellError` was converted into `std::io::Error`. To address this,
I introduced a new struct called `ShellErrorBridge`, which explicitly
defines this transfer behavior. With `ShellErrorBridge`, we can now
easily grep the codebase to locate and manage such conversions.
## Miscellaneous
- Removed the OS error added in #14640, as it’s no longer needed.
- Improved error messages in `glob_from` (#14679).
- Trying to open a directory with `open` caused a permissions denied
error (it's just what the OS provides). I added a `is_dir` check to
provide a better error in that case.
# User-Facing Changes
<!-- List of all changes that impact the user experience here. This
helps us keep track of breaking changes. -->
- Error outputs now include more detailed information and are formatted
differently, including updated error codes.
- The structure of `ShellError` has changed, requiring plugin authors
and embedders to update their implementations.
# 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 toolkit.nu; toolkit test stdlib"` 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
> ```
-->
I updated tests to account for the new I/O error structure and
formatting changes.
# 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 PR closes #7695 and closes #14892 and partially addresses #4323 and
#10698.
---------
Co-authored-by: Darren Schroeder <343840+fdncred@users.noreply.github.com>
452 lines
14 KiB
Rust
452 lines
14 KiB
Rust
use std::path::PathBuf;
|
|
|
|
use nu_test_support::fs::Stub::EmptyFile;
|
|
use nu_test_support::fs::Stub::FileWithContent;
|
|
use nu_test_support::fs::Stub::FileWithContentToBeTrimmed;
|
|
use nu_test_support::playground::Playground;
|
|
use nu_test_support::{nu, pipeline};
|
|
use rstest::rstest;
|
|
|
|
#[test]
|
|
fn parses_file_with_uppercase_extension() {
|
|
Playground::setup("open_test_uppercase_extension", |dirs, sandbox| {
|
|
sandbox.with_files(&[FileWithContent(
|
|
"nu.zion.JSON",
|
|
r#"{
|
|
"glossary": {
|
|
"GlossDiv": {
|
|
"GlossList": {
|
|
"GlossEntry": {
|
|
"ID": "SGML"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}"#,
|
|
)]);
|
|
|
|
let actual = nu!(
|
|
cwd: dirs.test(), pipeline(
|
|
r#"
|
|
open nu.zion.JSON
|
|
| get glossary.GlossDiv.GlossList.GlossEntry.ID
|
|
"#
|
|
));
|
|
|
|
assert_eq!(actual.out, "SGML");
|
|
})
|
|
}
|
|
|
|
#[test]
|
|
fn parses_file_with_multiple_extensions() {
|
|
Playground::setup("open_test_multiple_extensions", |dirs, sandbox| {
|
|
sandbox.with_files(&[
|
|
FileWithContent("file.tar.gz", "this is a tar.gz file"),
|
|
FileWithContent("file.tar.xz", "this is a tar.xz file"),
|
|
]);
|
|
|
|
let actual = nu!(
|
|
cwd: dirs.test(), pipeline(
|
|
r#"
|
|
hide "from tar.gz" ;
|
|
hide "from gz" ;
|
|
|
|
def "from tar.gz" [] { 'opened tar.gz' } ;
|
|
def "from gz" [] { 'opened gz' } ;
|
|
open file.tar.gz
|
|
"#
|
|
));
|
|
|
|
assert_eq!(actual.out, "opened tar.gz");
|
|
|
|
let actual2 = nu!(
|
|
cwd: dirs.test(), pipeline(
|
|
r#"
|
|
hide "from tar.xz" ;
|
|
hide "from xz" ;
|
|
hide "from tar" ;
|
|
|
|
def "from tar" [] { 'opened tar' } ;
|
|
def "from xz" [] { 'opened xz' } ;
|
|
open file.tar.xz
|
|
"#
|
|
));
|
|
|
|
assert_eq!(actual2.out, "opened xz");
|
|
})
|
|
}
|
|
|
|
#[test]
|
|
fn parses_dotfile() {
|
|
Playground::setup("open_test_dotfile", |dirs, sandbox| {
|
|
sandbox.with_files(&[FileWithContent(
|
|
".gitignore",
|
|
r#"
|
|
/target/
|
|
"#,
|
|
)]);
|
|
|
|
let actual = nu!(
|
|
cwd: dirs.test(), pipeline(
|
|
r#"
|
|
hide "from gitignore" ;
|
|
|
|
def "from gitignore" [] { 'opened gitignore' } ;
|
|
open .gitignore
|
|
"#
|
|
));
|
|
|
|
assert_eq!(actual.out, "opened gitignore");
|
|
})
|
|
}
|
|
|
|
#[test]
|
|
fn parses_csv() {
|
|
Playground::setup("open_test_1", |dirs, sandbox| {
|
|
sandbox.with_files(&[FileWithContentToBeTrimmed(
|
|
"nu.zion.csv",
|
|
r#"
|
|
author,lang,source
|
|
JT Turner,Rust,New Zealand
|
|
Andres N. Robalino,Rust,Ecuador
|
|
Yehuda Katz,Rust,Estados Unidos
|
|
"#,
|
|
)]);
|
|
|
|
let actual = nu!(
|
|
cwd: dirs.test(), pipeline(
|
|
r#"
|
|
open nu.zion.csv
|
|
| where author == "Andres N. Robalino"
|
|
| get source.0
|
|
"#
|
|
));
|
|
|
|
assert_eq!(actual.out, "Ecuador");
|
|
})
|
|
}
|
|
|
|
// sample.db has the following format:
|
|
//
|
|
// ╭─────────┬────────────────╮
|
|
// │ strings │ [table 6 rows] │
|
|
// │ ints │ [table 5 rows] │
|
|
// │ floats │ [table 4 rows] │
|
|
// ╰─────────┴────────────────╯
|
|
//
|
|
// In this case, this represents a sqlite database
|
|
// with three tables named `strings`, `ints`, and `floats`.
|
|
//
|
|
// Each table has different columns. `strings` has `x` and `y`, while
|
|
// `ints` has just `z`, and `floats` has only the column `f`. In general, when working
|
|
// with sqlite, one will want to select a single table, e.g.:
|
|
//
|
|
// open sample.db | get ints
|
|
// ╭───┬──────╮
|
|
// │ # │ z │
|
|
// ├───┼──────┤
|
|
// │ 0 │ 1 │
|
|
// │ 1 │ 42 │
|
|
// │ 2 │ 425 │
|
|
// │ 3 │ 4253 │
|
|
// │ 4 │ │
|
|
// ╰───┴──────╯
|
|
|
|
#[cfg(feature = "sqlite")]
|
|
#[test]
|
|
fn parses_sqlite() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats", pipeline(
|
|
"
|
|
open sample.db
|
|
| columns
|
|
| length
|
|
"
|
|
));
|
|
|
|
assert_eq!(actual.out, "3");
|
|
}
|
|
|
|
#[cfg(feature = "sqlite")]
|
|
#[test]
|
|
fn parses_sqlite_get_column_name() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats", pipeline(
|
|
"
|
|
open sample.db
|
|
| get strings
|
|
| get x.0
|
|
"
|
|
));
|
|
|
|
assert_eq!(actual.out, "hello");
|
|
}
|
|
|
|
#[test]
|
|
fn parses_toml() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats",
|
|
"open cargo_sample.toml | get package.edition"
|
|
);
|
|
|
|
assert_eq!(actual.out, "2018");
|
|
}
|
|
|
|
#[test]
|
|
fn parses_tsv() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats", pipeline(
|
|
"
|
|
open caco3_plastics.tsv
|
|
| first
|
|
| get origin
|
|
"
|
|
));
|
|
|
|
assert_eq!(actual.out, "SPAIN")
|
|
}
|
|
|
|
#[test]
|
|
fn parses_json() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats", pipeline(
|
|
"
|
|
open sgml_description.json
|
|
| get glossary.GlossDiv.GlossList.GlossEntry.GlossSee
|
|
"
|
|
));
|
|
|
|
assert_eq!(actual.out, "markup")
|
|
}
|
|
|
|
#[test]
|
|
fn parses_xml() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats",
|
|
pipeline("
|
|
open jt.xml
|
|
| get content
|
|
| where tag == channel
|
|
| get content
|
|
| flatten
|
|
| where tag == item
|
|
| get content
|
|
| flatten
|
|
| where tag == guid
|
|
| get content.0.content.0
|
|
")
|
|
);
|
|
|
|
assert_eq!(actual.out, "https://www.jntrnr.com/off-to-new-adventures/")
|
|
}
|
|
|
|
#[test]
|
|
fn errors_if_file_not_found() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats",
|
|
"open i_dont_exist.txt"
|
|
);
|
|
// Common error code between unixes and Windows for "No such file or directory"
|
|
//
|
|
// This seems to be not directly affected by localization compared to the OS
|
|
// provided error message
|
|
|
|
assert!(actual.err.contains("nu::shell::io::not_found"));
|
|
assert!(actual.err.contains(
|
|
&PathBuf::from_iter(["tests", "fixtures", "formats", "i_dont_exist.txt"])
|
|
.display()
|
|
.to_string()
|
|
));
|
|
}
|
|
|
|
#[test]
|
|
fn open_wildcard() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats", pipeline(
|
|
"
|
|
open *.nu | where $it =~ echo | length
|
|
"
|
|
));
|
|
|
|
assert_eq!(actual.out, "3")
|
|
}
|
|
|
|
#[test]
|
|
fn open_multiple_files() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats", pipeline(
|
|
"
|
|
open caco3_plastics.csv caco3_plastics.tsv | get tariff_item | math sum
|
|
"
|
|
));
|
|
|
|
assert_eq!(actual.out, "58309279992")
|
|
}
|
|
|
|
#[test]
|
|
fn test_open_block_command() {
|
|
let actual = nu!(
|
|
cwd: "tests/fixtures/formats",
|
|
r#"
|
|
def "from blockcommandparser" [] { lines | split column ",|," }
|
|
let values = (open sample.blockcommandparser)
|
|
print ($values | get column1 | get 0)
|
|
print ($values | get column2 | get 0)
|
|
print ($values | get column1 | get 1)
|
|
print ($values | get column2 | get 1)
|
|
"#
|
|
);
|
|
|
|
assert_eq!(actual.out, "abcd")
|
|
}
|
|
|
|
#[test]
|
|
fn open_ignore_ansi() {
|
|
Playground::setup("open_test_ansi", |dirs, sandbox| {
|
|
sandbox.with_files(&[EmptyFile("nu.zion.txt")]);
|
|
|
|
let actual = nu!(
|
|
cwd: dirs.test(), pipeline(
|
|
"
|
|
ls | find nu.zion | get 0 | get name | open $in
|
|
"
|
|
));
|
|
|
|
assert!(actual.err.is_empty());
|
|
})
|
|
}
|
|
|
|
#[test]
|
|
fn open_no_parameter() {
|
|
let actual = nu!("open");
|
|
|
|
assert!(actual.err.contains("needs filename"));
|
|
}
|
|
|
|
#[rstest]
|
|
#[case("a]c")]
|
|
#[case("a[c")]
|
|
#[case("a[bc]d")]
|
|
#[case("a][c")]
|
|
fn open_files_with_glob_metachars(#[case] src_name: &str) {
|
|
Playground::setup("open_test_with_glob_metachars", |dirs, sandbox| {
|
|
sandbox.with_files(&[FileWithContent(src_name, "hello")]);
|
|
|
|
let src = dirs.test().join(src_name);
|
|
|
|
let actual = nu!(
|
|
cwd: dirs.test(),
|
|
"open '{}'",
|
|
src.display(),
|
|
);
|
|
|
|
assert!(actual.err.is_empty());
|
|
assert!(actual.out.contains("hello"));
|
|
|
|
// also test for variables.
|
|
let actual = nu!(
|
|
cwd: dirs.test(),
|
|
"let f = '{}'; open $f",
|
|
src.display(),
|
|
);
|
|
assert!(actual.err.is_empty());
|
|
assert!(actual.out.contains("hello"));
|
|
});
|
|
}
|
|
|
|
#[cfg(not(windows))]
|
|
#[rstest]
|
|
#[case("a]?c")]
|
|
#[case("a*.?c")]
|
|
// windows doesn't allow filename with `*`.
|
|
fn open_files_with_glob_metachars_nw(#[case] src_name: &str) {
|
|
open_files_with_glob_metachars(src_name);
|
|
}
|
|
|
|
#[test]
|
|
fn open_files_inside_glob_metachars_dir() {
|
|
Playground::setup("open_files_inside_glob_metachars_dir", |dirs, sandbox| {
|
|
let sub_dir = "test[]";
|
|
sandbox
|
|
.within(sub_dir)
|
|
.with_files(&[FileWithContent("test_file.txt", "hello")]);
|
|
|
|
let actual = nu!(
|
|
cwd: dirs.test().join(sub_dir),
|
|
"open test_file.txt",
|
|
);
|
|
|
|
assert!(actual.err.is_empty());
|
|
assert!(actual.out.contains("hello"));
|
|
});
|
|
}
|
|
|
|
#[test]
|
|
fn test_content_types_with_open_raw() {
|
|
Playground::setup("open_files_content_type_test", |dirs, _| {
|
|
let result = nu!(cwd: dirs.formats(), "open --raw random_numbers.csv | metadata");
|
|
assert!(result.out.contains("text/csv"));
|
|
let result = nu!(cwd: dirs.formats(), "open --raw caco3_plastics.tsv | metadata");
|
|
assert!(result.out.contains("text/tab-separated-values"));
|
|
let result = nu!(cwd: dirs.formats(), "open --raw sample-simple.json | metadata");
|
|
assert!(result.out.contains("application/json"));
|
|
let result = nu!(cwd: dirs.formats(), "open --raw sample.ini | metadata");
|
|
assert!(result.out.contains("text/plain"));
|
|
let result = nu!(cwd: dirs.formats(), "open --raw sample_data.xlsx | metadata");
|
|
assert!(result.out.contains("vnd.openxmlformats-officedocument"));
|
|
let result = nu!(cwd: dirs.formats(), "open --raw sample_def.nu | metadata");
|
|
assert!(result.out.contains("application/x-nuscript"));
|
|
let result = nu!(cwd: dirs.formats(), "open --raw sample.eml | metadata");
|
|
assert!(result.out.contains("message/rfc822"));
|
|
let result = nu!(cwd: dirs.formats(), "open --raw cargo_sample.toml | metadata");
|
|
assert!(result.out.contains("text/x-toml"));
|
|
let result = nu!(cwd: dirs.formats(), "open --raw appveyor.yml | metadata");
|
|
assert!(result.out.contains("application/yaml"));
|
|
})
|
|
}
|
|
|
|
#[test]
|
|
fn test_metadata_without_raw() {
|
|
Playground::setup("open_files_content_type_test", |dirs, _| {
|
|
let result = nu!(cwd: dirs.formats(), "(open random_numbers.csv | metadata | get content_type?) == null");
|
|
assert_eq!(result.out, "true");
|
|
let result = nu!(cwd: dirs.formats(), "open random_numbers.csv | metadata | get source?");
|
|
assert!(result.out.contains("random_numbers.csv"));
|
|
let result = nu!(cwd: dirs.formats(), "(open caco3_plastics.tsv | metadata | get content_type?) == null");
|
|
assert_eq!(result.out, "true");
|
|
let result = nu!(cwd: dirs.formats(), "open caco3_plastics.tsv | metadata | get source?");
|
|
assert!(result.out.contains("caco3_plastics.tsv"));
|
|
let result = nu!(cwd: dirs.formats(), "(open sample-simple.json | metadata | get content_type?) == null");
|
|
assert_eq!(result.out, "true");
|
|
let result = nu!(cwd: dirs.formats(), "open sample-simple.json | metadata | get source?");
|
|
assert!(result.out.contains("sample-simple.json"));
|
|
// Only when not using nu_plugin_formats
|
|
let result = nu!(cwd: dirs.formats(), "open sample.ini | metadata");
|
|
assert!(result.out.contains("text/plain"));
|
|
let result = nu!(cwd: dirs.formats(), "open sample.ini | metadata | get source?");
|
|
assert!(result.out.contains("sample.ini"));
|
|
let result = nu!(cwd: dirs.formats(), "(open sample_data.xlsx | metadata | get content_type?) == null");
|
|
assert_eq!(result.out, "true");
|
|
let result = nu!(cwd: dirs.formats(), "open sample_data.xlsx | metadata | get source?");
|
|
assert!(result.out.contains("sample_data.xlsx"));
|
|
let result = nu!(cwd: dirs.formats(), "open sample_def.nu | metadata | get content_type?");
|
|
assert_eq!(result.out, "application/x-nuscript");
|
|
let result = nu!(cwd: dirs.formats(), "open sample_def.nu | metadata | get source?");
|
|
assert!(result.out.contains("sample_def"));
|
|
// Only when not using nu_plugin_formats
|
|
let result = nu!(cwd: dirs.formats(), "open sample.eml | metadata | get content_type?");
|
|
assert_eq!(result.out, "message/rfc822");
|
|
let result = nu!(cwd: dirs.formats(), "open sample.eml | metadata | get source?");
|
|
assert!(result.out.contains("sample.eml"));
|
|
let result = nu!(cwd: dirs.formats(), "(open cargo_sample.toml | metadata | get content_type?) == null");
|
|
assert_eq!(result.out, "true");
|
|
let result = nu!(cwd: dirs.formats(), "open cargo_sample.toml | metadata | get source?");
|
|
assert!(result.out.contains("cargo_sample.toml"));
|
|
let result =
|
|
nu!(cwd: dirs.formats(), "(open appveyor.yml | metadata | get content_type?) == null");
|
|
assert_eq!(result.out, "true");
|
|
let result = nu!(cwd: dirs.formats(), "open appveyor.yml | metadata | get source?");
|
|
assert!(result.out.contains("appveyor.yml"));
|
|
})
|
|
}
|