Crate tokio_xmpp

Low-level XMPP decentralized instant messaging & social networking implementation with asynchronous I/O using tokio.

For an easier, batteries-included experience, try the xmpp crate.

Getting started

In most cases, you want to start with a Client, that will connect to a server over TCP/IP with StartTLS encryption. Then, you can build an event loop by calling the client’s next method repeatedly. You can find a more complete example in the examples/echo_bot.rs file in the repository.

Features

This library is not feature-complete yet. Here’s a quick overview of the feature set.

Supported implementations:

• Clients
• Components
• Servers

Supported transports:

• Plaintext TCP (IPv4/IPv6)
• StartTLS TCP (IPv4/IPv6 with happy eyeballs support)
• Custom connectors via the connect::ServerConnector trait
• Websockets
• BOSH

More information

You can find more information on our website xmpp.rs or by joining our chatroom chat@xmpp.rs.

Re-exports

pub use parsers::jid;

pub use parsers::minidom;

pub use xmpp_parsers as parsers;

Modules

connect

ServerConnector provides streams for XMPP clients

error

Detailed error types

stanzastream

Resilient stanza stream

xmlstream

RFC 6120 XML Streams

Structs

Client

XMPP client connection and state

Componentinsecure-tcp

Component connection to an XMPP server

IqResponseToken

Handle for awaiting an IQ response.

PrintRawXml

Provides a helper which implements Display printing raw XML

Enums

Error

Generic tokio_xmpp Error Top-level error type

Event

High-level event on the Stream implemented by Client and Component

IqFailure

Error enumeration for Iq sending failures

IqRequest

An IQ request payload

IqResponse

An IQ response payload

Stanza

A stanza sent/received over the stream.