alpm-mtree 0.2.1

Library and commandline toolkit for the specification, writing and parsing of ALPM .MTREE files
Documentation 
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

# alpm-mtree

## Documentation

- <https://alpm.archlinux.page/rustdoc/alpm_mtree/> for development version of the crate
- <https://docs.rs/alpm-mtree/latest/alpm_mtree/> for released versions of the crate

## Examples

### Library

```rust
use alpm_mtree::mtree::v2::parse_mtree_v2;

let data = r#"#mtree
/set mode=644 uid=0 gid=0 type=file
./some_file time=1700000000.0 size=1337 sha256digest=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
./some_link type=link link=some_file time=1700000000.0
./some_dir type=dir time=1700000000.0
"#.to_string();

assert!(parse_mtree_v2(data).is_ok());
```

### Commandline

Validate an `.MTREE` file.

```shell
alpm-mtree validate path/to/file
```

Parse an `.MTREE` file and output its contents as structured data.

```shell
alpm-mtree format ~/.cache/alpm/testing/packages/core/argon2-20190702-6-x86_64/.MTREE --output-format json --pretty
```

## Features

- `cli` adds the commandline handling needed for the `alpm-mtree` binary (enabled by default).
- `creation` adds library support for the creation of [ALPM-MTREE] files (enabled by default).
- `winnow-debug` enables the `winnow/debug` feature, which shows the exact parsing process of winnow.

## Contributing

Please refer to the [contribution guidelines] to learn how to contribute to this project.

## License

This project can be used under the terms of the [Apache-2.0] or [MIT].
Contributions to this project, unless noted otherwise, are automatically licensed under the terms of both of those licenses.

[contribution guidelines]: ../CONTRIBUTING.md
[ALPM-MTREE]: https://alpm.archlinux.page/specifications/ALPM-MTREE.5.html
[Apache-2.0]: ../LICENSES/Apache-2.0.txt
[MIT]: ../LICENSES/MIT.txt