Mercurial > libervia-backend
annotate doc/libervia-cli/message.rst @ 3548:13e7ef106589
plugin XEP-0277: don't wrap `DataError` in `failure.Failure` in `parseCommentUrl` as it is not catched correctly:
`failure.Failure` is subclass of `BaseException` but not of `Exception`, as a result
`except Exception` doesn't catch it correctly. This is fixed by not wrapping `DataError`
in `failure.Failure` anymore.
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Fri, 04 Jun 2021 17:18:44 +0200 |
| parents | 4705f80b6e23 |
| children | 267e4987b58b |
| rev | line source |
|---|---|
| 2946 | 1 .. highlight:: sh |
| 2 | |
| 3 ================================ | |
| 4 message: chat message management | |
| 5 ================================ | |
| 6 | |
| 7 Message commands let you send chat messages or manage your server message archives. | |
| 8 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3454
diff
changeset
|
9 .. _libervia-cli_message_send: |
|
3041
72583524cfd3
doc (jp): jp commands are now fully documented:
Goffi <goffi@goffi.org>
parents:
2946
diff
changeset
|
10 |
| 2946 | 11 send |
| 12 ==== | |
| 13 | |
|
3041
72583524cfd3
doc (jp): jp commands are now fully documented:
Goffi <goffi@goffi.org>
parents:
2946
diff
changeset
|
14 Send a message to a contact or a chat room. |
| 2946 | 15 ``stdin`` is used as message source. |
| 16 You can encrypt your message using ``--encrypt [ALGORITHM]`` argument, this will create an encrypted session and replace existing one if needed. | |
| 17 You can manage your encrypted session using ``encryption`` command. | |
| 18 | |
| 19 examples | |
| 20 -------- | |
| 21 | |
| 22 Send a message to a contact:: | |
| 23 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3454
diff
changeset
|
24 $ echo 'Salut à Toi!' | li message send louise@example.net |
| 2946 | 25 |
| 26 Send a message encrypted with OMEMO:: | |
| 27 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3454
diff
changeset
|
28 $ echo 'pssst, this message is encrypted' | li message send -e omemo louise@example.net |
| 2946 | 29 |
| 30 .. note:: | |
| 31 | |
| 32 Fingerprints of your destinee must have been accepted before using OMEMO, else message can't be encrypted | |
| 33 | |
| 34 Send a ``normal`` message marked as French with a subject:: | |
| 35 | |
| 3505 | 36 $ echo 'Bonjour, je vous écris avec « Libervia »' | li message send -l fr -t normal -S 'Ceci est un message de test' |
| 2946 | 37 |
| 38 mam | |
| 39 === | |
| 40 | |
|
3041
72583524cfd3
doc (jp): jp commands are now fully documented:
Goffi <goffi@goffi.org>
parents:
2946
diff
changeset
|
41 Query archives using MAM. |
| 2946 | 42 This command allows you to check message archive kept on the server (i.e. not the local copy). |
| 43 You usually want to specify a starting point, and a number of message to retrieve. If too many messages | |
| 44 are available, you'll have to use RSM commands to navigate through the results. | |
| 45 | |
| 46 examples | |
| 47 -------- | |
| 48 | |
| 49 Retrieve messages from last 2 days:: | |
| 50 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3454
diff
changeset
|
51 $ li message mam -S "2 days ago" |
| 2946 | 52 |
| 53 Retrieve messages from last 5 hours on SàT official chat room:: | |
| 54 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3454
diff
changeset
|
55 $ li message mam -S "5 hours ago" -s sat@chat.jabberfr.org |
| 2946 | 56 |
| 57 Retrieve 2 first messages of 2019 on SàT official chat room:: | |
| 58 | |
|
3488
c80a0f864b5d
doc: updated doc following global renaming
Goffi <goffi@goffi.org>
parents:
3454
diff
changeset
|
59 $ li message mam -S 2019-01-01 -s sat@chat.jabberfr.org -m 2 |