Mercurial > libervia-backend
view doc/libervia-cli/pubsub_node_subscriptions.rst @ 3922:0ff265725489
plugin XEP-0447: handle attachment and download:
- plugin XEP-0447 can now be used in message attachments and to retrieve an attachment
- plugin attach: `attachment` being processed is added to `extra` so the handler can inspect it
- plugin attach: `size` is added to attachment
- plugin download: a whole attachment dict is now used in `download` and
`file_download`/`file_download_complete`. `download_uri` can be used as a shortcut when
just a URI is used. In addition to URI scheme handler, whole attachment handlers can now
be registered with `register_download_handler`
- plugin XEP-0363: `file_http_upload` `XEP-0363_upload_size` triggers have been renamed to
`XEP-0363_upload_pre_slot` and is now using a dict with arguments, allowing for the size
but also the filename to be modified, which is necessary for encryption (filename may
be hidden from URL this way).
- plugin XEP-0446: fix wrong element name
- plugin XEP-0447: source handler can now be registered (`url-data` is registered by
default)
- plugin XEP-0447: source parsing has been put in a separated `parse_sources_elt` method,
as it may be useful to do it independently (notably with XEP-0448)
- plugin XEP-0447: parse received message and complete attachments when suitable
- plugin XEP-0447: can now be used with message attachments
- plugin XEP-0447: can now be used with attachments download
- renamed `options` arguments to `extra` for consistency
- some style change (progressive move from legacy camelCase to PEP8 snake_case)
- some typing
rel 379
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Thu, 06 Oct 2022 16:02:05 +0200 |
| parents | e597dbfbc4c6 |
| children |
line wrap: on
line source
.. _libervia-cli_pubsub_node_subscriptions: ======================================================== pubsub/node/affiliations: nodes subscriptions management ======================================================== ``subscriptions`` is a subcommand handling the subscription to a node. Those commands can only be used by an owner of the node. get === Retrieve subscriptions to a node. If ``--public`` is used, only public subscriptions are retrieved (if target service supports `XEP-0465 Public Pubsub Subscriptions`). Public subscriptions are accessible to anybody, thus you can use this on a node even if you are not an owner of it (and thus would not normally be allowed to retrieve subscriptions). .. _XEP-0465 Public Pubsub Subscriptions: https://xmpp.org/extensions/inbox/pubsub-public-subscriptions.html example ------- Get subscription from ``some_node``:: $ li pubsub node subscriptions get -n some_node Retrieve public subscribers to the blog of Louise:: $ li pubsub node subscriptions get --public -s louise@example.org -n urn:xmpp:microblog:0 set === Set subscriptions to a node. Subscriptions are specified with ``-S JID [SUSBSCRIPTION] [JID [SUSBSCRIPTION] ...], --subscription JID [SUSBSCRIPTION] [JID [SUSBSCRIPTION] ...]`` where ``JID`` is the jid of the entity to change subscription state, and ``SUBSCRIPTION`` is a subscription state (on of ``subscribed``, ``pending``, ``none``) as specified in `XEP-0060 Subscription State`_. If ``SUBSCRIPTION`` is not specified, it default to ``subscribed``. .. _XEP-0060 Subscription State: https://xmpp.org/extensions/xep-0060.html#substates example ------- Subscribe Louise with her new address at ``louise@example.org`` and remove her subscription from old ``louise@example.com``:: $ li pubsub node subscriptions set -n some_node -S louise@example.org subscribed louise@example.com none