documents 0.1.2

An ergonomic, intuitive and beginner-friendly library for dealing with files and folders.
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

use std::{error::Error, fmt::Display};

/// This library's error types.
///
/// Note: functions in this library will not actually return this concrete error type.
/// Instead a Box<dyn Error> will be returned. Print it to the console to see a description of the error.
#[derive(Debug, Clone, PartialEq, Hash)]
pub enum DocumentError {
    /// "User directories not found"
    UserDirsNotFound,
    /// "Pictures directory not found"
    PicturesDirNotFound,
    /// "Videos directory not found"
    VideosDirNotFound,
    /// "Downloads directory not found"
    DownloadsDirNotFound,
    /// "Documents directory not found"
    DocumentsDirNotFound,
    /// "Project directories not found"
    ProjectDirsNotFound,
    /// "File not found: (file path)"
    FileNotFound(String),
    /// "Could not create file: (file path)"
    CouldNotCreateFile(String),
    /// "Could not create parent folder: (parent directory path)"
    CouldNotCreateParentFolder(String),
    /// "Could not launch file with default app: (file path)"
    CouldNotLaunchFile(String),
    /// "Could not open file: (file path)"
    CouldNotOpenFile(String),
    /// "File not writable: (file path)"
    FileNotWritable(String),
    /// "File not open: (file path)"
    FileNotOpen(String),
}

impl Display for DocumentError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let msg: String = match self {
            Self::UserDirsNotFound => "User directories not found".to_string(),
            Self::PicturesDirNotFound => "Pictures directory not found".to_string(),
            Self::VideosDirNotFound => "Videos directory not found".to_string(),
            Self::DownloadsDirNotFound => "Downloads directory not found".to_string(),
            Self::FileNotFound(file_path) => "File not found: ".to_string() + file_path,
            Self::CouldNotCreateFile(file_path) => {
                "Could not create file: ".to_string() + file_path
            }
            Self::CouldNotCreateParentFolder(parent_folder_path) => {
                "Could not create parent folder: ".to_string() + parent_folder_path
            }
            Self::CouldNotLaunchFile(file_path) => {
                "Could not launch file with default app: ".to_string() + file_path
            }
            Self::ProjectDirsNotFound => "Project directories not found".to_string(),
            Self::CouldNotOpenFile(file_path) => "Could not open file: ".to_string() + file_path,
            Self::DocumentsDirNotFound => "Documents directory not found".to_string(),
            Self::FileNotWritable(file_path) => "File not writable: ".to_string() + file_path,
            Self::FileNotOpen(file_path) => "File not open: ".to_string() + file_path,
        };
        f.pad(msg.as_str())
    }
}

impl Error for DocumentError {
    fn description(&self) -> &str {
        "Document error"
    }
}