sapling-streampager 0.12.0

streampager is a pager for command output or large files
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

//! Errors specific to keymaps.

use std::path::{Path, PathBuf};

use thiserror::Error;

/// Errors specific to keymaps.
#[derive(Debug, Error)]
pub enum KeymapError {
    /// Error when encountering an unknown modifier.
    #[error("unknown modifier: {0}")]
    UnknownModifier(String),

    /// Error when a key definition is missing.
    #[error("key definition missing")]
    MissingDefinition,

    /// Error when a keymap is missing.
    #[error("keymap not found: {0}")]
    MissingKeymap(String),

    /// Error when a key is unrecognised.
    #[error("unrecognised key: {0}")]
    UnknownKey(String),

    /// Parsing error.
    #[cfg(feature = "keymap-file")]
    #[error("parse error: {0}")]
    Parse(#[from] pest::error::Error<crate::keymap_file::Rule>),

    /// Error related to parsing a binding within a keymap.
    #[error("keybinding error")]
    Binding(#[from] crate::bindings::BindingError),

    /// Wrapped error within the context of a file.
    #[error("error loading file '{file}'")]
    WithFile {
        /// Wrapped error.
        #[source]
        error: Box<KeymapError>,

        /// File the error is about.
        file: PathBuf,
    },
}

impl KeymapError {
    #[allow(unused)]
    pub(crate) fn with_file(self, file: impl AsRef<Path>) -> Self {
        Self::WithFile {
            error: Box::new(self),
            file: file.as_ref().to_owned(),
        }
    }
}

pub(crate) type Result<T> = std::result::Result<T, KeymapError>;