car-utils 0.2.0

This crate is the ipfs car file reader writer and utils.
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

# car-utils

The project is utils of CAR file which used in WASM runtime.

if you wanna lean about WASM runtime, please vist "https://github.com/blocklessnetwork/runtime/".

## How to intsall.

use cargo install to install the command

```
cargo install car-utils
```

car-utils install in the cargo bin directory.

## How to use.

execute the command `car-utils --help` to show the command help.

```
Usage: car-utils <COMMAND>

Commands:
  ar    Archive local file system to a car file
  cat   View cid content from a car file
  ls    List the car files
  cid   List the car cid
  ex    Extract the car files
  help  Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version
```

###  ar subcommand

archive the local directory to the car file.

```
Archive local file system to a car file

Usage: car-utils ar -c <CAR> -s <SOURCE>

Options:
  -c <CAR>         the car file for archive.
  -s <SOURCE>      the source directory to be archived.
  -h, --help       Print help
```

###  ls subcommand

list file structures in the car file.

```
List the car files

Usage: car-utils ls <CAR>

Arguments:
  <CAR>  the car file for list.

Options:
  -h, --help  Print help
```

####  cid subcommand

list file cids in the car file.

```
List the car cid

Usage: car-utils cid <CAR>

Arguments:
  <CAR>  the car file for list.

Options:
  -h, --help  Print help
```

### ex subcommand

extract the files in the car file to the target directory.

```
Extract the car files

Usage: car-utils ex [OPTIONS] -c <CAR>

Options:
  -c <CAR>         The car file to extract
  -t <TARGET>      Target directory to extract to
  -h, --help       Print help
```

####  cat subcommand

cat cid content from a car file.

```
View cid content from a car file

Usage: car-utils cat -c <CID> <CAR>

Arguments:
  <CAR>  the car file to cat.

Options:
  -c <CID>      the cid of content to cat.
  -h, --help    Print help
```