just/src/error.rs

435 lines
14 KiB
Rust
Raw Normal View History

use super::*;
#[derive(Debug)]
pub(crate) enum Error<'src> {
ArgumentCountMismatch {
recipe: &'src str,
parameters: Vec<Parameter<'src>>,
found: usize,
min: usize,
max: usize,
},
Backtick {
token: Token<'src>,
output_error: OutputError,
},
ChooserInvoke {
shell_binary: String,
shell_arguments: String,
chooser: OsString,
io_error: io::Error,
},
ChooserRead {
chooser: OsString,
io_error: io::Error,
},
ChooserStatus {
chooser: OsString,
status: ExitStatus,
},
ChooserWrite {
chooser: OsString,
io_error: io::Error,
},
2023-01-12 19:25:28 -08:00
CircularInclude {
current: PathBuf,
include: PathBuf,
},
Code {
recipe: &'src str,
line_number: Option<usize>,
code: i32,
print_message: bool,
},
CommandInvoke {
binary: OsString,
arguments: Vec<OsString>,
io_error: io::Error,
},
CommandStatus {
binary: OsString,
arguments: Vec<OsString>,
status: ExitStatus,
},
Compile {
compile_error: CompileError<'src>,
},
Config {
config_error: ConfigError,
},
Cygpath {
recipe: &'src str,
output_error: OutputError,
},
DefaultRecipeRequiresArguments {
recipe: &'src str,
min_arguments: usize,
},
Dotenv {
2022-12-14 20:32:27 -08:00
dotenv_error: dotenvy::Error,
},
2021-11-17 00:07:48 -08:00
DumpJson {
serde_json_error: serde_json::Error,
},
EditorInvoke {
editor: OsString,
io_error: io::Error,
},
EditorStatus {
editor: OsString,
status: ExitStatus,
},
EvalUnknownVariable {
variable: String,
suggestion: Option<Suggestion<'src>>,
},
FormatCheckFoundDiff,
FunctionCall {
function: Name<'src>,
message: String,
},
2023-11-16 15:51:34 -08:00
GetConfirmation {
io_error: io::Error,
},
InitExists {
justfile: PathBuf,
},
Internal {
message: String,
},
Io {
recipe: &'src str,
io_error: io::Error,
},
Load {
path: PathBuf,
io_error: io::Error,
},
NoChoosableRecipes,
NoRecipes,
2023-11-16 15:51:34 -08:00
NotConfirmed {
recipe: &'src str,
},
RegexCompile {
source: regex::Error,
},
Search {
search_error: SearchError,
},
Shebang {
recipe: &'src str,
command: String,
argument: Option<String>,
io_error: io::Error,
},
Signal {
recipe: &'src str,
line_number: Option<usize>,
signal: i32,
},
TmpdirIo {
recipe: &'src str,
io_error: io::Error,
},
Unknown {
recipe: &'src str,
line_number: Option<usize>,
},
UnknownOverrides {
overrides: Vec<String>,
},
UnknownRecipes {
recipes: Vec<String>,
suggestion: Option<Suggestion<'src>>,
},
Unstable {
message: String,
},
WriteJustfile {
justfile: PathBuf,
io_error: io::Error,
},
}
impl<'src> Error<'src> {
pub(crate) fn code(&self) -> Option<i32> {
match self {
Self::Code { code, .. }
| Self::Backtick {
output_error: OutputError::Code(code),
..
} => Some(*code),
Self::ChooserStatus { status, .. } | Self::EditorStatus { status, .. } => status.code(),
_ => None,
}
}
fn context(&self) -> Option<Token<'src>> {
match self {
Self::Backtick { token, .. } => Some(*token),
Self::Compile { compile_error } => Some(compile_error.context()),
Self::FunctionCall { function, .. } => Some(function.token()),
_ => None,
}
}
pub(crate) fn internal(message: impl Into<String>) -> Self {
Self::Internal {
message: message.into(),
}
}
pub(crate) fn print_message(&self) -> bool {
!matches!(
self,
Error::Code {
print_message: false,
..
}
)
}
}
impl<'src> From<CompileError<'src>> for Error<'src> {
fn from(compile_error: CompileError<'src>) -> Self {
Self::Compile { compile_error }
}
}
impl<'src> From<ConfigError> for Error<'src> {
fn from(config_error: ConfigError) -> Self {
Self::Config { config_error }
}
}
2022-12-14 20:32:27 -08:00
impl<'src> From<dotenvy::Error> for Error<'src> {
fn from(dotenv_error: dotenvy::Error) -> Error<'src> {
Self::Dotenv { dotenv_error }
}
}
impl<'src> From<SearchError> for Error<'src> {
fn from(search_error: SearchError) -> Self {
Self::Search { search_error }
}
}
impl<'src> ColorDisplay for Error<'src> {
fn fmt(&self, f: &mut Formatter, color: Color) -> fmt::Result {
use Error::*;
2023-10-16 20:18:25 -07:00
let error = color.error().paint("error");
let message = color.message().prefix();
write!(f, "{error}: {message}")?;
match self {
2023-10-16 20:18:25 -07:00
ArgumentCountMismatch { recipe, found, min, max, .. } => {
let count = Count("argument", *found);
if min == max {
let expected = min;
2023-10-16 20:18:25 -07:00
let only = if expected < found { "only " } else { "" };
write!(f, "Recipe `{recipe}` got {found} {count} but {only}takes {expected}")?;
} else if found < min {
2023-10-16 20:18:25 -07:00
write!(f, "Recipe `{recipe}` got {found} {count} but takes at least {min}")?;
} else if found > max {
2023-10-16 20:18:25 -07:00
write!(f, "Recipe `{recipe}` got {found} {count} but takes at most {max}")?;
}
}
Backtick { output_error, .. } => match output_error {
2023-10-16 20:18:25 -07:00
OutputError::Code(code) => write!(f, "Backtick failed with exit code {code}")?,
OutputError::Signal(signal) => write!(f, "Backtick was terminated by signal {signal}")?,
OutputError::Unknown => write!(f, "Backtick failed for an unknown reason")?,
OutputError::Io(io_error) => match io_error.kind() {
io::ErrorKind::NotFound => write!(f, "Backtick could not be run because just could not find the shell:\n{io_error}"),
io::ErrorKind::PermissionDenied => write!(f, "Backtick could not be run because just could not run the shell:\n{io_error}"),
_ => write!(f, "Backtick could not be run because of an IO error while launching the shell:\n{io_error}"),
}?,
OutputError::Utf8(utf8_error) => write!(f, "Backtick succeeded but stdout was not utf8: {utf8_error}")?,
}
ChooserInvoke { shell_binary, shell_arguments, chooser, io_error} => {
let chooser = chooser.to_string_lossy();
write!(f, "Chooser `{shell_binary} {shell_arguments} {chooser}` invocation failed: {io_error}")?;
}
ChooserRead { chooser, io_error } => {
2023-10-16 20:18:25 -07:00
let chooser = chooser.to_string_lossy();
write!(f, "Failed to read output from chooser `{chooser}`: {io_error}")?;
}
ChooserStatus { chooser, status } => {
2023-10-16 20:18:25 -07:00
let chooser = chooser.to_string_lossy();
write!(f, "Chooser `{chooser}` failed: {status}")?;
}
ChooserWrite { chooser, io_error } => {
2023-10-16 20:18:25 -07:00
let chooser = chooser.to_string_lossy();
write!(f, "Failed to write to chooser `{chooser}`: {io_error}")?;
}
2023-01-12 19:25:28 -08:00
CircularInclude { current, include } => {
2023-10-16 20:18:25 -07:00
let include = include.display();
let current = current.display();
write!(f, "Include `{include}` in `{current}` is a circular include")?;
}
Code { recipe, line_number, code, .. } => {
if let Some(n) = line_number {
2023-10-16 20:18:25 -07:00
write!(f, "Recipe `{recipe}` failed on line {n} with exit code {code}")?;
} else {
2022-12-15 16:53:21 -08:00
write!(f, "Recipe `{recipe}` failed with exit code {code}")?;
}
}
2023-10-16 20:18:25 -07:00
CommandInvoke { binary, arguments, io_error } => {
let cmd = format_cmd(binary, arguments);
write!(f, "Failed to invoke {cmd}: {io_error}")?;
}
CommandStatus { binary, arguments, status} => {
let cmd = format_cmd(binary, arguments);
write!(f, "Command {cmd} failed: {status}")?;
}
Compile { compile_error } => Display::fmt(compile_error, f)?,
Config { config_error } => Display::fmt(config_error, f)?,
2023-10-16 20:18:25 -07:00
Cygpath { recipe, output_error} => match output_error {
OutputError::Code(code) => write!(f, "Cygpath failed with exit code {code} while translating recipe `{recipe}` shebang interpreter path")?,
OutputError::Signal(signal) => write!(f, "Cygpath terminated by signal {signal} while translating recipe `{recipe}` shebang interpreter path")?,
OutputError::Unknown => write!(f, "Cygpath experienced an unknown failure while translating recipe `{recipe}` shebang interpreter path")?,
OutputError::Io(io_error) => {
match io_error.kind() {
2023-10-16 20:18:25 -07:00
io::ErrorKind::NotFound => write!(f, "Could not find `cygpath` executable to translate recipe `{recipe}` shebang interpreter path:\n{io_error}"),
io::ErrorKind::PermissionDenied => write!(f, "Could not run `cygpath` executable to translate recipe `{recipe}` shebang interpreter path:\n{io_error}"),
2022-12-15 16:53:21 -08:00
_ => write!(f, "Could not run `cygpath` executable:\n{io_error}"),
}?;
}
2023-10-16 20:18:25 -07:00
OutputError::Utf8(utf8_error) => write!(f, "Cygpath successfully translated recipe `{recipe}` shebang interpreter path, but output was not utf8: {utf8_error}")?,
}
DefaultRecipeRequiresArguments { recipe, min_arguments} => {
let count = Count("argument", *min_arguments);
write!(f, "Recipe `{recipe}` cannot be used as default recipe since it requires at least {min_arguments} {count}.")?;
}
Dotenv { dotenv_error } => {
2022-12-15 16:53:21 -08:00
write!(f, "Failed to load environment file: {dotenv_error}")?;
}
2021-11-17 00:07:48 -08:00
DumpJson { serde_json_error } => {
2022-12-15 16:53:21 -08:00
write!(f, "Failed to dump JSON to stdout: {serde_json_error}")?;
2021-11-17 00:07:48 -08:00
}
EditorInvoke { editor, io_error } => {
2023-10-16 20:18:25 -07:00
let editor = editor.to_string_lossy();
write!(f, "Editor `{editor}` invocation failed: {io_error}")?;
}
EditorStatus { editor, status } => {
2023-10-16 20:18:25 -07:00
let editor = editor.to_string_lossy();
write!(f, "Editor `{editor}` failed: {status}")?;
}
2023-10-16 20:18:25 -07:00
EvalUnknownVariable { variable, suggestion} => {
2022-12-15 16:53:21 -08:00
write!(f, "Justfile does not contain variable `{variable}`.")?;
2023-10-16 20:18:25 -07:00
if let Some(suggestion) = suggestion {
2022-12-15 16:53:21 -08:00
write!(f, "\n{suggestion}")?;
}
}
FormatCheckFoundDiff => {
write!(f, "Formatted justfile differs from original.")?;
}
FunctionCall { function, message } => {
2023-10-16 20:18:25 -07:00
let function = function.lexeme();
write!(f, "Call to function `{function}` failed: {message}")?;
}
2023-11-16 15:51:34 -08:00
GetConfirmation { io_error } => {
write!(f, "Failed to read confirmation from stdin: {io_error}")?;
}
InitExists { justfile } => {
write!(f, "Justfile `{}` already exists", justfile.display())?;
}
Internal { message } => {
2023-10-16 20:18:25 -07:00
write!(f, "Internal runtime error, this may indicate a bug in just: {message} \
consider filing an issue: https://github.com/casey/just/issues/new")?;
}
Io { recipe, io_error } => {
match io_error.kind() {
2023-10-16 20:18:25 -07:00
io::ErrorKind::NotFound => write!(f, "Recipe `{recipe}` could not be run because just could not find the shell: {io_error}"),
io::ErrorKind::PermissionDenied => write!(f, "Recipe `{recipe}` could not be run because just could not run the shell: {io_error}"),
_ => write!(f, "Recipe `{recipe}` could not be run because of an IO error while launching the shell: {io_error}"),
}?;
}
Load { io_error, path } => {
2023-10-16 20:18:25 -07:00
let path = path.display();
write!(f, "Failed to read justfile at `{path}`: {io_error}")?;
}
2023-10-16 20:18:25 -07:00
NoChoosableRecipes => write!(f, "Justfile contains no choosable recipes.")?,
NoRecipes => write!(f, "Justfile contains no recipes.")?,
2023-11-16 15:51:34 -08:00
NotConfirmed { recipe } => {
write!(f, "Recipe `{recipe}` was not confirmed")?;
}
2023-10-16 20:18:25 -07:00
RegexCompile { source } => write!(f, "{source}")?,
Search { search_error } => Display::fmt(search_error, f)?,
2023-10-16 20:18:25 -07:00
Shebang { recipe, command, argument, io_error} => {
if let Some(argument) = argument {
2023-10-16 20:18:25 -07:00
write!(f, "Recipe `{recipe}` with shebang `#!{command} {argument}` execution error: {io_error}")?;
} else {
2023-10-16 20:18:25 -07:00
write!(f, "Recipe `{recipe}` with shebang `#!{command}` execution error: {io_error}")?;
}
}
2023-10-16 20:18:25 -07:00
Signal { recipe, line_number, signal } => {
if let Some(n) = line_number {
2023-10-16 20:18:25 -07:00
write!(f, "Recipe `{recipe}` was terminated on line {n} by signal {signal}")?;
} else {
2022-12-15 16:53:21 -08:00
write!(f, "Recipe `{recipe}` was terminated by signal {signal}")?;
}
}
2023-10-16 20:18:25 -07:00
TmpdirIo { recipe, io_error } => {
write!(f, "Recipe `{recipe}` could not be run because of an IO error while trying to create a temporary \
directory or write a file to that directory`:{io_error}")?;
}
Unknown { recipe, line_number} => {
if let Some(n) = line_number {
2023-10-16 20:18:25 -07:00
write!(f, "Recipe `{recipe}` failed on line {n} for an unknown reason")?;
} else {
2022-12-15 16:53:21 -08:00
write!(f, "Recipe `{recipe}` failed for an unknown reason")?;
}
}
UnknownOverrides { overrides } => {
2023-10-16 20:18:25 -07:00
let count = Count("Variable", overrides.len());
let overrides = List::and_ticked(overrides);
write!(f, "{count} {overrides} overridden on the command line but not present in justfile")?;
}
UnknownRecipes { recipes, suggestion } => {
let count = Count("recipe", recipes.len());
let recipes = List::or_ticked(recipes);
write!(f, "Justfile does not contain {count} {recipes}.")?;
if let Some(suggestion) = suggestion {
2022-12-15 16:53:21 -08:00
write!(f, "\n{suggestion}")?;
}
}
Unstable { message } => {
2023-10-16 20:18:25 -07:00
write!(f, "{message} Invoke `just` with the `--unstable` flag to enable unstable features.")?;
}
WriteJustfile { justfile, io_error } => {
2023-10-16 20:18:25 -07:00
let justfile = justfile.display();
write!(f, "Failed to write justfile to `{justfile}`: {io_error}")?;
}
}
write!(f, "{}", color.message().suffix())?;
if let ArgumentCountMismatch {
recipe, parameters, ..
} = self
{
writeln!(f)?;
2023-06-12 09:53:55 -07:00
write!(f, "{}:\n just {recipe}", color.message().paint("usage"))?;
for param in parameters {
write!(f, " {}", param.color_display(color))?;
}
}
if let Some(token) = self.context() {
writeln!(f)?;
write!(f, "{}", token.color_display(color.error()))?;
}
Ok(())
}
}
2023-10-16 20:18:25 -07:00
fn format_cmd(binary: &OsString, arguments: &Vec<OsString>) -> String {
iter::once(binary)
.chain(arguments)
.map(|value| Enclosure::tick(value.to_string_lossy()).to_string())
.collect::<Vec<String>>()
.join(" ")
}