dsc-rs 0.10.15

Discourse CLI tool for managing multiple Discourse forums: track installs, run upgrades over SSH, manage emojis, sync topics and categories as Markdown, and more.
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

# dsc post

Operations on individual posts (not whole topics). Complements `dsc topic pull/push/sync`, which only work on the OP.

## dsc post pull

```text
dsc post pull <discourse> <post-id> [<local-path>]
```

Downloads the raw Markdown body of the specified post. Writes to `<local-path>` if given, otherwise to stdout.

```bash
dsc post pull myforum 98765 ./post-98765.md
dsc post pull myforum 98765 > post.md
```

## dsc post push

```text
dsc post push <discourse> <post-id> [<local-path>]
```

Replaces the body of the specified post with the contents of `<local-path>` (or stdin if omitted, or `-`). Requires either an admin API key or a key whose user is the post author. (Alias: `dsc post edit`.)

```bash
dsc post push myforum 98765 ./corrected.md
echo "Edited on the fly." | dsc post push myforum 98765
```

## dsc post delete

```text
dsc post delete <discourse> <post-id>
```

Soft-deletes the post. Deleting the first post of a topic deletes the whole topic. Supports `--dry-run` (or `-n`).

## dsc post move

```text
dsc post move <discourse> <post-id> --to-topic <topic-id>
```

Moves the post to a different topic. `dsc` infers the source topic from the post itself, so you only supply the destination. Prints the URL of the target topic on success. Supports `--dry-run`.

```bash
dsc post move myforum 98765 --to-topic 1525
dsc -n post move myforum 98765 -t 1525   # dry run
```

## Notes

- Post edits and deletes require either admin scope or that the API user owns the post.
- Moving a post that is the first post of its topic will move the whole topic. Discourse's API enforces this.