parallel-disk-usage 0.23.0

Highly parallelized, blazing fast directory tree analyzer
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

use derive_more::{Display, Error};
use std::{convert::Infallible, process::ExitCode};

/// Error caused by the CLI program.
#[derive(Debug, Display, Error)]
#[non_exhaustive]
pub enum RuntimeError {
    /// When it fails to write JSON representation of
    /// [DataTreeReflection](crate::data_tree::Reflection) to stdout.
    #[display("SerializationFailure: {_0}")]
    SerializationFailure(serde_json::Error),
    /// When it fails to read JSON representation of
    /// [DataTreeReflection](crate::data_tree::Reflection) from stdin.
    #[display("DeserializationFailure: {_0}")]
    DeserializationFailure(serde_json::Error),
    /// When `--json-input` and file names are both specified.
    #[display("JsonInputArgConflict: Arguments exist alongside --json-input")]
    JsonInputArgConflict,
    /// When input JSON data is not a valid tree.
    #[display("InvalidInputReflection: {_0}")]
    InvalidInputReflection(#[error(not(source))] String),
    /// When the user attempts to use unavailable platform-specific features.
    #[display("UnsupportedFeature: {_0}")]
    UnsupportedFeature(UnsupportedFeature),
}

/// Error caused by the user attempting to use unavailable platform-specific features.
#[derive(Debug, Display, Error)]
#[non_exhaustive]
pub enum UnsupportedFeature {
    /// Using `--deduplicate-hardlinks` on non-POSIX.
    #[cfg(not(unix))]
    #[display("Feature --deduplicate-hardlinks is not available on this platform")]
    DeduplicateHardlink,
    /// Using `--one-file-system` on non-POSIX.
    #[cfg(not(unix))]
    #[display("Feature --one-file-system is not available on this platform")]
    OneFileSystem,
}

impl From<Infallible> for RuntimeError {
    fn from(value: Infallible) -> Self {
        match value {}
    }
}

impl RuntimeError {
    /// Convert error into exit code.
    pub fn code(&self) -> ExitCode {
        ExitCode::from(match self {
            RuntimeError::SerializationFailure(_) => 2,
            RuntimeError::DeserializationFailure(_) => 3,
            RuntimeError::JsonInputArgConflict => 4,
            RuntimeError::InvalidInputReflection(_) => 5,
            RuntimeError::UnsupportedFeature(_) => 6,
        })
    }
}