unix_permissions_ext 0.1.1

UNIXPermissionsExt

A trivial trait bringing missing functions that are not exposed by std::os::unix::fs::PermissionsExt to std::fs::Permissions on UNIX platforms.

pub trait UNIXPermissionsExt {
    fn set_uid(&self) -> bool;
    fn set_gid(&self) -> bool;
    fn sticky_bit(&self) -> bool;

    fn readable_by_owner(&self) -> bool;
    fn writable_by_owner(&self) -> bool;
    fn executable_by_owner(&self) -> bool;

    fn readable_by_group(&self) -> bool;
    fn writable_by_group(&self) -> bool;
    fn executable_by_group(&self) -> bool;

    fn readable_by_other(&self) -> bool;
    fn writable_by_other(&self) -> bool;
    fn executable_by_other(&self) -> bool;
  
    #[cfg(feature = "to-string")]
    fn to_string() -> String;
}

impl UNIXPermissionsExt for Permissions {
    ...
}

Usage

1. Add it to your dependency:

   $ cd $YOUR_PROJECT
   $ cargo add unix_permissions_ext
   

2. Import this trait and use it just like you are using the standard library!

   use std::fs::{metadata, Permissions};
   use unix_permissions_ext::UNIXPermissionsExt;
   
   let metadata = metadata("/usr/bin/passwd").expect("can not fetch metadata");
   let permission = metadata.permissions();
   
   assert!(permission.set_uid());
   

3. If you have feature to-string enabled, you can also use to_string() to convert Permissions into a string, just like the one printed by ls(1)

   # Cargo.toml
   
   [dependencies]
   unix_permissions_ext = { version = "x.x.x", features = ["to-string"] }
   

   let permission_str = <Permissions as UNIXPermissionsExt>::to_string(&permission);
   println!("{}", permission_str);
   

Contributing

Contributions of all forms are welcome, feel free to file an issue or make a pull request!

Test before your commit

1. Pass the tests

   $ cargo test --features "to-string"
   

2. Format your code

   $ cargo fmt