Crate permissions

Permissions crate

Useful filesystem queries for file permissions:

See functions.

• is_executable
• is_readable
• is_writable
• is_removable
• is_creatable

Cross-platform

This is expected to work with Windows as well, but it was only tested in Unix machines. (PR welcome! Need someone to test it and update this section).

Examples:

use permissions::*;

fn main() -> std::io::Result<()> {
   // Functions accept `AsRef<Path>`
   assert!(is_readable("src/")?);
   assert!(is_writable("src/")?);
   assert!(is_writable("src/lib.rs")?);
   assert!(is_executable("/usr/bin/cat")?);
   assert!(is_removable("src/lib.rs")?);
   assert!(is_creatable("src/file.rs")?);

   Ok(())
}

Future

For this crate I plan on adding a nicer and convenient rwx bitmask interface, in the 0.4 version.

If you’re interested in this implemented, open an issue and I’ll try to complete it sooner.

I haven’t finished it yet beucase I’ve never needed this functionality, the existing functions were enough for my use cases.

(Part of the code for rwx and (Owner | Group | Other) permissions bitflags are already available at the project’s repository)

Helping/Contributing:

It’s easy to contribute to this crate, here are some options:

• Share it to a friend.
• Help improve this README or other docs (even little details).
• Open an issue or PR in the repository.
• Use it and give feedback.
• Suggest how to improve.

Re-exports

pub use functions::*;

Modules

functions

Functions for checking permissions at a path using the access_syscall.