claptrap 0.3.0

Bring the power of Clap to shell scripts.
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# A toy `pacman` command

The example `bash` script `pacman.sh` reads the app spec from `spec.toml` or `spec.yaml`.

## Usage examples

Show help:

```shell
./pacman.sh --help
package manager utility

Usage: pacman <COMMAND>

Commands:
  query, -Q, --query  Query the package database.
  sync, -S, --sync    Synchronize packages.
  help                Print this message or the help of the given subcommand(s)

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

Show help for the `query` subcommand:

```shell
./pacman.sh query --help
Query the package database.

Usage: {query|--query|-Q} [OPTIONS]

Options:
  -s, --search <search>...  search locally installed packages for matching strings
  -i, --info <info>...      view package information
  -h, --help                Print help
```

Query a package:

```shell
./pacman.sh query -s claptrap
claptrap__subcommand: query
claptrap_query_search[0]: claptrap
```

Show help for the `sync` subcommand:

```shell
./pacman.sh sync --help
Synchronize packages.

Usage: {sync|--sync|-S} [OPTIONS] [package]...

Arguments:
  [package]...  packages

Options:
  -s, --search <search>...  search remote repositories for matching strings
  -i, --info                view package information
  -h, --help                Print help
```

Sync a package:

```shell
/pacman.sh -S claptrap
claptrap__subcommand: sync
claptrap_sync_info: false
claptrap_sync_package[0]: claptrap
```

Show sync info for some packages:

```shell
./pacman.sh --sync -i claptrap trippy
claptrap__subcommand: sync
claptrap_sync_info: true
claptrap_sync_package[0]: claptrap
claptrap_sync_package[1]: trippy
```