view doc/libervia-cli/uri.rst @ 3699:2dab494e56fc

plugin XEP-0264: replace `SIZE_FULL_SCREEN` by `SIZE_BIG`: `SIZE_FULL_SCREEN` may result in large files, and BoB is currently used to transfer them, resulting in potentially large stanza. As a result, Libervia profile can be disconnected from server if stanza max size is reached. As a temporary workaround, `SIZE_BIG` is now the maximum size used. This should be fixed in 0.9 with a proper way to transfer large thumbnails (i.e. not BoB).
author Goffi <goffi@goffi.org>
date Fri, 05 Nov 2021 18:08:39 +0100
parents c80a0f864b5d
children
line wrap: on
line source

================================
uri: XMPP URI parsing/generation
================================

URI commands are helper to easily parse/build XMPP URIs.

parse
=====

Parse an XMPP URI, and print different parts.

When possible, the ``type`` of URI is shown (e.g. ``pubsub``) and the ``sub_type`` (e.g.
``microblog``).

The ``path`` is always displayed (see `RFC 5122 Path section`_ for details).

If suitable, you'll also get data like ``node`` (for a PubSub URI).

.. _RFC 5122 Path section: https://tools.ietf.org/html/rfc5122#section-2.4

examples
--------

Parse a blog URI::

  $ li uri parse "xmpp:somebody@example.org?;node=urn%3Axmpp%3Amicroblog%3A0"

build
======

Build an XMPP URI according to arguments. 2 positional arguments are expected: ``type``
and ``path``. For now, only ``pubsub`` type is supported.

examples
--------

Build XMPP URI for a blog::

  $ li uri build pubsub somebody@example.org -f node urn:xmpp:microblog:0