Skip to content

Commit

Permalink
docs: convert help code blocks to single line usage
Browse files Browse the repository at this point in the history
  • Loading branch information
uncenter committed May 25, 2024
1 parent 8963a0a commit f55e175
Showing 1 changed file with 30 additions and 62 deletions.
92 changes: 30 additions & 62 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,61 +21,29 @@ nix run github:uncenter/purr
## Usage

```
Usage: purr <COMMAND>
Commands:
query
init
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version
purr <COMMAND> [-h | --help] [-V | --version]
```

### `query`

Both of the query commands can be used with the `-o`/`--output` option to change the output format (`json` or `plain`).

```
Usage: purr query [OPTIONS] [COMMAND]
Commands:
maintained
has
help Print this message or the help of the given subcommand(s)
Options:
-c, --count
-o, --output <FORMAT> [default: json] [possible values: json, plain]
-h, --help Print help
purr query [-c | --count] [-o | --output]
```

**Examples**:
Query the userstyles.yml data source. With no arguments the names of the userstyles are displayed.

- List the userstyles.
#### `-o` / `--output`

```
purr query
```
Both query commands can be used with the `-o`/`--output` option to change the output format to either `json` and `plain` (defaults to `json`).

- Count the number of userstyles.
#### `--count`

```
purr query --count
```
Count the number of userstyles.

#### `maintained`

```
Usage: purr query maintained [OPTIONS]
Options:
--by <NAME>
-n, --not
-c, --count
-o, --output <FORMAT> [default: json] [possible values: json, plain]
-h, --help Print help
purr query maintained [--by <NAME>] [-n | --not] [-c | --count] [-o | --output]
```

**Examples**:
Expand Down Expand Up @@ -131,21 +99,17 @@ Options:
#### `has`

```
Usage: purr query has [OPTIONS]
Options:
--name <NAME>
--category <CATEGORIES>
--icon <ICON>
--color <COLOR>
--app-link <APP_LINK>
-c, --count
-l, --list
-n, --not
-o, --output <FORMAT> [default: json] [possible values: json, plain]
-h, --help Print help
purr query has [PROPERTIES] [-n | --not] [-c | --count] [-l | --list] [-o | --output]
```

**Properties:**

- `--name <NAME>`
- `--category <CATEGORIES>`
- `--icon <ICON>`
- `--color <COLOR>`
- `--app-link <APP_LINK>`

**Examples**:

- Check if userstyles exist with `color` set to `mauve`.
Expand Down Expand Up @@ -183,17 +147,17 @@ Options:
The `init` command accepts each value (name, categories, etc.) via arguments, though if not provided a series of prompts will be displayed instead.

```
Usage: purr init [OPTIONS]
Options:
--name <NAME>
--category <CATEGORIES>
--icon <ICON>
--color <COLOR>
--app-link <APP_LINK>
-h, --help Print help
purr init [PROPERTIES]
```

**Properties**:

- `--name <NAME>`
- `--category <CATEGORIES>`
- `--icon <ICON>`
- `--color <COLOR>`
- `--app-link <APP_LINK>`

## Roadmap

- [ ] Query GitHub stars
Expand All @@ -204,3 +168,7 @@ Options:
## License

[MIT](LICENSE)

```
```

0 comments on commit f55e175

Please sign in to comment.