Enum nu_protocol::ShellError

pub enum ShellError {
    OperatorMismatch {
        op_span: Span,
        lhs_ty: Type,
        lhs_span: Span,
        rhs_ty: Type,
        rhs_span: Span,
    },
    OperatorOverflow(String, Span),
    PipelineMismatch(String, Span, Span),
    TypeMismatch(String, Span),
    UnsupportedOperator(Operator, Span),
    UnknownOperator(String, Span),
    MissingParameter(String, Span),
    IncompatibleParameters {
        left_message: String,
        left_span: Span,
        right_message: String,
        right_span: Span,
    },
    DelimiterError(String, Span),
    IncompatibleParametersSingle(String, Span),
    FeatureNotEnabled(Span),
    ExternalNotSupported(Span),
    InvalidProbability(Span),
    InvalidRange(String, String, Span),
    NushellFailed(String),
    NushellFailedSpanned(String, String, Span),
    NushellFailedHelp(String, String),
    NushellFailedSpannedHelp(String, String, Span, String),
    VariableNotFoundAtRuntime(Span),
    EnvVarNotFoundAtRuntime(String, Span),
    ModuleNotFoundAtRuntime(String, Span),
    ModuleOrOverlayNotFoundAtRuntime(String, Span),
    OverlayNotFoundAtRuntime(String, Span),
    NotFound(Span),
    CantConvert(String, String, Span, Option<String>),
    EnvVarNotAString(String, Span),
    DivisionByZero(Span),
    CannotCreateRange(Span),
    AccessBeyondEnd(usize, Span),
    AccessBeyondEndOfStream(Span),
    IncompatiblePathAccess(String, Span),
    CantFindColumn(Span, Span),
    ColumnAlreadyExists(Span, Span),
    NotAList(Span, Span),
    ExternalCommand(String, String, Span),
    UnsupportedInput(String, Span),
    DatetimeParseError(Span),
    NetworkFailure(String, Span),
    CommandNotFound(Span),
    FlagNotFound(String, Span),
    FileNotFound(Span),
    FileNotFoundCustom(String, Span),
    PluginFailedToLoad(String),
    PluginFailedToEncode(String),
    PluginFailedToDecode(String),
    IOError(String),
    NotADirectory(Span),
    DirectoryNotFound(Span, Option<String>),
    DirectoryNotFoundCustom(String, Span),
    MoveNotPossible {
        source_message: String,
        source_span: Span,
        destination_message: String,
        destination_span: Span,
    },
    MoveNotPossibleSingle(String, Span),
    CreateNotPossible(String, Span),
    ChangeAccessTimeNotPossible(String, Span),
    ChangeModifiedTimeNotPossible(String, Span),
    RemoveNotPossible(String, Span),
    NoFileToBeRemoved(),
    NoFileToBeMoved(),
    NoFileToBeCopied(),
    ReadingFile(String, Span),
    DidYouMean(String, Span),
    NonUtf8(Span),
    DowncastNotPossible(String, Span),
    UnsupportedConfigValue(String, String, Span),
    MissingConfigValue(String, Span),
    NeedsPositiveValue(Span),
    GenericError(String, String, Option<Span>, Option<String>, Vec<ShellError>),
    OutsideSpannedLabeledError(String, String, String, Span),
    DeprecatedCommand(String, String, Span),
    NonUnicodeInput,
    UnexpectedAbbrComponent(String),
}

The fundamental error type for the evaluation engine. These cases represent different kinds of errors the evaluator might face, along with helpful spans to label. An error renderer will take this error value and pass it into an error viewer to display to the user.

Variants

OperatorMismatch

Fields

op_span: Span

lhs_ty: Type

lhs_span: Span

rhs_ty: Type

rhs_span: Span

An operator received two arguments of incompatible types.

Resolution

Check each argument’s type and convert one or both as needed.

OperatorOverflow(String, Span)

An arithmetic operation’s resulting value overflowed its possible size.

Resolution

Check the inputs to the operation and add guards for their sizes. Integers are generally of size i64, floats are generally f64.

PipelineMismatch(String, Span, Span)

The pipelined input into a command was not of the expected type. For example, it might expect a string input, but received a table instead.

Resolution

Check the relevant pipeline and extract or convert values as needed.

TypeMismatch(String, Span)

A command received an argument of the wrong type.

Resolution

Convert the argument type before passing it in, or change the command to accept the type.

UnsupportedOperator(Operator, Span)

This value cannot be used with this operator.

Resolution

Not all values, for example custom values, can be used with all operators. Either implement support for the operator on this type, or convert the type to a supported one.

UnknownOperator(String, Span)

An operator was not recognized during evaluation.

Resolution

Did you write the correct operator?

MissingParameter(String, Span)

An expected command parameter is missing.

Resolution

Add the expected parameter and try again.

IncompatibleParameters

Fields

left_message: String

left_span: Span

right_message: String

right_span: Span

Two parameters conflict with each other or are otherwise mutually exclusive.

Resolution

Remove one of the parameters/options and try again.

DelimiterError(String, Span)

There’s some issue with number or matching of delimiters in an expression.

Resolution

Check your syntax for mismatched braces, RegExp syntax errors, etc, based on the specific error message.

IncompatibleParametersSingle(String, Span)

An operation received parameters with some sort of incompatibility (for example, different number of rows in a table, incompatible column names, etc).

Resolution

Refer to the specific error message for details on what’s incompatible and then fix your inputs to make sure they match that way.

FeatureNotEnabled(Span)

This build of nushell implements this feature, but it has not been enabled.

Resolution

Rebuild nushell with the appropriate feature enabled.

ExternalNotSupported(Span)

You’re trying to run an unsupported external command.

Resolution

Make sure there’s an appropriate run-external declaration for this external command.

InvalidProbability(Span)

The given probability input is invalid. The probability must be between 0 and 1.

Resolution

Make sure the probability is between 0 and 1 and try again.

InvalidRange(String, String, Span)

The first value in a .. range must be compatible with the second one.

Resolution

Check to make sure both values are compatible, and that the values are enumerable in Nushell.

NushellFailed(String)

Catastrophic nushell failure. This reflects a completely unexpected or unrecoverable error.

Resolution

It is very likely that this is a bug. Please file an issue at https://github.com/nushell/nushell/issues with relevant information.

NushellFailedSpanned(String, String, Span)

Catastrophic nushell failure. This reflects a completely unexpected or unrecoverable error.

Resolution

It is very likely that this is a bug. Please file an issue at https://github.com/nushell/nushell/issues with relevant information.

NushellFailedHelp(String, String)

Catastrophic nushell failure. This reflects a completely unexpected or unrecoverable error.

Resolution

It is very likely that this is a bug. Please file an issue at https://github.com/nushell/nushell/issues with relevant information.

NushellFailedSpannedHelp(String, String, Span, String)

Catastrophic nushell failure. This reflects a completely unexpected or unrecoverable error.

Resolution

It is very likely that this is a bug. Please file an issue at https://github.com/nushell/nushell/issues with relevant information.

VariableNotFoundAtRuntime(Span)

A referenced variable was not found at runtime.

Resolution

Check the variable name. Did you typo it? Did you forget to declare it? Is the casing right?

EnvVarNotFoundAtRuntime(String, Span)

A referenced environment variable was not found at runtime.

Resolution

Check the environment variable name. Did you typo it? Did you forget to declare it? Is the casing right?

ModuleNotFoundAtRuntime(String, Span)

A referenced module was not found at runtime.

Resolution

Check the module name. Did you typo it? Did you forget to declare it? Is the casing right?

ModuleOrOverlayNotFoundAtRuntime(String, Span)

A referenced module or overlay was not found at runtime.

Resolution

Check the module name. Did you typo it? Did you forget to declare it? Is the casing right?

OverlayNotFoundAtRuntime(String, Span)

A referenced overlay was not found at runtime.

Resolution

Check the overlay name. Did you typo it? Did you forget to declare it? Is the casing right?

NotFound(Span)

The given item was not found. This is a fairly generic error that depends on context.

Resolution

This error is triggered in various places, and simply signals that “something” was not found. Refer to the specific error message for further details.

CantConvert(String, String, Span, Option<String>)

Failed to convert a value of one type into a different type.

Resolution

Not all values can be coerced this way. Check the supported type(s) and try again.

EnvVarNotAString(String, Span)

An environment variable cannot be represented as a string.

Resolution

Not all types can be converted to environment variable values, which must be strings. Check the input type and try again.

DivisionByZero(Span)

Division by zero is not a thing.

Resolution

Add a guard of some sort to check whether a denominator input to this division is zero, and branch off if that’s the case.

CannotCreateRange(Span)

An error happened while tryin to create a range.

This can happen in various unexpected situations, for example if the range would loop forever (as would be the case with a 0-increment).

Resolution

Check your range values to make sure they’re countable and would not loop forever.

AccessBeyondEnd(usize, Span)

You attempted to access an index beyond the available length of a value.

Resolution

Check your lengths and try again.

AccessBeyondEndOfStream(Span)

You attempted to access an index beyond the available length of a stream.

Resolution

Check your lengths and try again.

IncompatiblePathAccess(String, Span)

Tried to index into a type that does not support pathed access.

Resolution

Check your types. Only composite types can be pathed into.

CantFindColumn(Span, Span)

The requested column does not exist.

Resolution

Check the spelling of your column name. Did you forget to rename a column somewhere?

ColumnAlreadyExists(Span, Span)

Attempted to insert a column into a table, but a column with that name already exists.

Resolution

Drop or rename the existing column (check rename -h) and try again.

NotAList(Span, Span)

The given operation can only be performed on lists.

Resolution

Check the input type to this command. Are you sure it’s a list?

ExternalCommand(String, String, Span)

An error happened while performing an external command.

Resolution

This error is fairly generic. Refer to the specific error message for further details.

UnsupportedInput(String, Span)

An operation was attempted with an input unsupported for some reason.

Resolution

This error is fairly generic. Refer to the specific error message for further details.

DatetimeParseError(Span)

Failed to parse an input into a datetime value.

Resolution

Make sure your datetime input format is correct.

For example, these are some valid formats:

• “5 pm”
• “2020/12/4”
• “2020.12.04 22:10 +2”
• “2020-04-12 22:10:57 +02:00”
• “2020-04-12T22:10:57.213231+02:00”
• “Tue, 1 Jul 2003 10:52:37 +0200”“#

NetworkFailure(String, Span)

A network operation failed.

Resolution

It’s always DNS.

CommandNotFound(Span)

Help text for this command could not be found.

Resolution

Check the spelling for the requested command and try again. Are you sure it’s defined and your configurations are loading correctly? Can you execute it?

FlagNotFound(String, Span)

A flag was not found.

FileNotFound(Span)

Failed to find a file during a nushell operation.

Resolution

Does the file in the error message exist? Is it readable and accessible? Is the casing right?

FileNotFoundCustom(String, Span)

Failed to find a file during a nushell operation.

Resolution

Does the file in the error message exist? Is it readable and accessible? Is the casing right?

PluginFailedToLoad(String)

A plugin failed to load.

Resolution

This is a failry generic error. Refer to the specific error message for further details.

PluginFailedToEncode(String)

A message from a plugin failed to encode.

Resolution

This is likely a bug with the plugin itself.

PluginFailedToDecode(String)

A message to a plugin failed to decode.

Resolution

This is either an issue with the inputs to a plugin (bad JSON?) or a bug in the plugin itself. Fix or report as appropriate.

IOError(String)

An I/O operation failed.

Resolution

This is a generic error. Refer to the specific error message for further details.

NotADirectory(Span)

Tried to cd to a path that isn’t a directory.

Resolution

Make sure the path is a directory. It currently exists, but is of some other type, like a file.

DirectoryNotFound(Span, Option<String>)

Attempted to perform an operation on a directory that doesn’t exist.

Resolution

Make sure the directory in the error message actually exists before trying again.

DirectoryNotFoundCustom(String, Span)

Attempted to perform an operation on a directory that doesn’t exist.

Resolution

Make sure the directory in the error message actually exists before trying again.

MoveNotPossible

Fields

source_message: String

source_span: Span

destination_message: String

destination_span: Span

The requested move operation cannot be completed. This is typically because both paths exist, but are of different types. For example, you might be trying to overwrite an existing file with a directory.

Resolution

Make sure the destination path does not exist before moving a directory.

MoveNotPossibleSingle(String, Span)

The requested move operation cannot be completed. This is typically because both paths exist, but are of different types. For example, you might be trying to overwrite an existing file with a directory.

Resolution

Make sure the destination path does not exist before moving a directory.

CreateNotPossible(String, Span)

Failed to create either a file or directory.

Resolution

This is a fairly generic error. Refer to the specific error message for further details.

ChangeAccessTimeNotPossible(String, Span)

Changing the access time (“atime”) of this file is not possible.

Resolution

This can be for various reasons, such as your platform or permission flags. Refer to the specific error message for more details.

ChangeModifiedTimeNotPossible(String, Span)

Changing the modification time (“mtime”) of this file is not possible.

Resolution

This can be for various reasons, such as your platform or permission flags. Refer to the specific error message for more details.

RemoveNotPossible(String, Span)

Unable to remove this item.

NoFileToBeRemoved()

NoFileToBeMoved()

NoFileToBeCopied()

ReadingFile(String, Span)

Error while trying to read a file

Resolution

The error will show the result from a file operation

DidYouMean(String, Span)

A name was not found. Did you mean a different name?

Resolution

The error message will suggest a possible match for what you meant.

NonUtf8(Span)

The given input must be valid UTF-8 for further processing.

Resolution

Check your input’s encoding. Are there any funny characters/bytes?

DowncastNotPossible(String, Span)

A custom value could not be converted to a Dataframe.

Resolution

Make sure conversion to a Dataframe is possible for this value or convert it to a type that does, first.

UnsupportedConfigValue(String, String, Span)

The value given for this configuration is not supported.

Resolution

Refer to the specific error message for details and convert values as needed.

MissingConfigValue(String, Span)

An expected configuration value is not present.

Resolution

Refer to the specific error message and add the configuration value to your config file as needed.

NeedsPositiveValue(Span)

Negative value passed when positive ons is required.

Resolution

Guard against negative values or check your inputs.

GenericError(String, String, Option<Span>, Option<String>, Vec<ShellError>)

This is a generic error type used for different situations.

OutsideSpannedLabeledError(String, String, String, Span)

This is a generic error type used for different situations.

DeprecatedCommand(String, String, Span)

Attempted to use a deprecated command.

Resolution

Check the help for the new suggested command and update your script accordingly.

NonUnicodeInput

Non-Unicode input received.

Resolution

Check that your path is UTF-8 compatible.

UnexpectedAbbrComponent(String)

Unexpected abbr component.

Resolution

Check the path abbreviation to ensure that it is valid.

Trait Implementations

impl Clone for ShellError

fn clone(&self) -> ShellError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ShellError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ShellError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Diagnostic for ShellError

fn code<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn help<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan>>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn related(&self) -> Option<Box<dyn Iterator<Item = &dyn Diagnostic>>>

Additional related Diagnostics.

fn url<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for ShellError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ShellError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Box<dyn Error + 'static, Global>> for ShellError

fn from(input: Box<dyn Error>) -> ShellError

Converts to this type from the input type.

impl From<Box<dyn Error + Send + Sync + 'static, Global>> for ShellError

fn from(input: Box<dyn Error + Send + Sync>) -> ShellError

Converts to this type from the input type.

impl From<Error> for ShellError

fn from(input: Error) -> ShellError

Converts to this type from the input type.

impl Serialize for ShellError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.