fmodeparser 0.1.0

A tool to parse the file permission into a unix-like text representation
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

use crate::FullPermission;
use std::error::Error;
use std::fs::Metadata;
use std::os::unix::fs::MetadataExt;

/// this trait is used as an extension on [Metadata](Metadata) to parse the permission of a file.
pub trait PermStrParser {
    /// converts the permission number into a string representation.
    /// # Example
    /// ```
    /// use std::fs::Metadata;
    /// use std::os::unix::fs::MetadataExt;
    /// use std::path::Path;
    /// use fmodeparser::PermStrParser;
    ///
    /// let path = Path::new("out.txt");
    /// let permission = path.convert_permission_to_string()?;
    /// assert_eq!(permission, "-rw-r--r--");
    ///
    /// ```
    fn convert_permission_to_string(&self) -> Result<String, Box<dyn Error>>;
}

impl PermStrParser for Metadata {
    fn convert_permission_to_string(&self) -> Result<String, Box<dyn Error>> {
        let mode = self.mode();
        let permission = FullPermission::new(mode)?;
        Ok(permission.to_string())
    }
}