![Latest Version] ![Documentation] ![License]

Decode Unix file mode bits, change them and apply them to files.

All file type, special and protection bits described in sys/stat.h are represented.

The Mode object can represent a file mode partially by the use of a bitmask. Only modified bits will be changed in the target file. Modifications specific only to directories (search) are handled correctly.

```rust use std::path::Path; use file_mode::{ModePath, User};

let mode = Path::new("LICENSE").mode().unwrap();

// query bits assert!(mode.filetype().unwrap().isregularfile()); assert!(mode.userprotection(User::Owner).isreadset()); assert!(mode.userprotection(User::Group).iswriteset()); assert!(!mode.userprotection(User::Other).isexecuteset());

// print as string println!("{}", mode); // -rw-rw-r-- asserteq!(&mode.tostring(), "-rw-rw-r--");

// apply chmod string Path::new("LICENSE").set_mode("u+r,g+u").unwrap(); ```

See module level documentation on [docs.rs] for more examples.