lib.rs

  1//! A crate parsing common XMPP elements into Rust structures.
  2//!
  3//! Each module implements the `TryFrom<Element>` trait, which takes a
  4//! minidom [`Element`] and returns a `Result` whose value is `Ok` if the
  5//! element parsed correctly, `Err(error::Error)` otherwise.
  6//!
  7//! The returned structure can be manipuled as any Rust structure, with each
  8//! field being public.  You can also create the same structure manually, with
  9//! some having `new()` and `with_*()` helper methods to create them.
 10//!
 11//! Once you are happy with your structure, you can serialise it back to an
 12//! [`Element`], using either `From` or `Into<Element>`, which give you what
 13//! you want to be sending on the wire.
 14//!
 15//! [`Element`]: ../minidom/element/struct.Element.html
 16
 17// Copyright (c) 2017-2019 Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
 18// Copyright (c) 2017-2019 Maxime “pep” Buquet <pep@bouah.net>
 19//
 20// This Source Code Form is subject to the terms of the Mozilla Public
 21// License, v. 2.0. If a copy of the MPL was not distributed with this
 22// file, You can obtain one at http://mozilla.org/MPL/2.0/.
 23
 24#![warn(missing_docs)]
 25
 26pub use crate::util::error::Error;
 27pub use jid::{BareJid, FullJid, Jid, JidParseError};
 28pub use minidom::Element;
 29
 30/// XML namespace definitions used through XMPP.
 31pub mod ns;
 32
 33#[macro_use]
 34mod util;
 35
 36/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
 37pub mod bind;
 38/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
 39pub mod iq;
 40/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
 41pub mod message;
 42/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
 43pub mod presence;
 44/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
 45pub mod sasl;
 46/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
 47pub mod stanza_error;
 48/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
 49pub mod stream;
 50
 51/// RFC 6121: Extensible Messaging and Presence Protocol (XMPP): Instant Messaging and Presence
 52pub mod roster;
 53
 54/// RFC 7395: An Extensible Messaging and Presence Protocol (XMPP) Subprotocol for WebSocket
 55pub mod websocket;
 56
 57/// XEP-0004: Data Forms
 58pub mod data_forms;
 59
 60/// XEP-0030: Service Discovery
 61pub mod disco;
 62
 63/// XEP-0045: Multi-User Chat
 64pub mod muc;
 65
 66/// XEP-0047: In-Band Bytestreams
 67pub mod ibb;
 68
 69/// XEP-0048: Bookmarks
 70pub mod bookmarks;
 71
 72/// XEP-0059: Result Set Management
 73pub mod rsm;
 74
 75/// XEP-0060: Publish-Subscribe
 76pub mod pubsub;
 77
 78/// XEP-0071: XHTML-IM
 79pub mod xhtml;
 80
 81/// XEP-0077: In-Band Registration
 82pub mod ibr;
 83
 84/// XEP-0082: XMPP Date and Time Profiles
 85pub mod date;
 86
 87/// XEP-0084: User Avatar
 88pub mod avatar;
 89
 90/// XEP-0085: Chat State Notifications
 91pub mod chatstates;
 92
 93/// XEP-0092: Software Version
 94pub mod version;
 95
 96/// XEP-0107: User Mood
 97pub mod mood;
 98
 99/// XEP-0114: Jabber Component Protocol
100pub mod component;
101
102/// XEP-0115: Entity Capabilities
103pub mod caps;
104
105/// XEP-0118: User Tune
106pub mod tune;
107
108/// XEP-0157: Contact Addresses for XMPP Services
109pub mod server_info;
110
111/// XEP-0166: Jingle
112pub mod jingle;
113
114/// XEP-0167: Jingle RTP Sessions
115pub mod jingle_rtp;
116
117/// XEP-0172: User Nickname
118pub mod nick;
119
120/// XEP-0176: Jingle ICE-UDP Transport Method
121pub mod jingle_ice_udp;
122
123/// XEP-0177: Jingle Raw UDP Transport Method
124pub mod jingle_raw_udp;
125
126/// XEP-0184: Message Delivery Receipts
127pub mod receipts;
128
129/// XEP-0191: Blocking Command
130pub mod blocking;
131
132/// XEP-0198: Stream Management
133pub mod sm;
134
135/// XEP-0199: XMPP Ping
136pub mod ping;
137
138/// XEP-0202: Entity Time
139pub mod time;
140
141/// XEP-0203: Delayed Delivery
142pub mod delay;
143
144/// XEP-0215: External Service Discovery
145pub mod extdisco;
146
147/// XEP-0221: Data Forms Media Element
148pub mod media_element;
149
150/// XEP-0224: Attention
151pub mod attention;
152
153/// XEP-0231: Bits of Binary
154pub mod bob;
155
156/// XEP-0234: Jingle File Transfer
157pub mod jingle_ft;
158
159/// XEP-0257: Client Certificate Management for SASL EXTERNAL
160pub mod cert_management;
161
162/// XEP-0260: Jingle SOCKS5 Bytestreams Transport Method
163pub mod jingle_s5b;
164
165/// XEP-0261: Jingle In-Band Bytestreams Transport Method
166pub mod jingle_ibb;
167
168/// XEP-0280: Message Carbons
169pub mod carbons;
170
171/// XEP-0293: Jingle RTP Feedback Negotiation
172pub mod jingle_rtcp_fb;
173
174/// XEP-0294: Jingle RTP Header Extensions Negociation
175pub mod jingle_rtp_hdrext;
176
177/// XEP-0297: Stanza Forwarding
178pub mod forwarding;
179
180/// XEP-0300: Use of Cryptographic Hash Functions in XMPP
181pub mod hashes;
182
183/// XEP-0301: In-Band Real Time Text
184pub mod rtt;
185
186/// XEP-0308: Last Message Correction
187pub mod message_correct;
188
189/// XEP-0313: Message Archive Management
190pub mod mam;
191
192/// XEP-0319: Last User Interaction in Presence
193pub mod idle;
194
195/// XEP-0320: Use of DTLS-SRTP in Jingle Sessions
196pub mod jingle_dtls_srtp;
197
198/// XEP-0328: JID Prep
199pub mod jid_prep;
200
201/// XEP-0338: Jingle Grouping Framework
202pub mod jingle_grouping;
203
204/// XEP-0339: Source-Specific Media Attributes in Jingle
205pub mod jingle_ssma;
206
207/// XEP-0352: Client State Indication
208pub mod csi;
209
210/// XEP-0353: Jingle Message Initiation
211pub mod jingle_message;
212
213/// XEP-0359: Unique and Stable Stanza IDs
214pub mod stanza_id;
215
216/// XEP-0363: HTTP File Upload
217pub mod http_upload;
218
219/// XEP-0369: Mediated Information eXchange (MIX)
220pub mod mix;
221
222/// XEP-0373: OpenPGP for XMPP
223pub mod openpgp;
224
225/// XEP-0380: Explicit Message Encryption
226pub mod eme;
227
228/// XEP-0380: OMEMO Encryption (experimental version 0.3.0)
229pub mod legacy_omemo;
230
231/// XEP-0390: Entity Capabilities 2.0
232pub mod ecaps2;
233
234/// XEP-0402: PEP Native Bookmarks
235pub mod bookmarks2;
236
237/// XEP-0421: Anonymous unique occupant identifiers for MUCs
238pub mod occupant_id;
239
240/// XEP-0441: Message Archive Management Preferences
241pub mod mam_prefs;
242
243/// XEP-0444: Message Reactions
244pub mod reactions;