imagecli 0.2.1

A command line image processing tool.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

//! The standard error and result types used in this library.

use snafu::Snafu;
use std::path::PathBuf;

/// The standard result type used in this library.
pub type Result<T> = std::result::Result<T, ImageCliError>;

/// The standard error type used in this library.
#[allow(missing_docs)]
#[derive(Debug, Snafu)]
#[snafu(visibility(pub(crate)))]
pub enum ImageCliError {
    /// An error when attempting to open an image file.
    #[snafu(display("Unable to open image '{}': {}", path.display(), source))]
    ImageOpenError {
        path: PathBuf,
        source: image::ImageError,
    },

    /// An error when attempting to save an image.
    #[snafu(display("Unable to save image to '{}': {}", path.display(), source))]
    ImageSaveError {
        path: PathBuf,
        source: std::io::Error,
    },

    /// A generic IO error, with an ad-hoc context.
    #[snafu(display("{}: {}", context, source))]
    IoError {
        context: String,
        source: std::io::Error,
    },

    /// A generic Fmt error.
    FmtError { source: std::fmt::Error },

    /// An error when attempting to parse a pipeline.
    #[snafu(display(
        "Unable to parse pipeline.\n\nConsumed: '{}'\nRemaining: '{}'\n\nThe error is likely near the start of the remaining (unparsed) text.",
        consumed,
        remaining)
    )]
    PipelineParseError { consumed: String, remaining: String },

    /// An issue with a user-provided glob pattern.
    #[snafu(display("Invalid glob pattern '{}'. {}", pattern, source))]
    GlobPatternError {
        pattern: String,
        source: glob::PatternError,
    },

    /// An error when iterating files matching a glob.
    #[snafu(display("Error iterating glob results. Path: {:?}. Error: {}", source.path(), source.error()))]
    GlobIterationError { source: glob::GlobError },

    /// A user-provided output path or pattern is invalid.
    #[snafu(display("Invalid output path or pattern: {}", error))]
    OutputPathError { error: String },

    /// An error from any other issue with user-provided arguments.
    #[snafu(display("{}", context))]
    InvalidArgError { context: String },
}

impl From<std::fmt::Error> for ImageCliError {
    fn from(error: std::fmt::Error) -> Self {
        ImageCliError::FmtError { source: error }
    }
}