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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

/*!
# Path Permission

在已有一个确定的路径时，可依此库来获取路径文件的权限。
它为`Path(Buf)`提供了一个名为`PathPermission`的特性（trait），在使用`Path`类型
时，可以此获取其文件权限，是否可读（r）、可写（w）、可执行（x）。  
目前只支持 *Unix* 类系统。

## 示例
```rust
use std::path::Path;

extern crate path_permission;

use path_permission::*;

let path = Path::new("src/lib.rs");

assert_eq!(path.is_readable().unwrap(), true);
assert_eq!(path.is_writable().unwrap(), true);
assert_eq!(path.is_excutable().unwrap(), false);
assert_eq!(path.is_removable().unwrap(), true);

assert_eq!(path.check_access(0o644).unwrap(), true);
assert_eq!(path.get_access().unwrap(), "0644");

assert_eq!(path.chmod(0o640).unwrap(), true);
// 注意，这里已经格式化为字符串
assert_eq!(path.get_access().unwrap(), "0640");
assert_eq!(path.chmod(0o644).unwrap(), true);

let new_path = Path::new("a/b/d/e/f");

assert_eq!(new_path.is_creatable().unwrap(), true);
```
  
## 注意
在使用时需注意：  
  * 当返回值为Ok(false)时，意为无查看此路径的权限，即可能此路径不存在（从起始
路径开始，至无访问权限的子级路径，是存在的）。  
  * 如无必须，不太建议使用相对路径，可使用
[path-calculate](https://crates.io/crates/path-calculate)将路径转换为绝对路径。  
  * get_access() 所返回的权限已被格式化为字符串。  
  
## 后续计划
计划支持 rwx 字符串输出、权限变更方法。  
  
## 感谢
此项目部分代码，来源自项目[permissions](https://crates.io/crates/permissions)。  

*/
#[cfg(unix)]
pub mod unix;

#[cfg(unix)]
pub use unix::*;

//TODO Windows