unix_permissions_ext 0.1.2

A trivial trait bringing missing functions that are not exposed by PermissionsExt to Permissions on UNIX platforms.
Documentation
  • Coverage
  • 100%
    29 out of 29 items documented0 out of 27 items with examples
  • Size
  • Source code size: 32.02 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 1.09 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Links
  • SteveLauC/UNIXPermissionsExt
    0 0 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • SteveLauC

UNIXPermissionsExt

BUILD crates.io docs.rs

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;
    fn stringify(&self) -> 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;
    use unix_permissions_ext::UNIXPermissionsExt;
    
    let metadata = metadata("/usr/bin/passwd").expect("can not fetch metadata");
    let permission = metadata.permissions();
    
    assert!(permission.set_uid());
    println!("Permission: {}", permission.stringify());
    
  3. To use these functions directly with the mode_t type, consider importing raw_fn module:

    use unix_permissions_ext::raw_fn::*;
    

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
    
  2. Format your code

    $ cargo fmt