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;
27// TODO: only export top-level module on the next major release
28pub use jid::{self, BareJid, Error as JidParseError, FullJid, Jid};
29pub use minidom::Element;
30
31pub use blake2;
32pub use sha1;
33pub use sha2;
34pub use sha3;
35
36/// XML namespace definitions used through XMPP.
37pub mod ns;
38
39#[macro_use]
40mod util;
41
42/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
43pub mod bind;
44/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
45pub mod iq;
46/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
47pub mod message;
48/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
49pub mod presence;
50/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
51pub mod sasl;
52/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
53pub mod stanza_error;
54/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
55pub mod stream;
56
57/// RFC 6121: Extensible Messaging and Presence Protocol (XMPP): Instant Messaging and Presence
58pub mod roster;
59
60/// RFC 7395: An Extensible Messaging and Presence Protocol (XMPP) Subprotocol for WebSocket
61pub mod websocket;
62
63/// XEP-0004: Data Forms
64pub mod data_forms;
65
66/// XEP-0030: Service Discovery
67pub mod disco;
68
69/// XEP-0045: Multi-User Chat
70pub mod muc;
71
72/// XEP-0047: In-Band Bytestreams
73pub mod ibb;
74
75/// XEP-0048: Bookmarks
76pub mod bookmarks;
77
78/// XEP-0049: Private XML storage
79pub mod private;
80
81/// XEP-0054: vcard-temp
82pub mod vcard;
83
84/// XEP-0059: Result Set Management
85pub mod rsm;
86
87/// XEP-0060: Publish-Subscribe
88pub mod pubsub;
89
90/// XEP-0071: XHTML-IM
91pub mod xhtml;
92
93/// XEP-0077: In-Band Registration
94pub mod ibr;
95
96/// XEP-0082: XMPP Date and Time Profiles
97pub mod date;
98
99/// XEP-0084: User Avatar
100pub mod avatar;
101
102/// XEP-0085: Chat State Notifications
103pub mod chatstates;
104
105/// XEP-0092: Software Version
106pub mod version;
107
108/// XEP-0107: User Mood
109pub mod mood;
110
111/// XEP-0114: Jabber Component Protocol
112pub mod component;
113
114/// XEP-0115: Entity Capabilities
115pub mod caps;
116
117/// XEP-0118: User Tune
118pub mod tune;
119
120///XEP-0153: vCard-Based Avatars
121pub mod vcard_update;
122
123/// XEP-0157: Contact Addresses for XMPP Services
124pub mod server_info;
125
126/// XEP-0166: Jingle
127pub mod jingle;
128
129/// XEP-0167: Jingle RTP Sessions
130pub mod jingle_rtp;
131
132/// XEP-0172: User Nickname
133pub mod nick;
134
135/// XEP-0176: Jingle ICE-UDP Transport Method
136pub mod jingle_ice_udp;
137
138/// XEP-0177: Jingle Raw UDP Transport Method
139pub mod jingle_raw_udp;
140
141/// XEP-0184: Message Delivery Receipts
142pub mod receipts;
143
144/// XEP-0191: Blocking Command
145pub mod blocking;
146
147/// XEP-0198: Stream Management
148pub mod sm;
149
150/// XEP-0199: XMPP Ping
151pub mod ping;
152
153/// XEP-0202: Entity Time
154pub mod time;
155
156/// XEP-0203: Delayed Delivery
157pub mod delay;
158
159/// XEP-0215: External Service Discovery
160pub mod extdisco;
161
162/// XEP-0221: Data Forms Media Element
163pub mod media_element;
164
165/// XEP-0224: Attention
166pub mod attention;
167
168/// XEP-0231: Bits of Binary
169pub mod bob;
170
171/// XEP-0234: Jingle File Transfer
172pub mod jingle_ft;
173
174/// XEP-0257: Client Certificate Management for SASL EXTERNAL
175pub mod cert_management;
176
177/// XEP-0260: Jingle SOCKS5 Bytestreams Transport Method
178pub mod jingle_s5b;
179
180/// XEP-0261: Jingle In-Band Bytestreams Transport Method
181pub mod jingle_ibb;
182
183/// XEP-0264: Jingle Content Thumbnails
184pub mod jingle_thumnails;
185
186/// XEP-0280: Message Carbons
187pub mod carbons;
188
189/// XEP-0293: Jingle RTP Feedback Negotiation
190pub mod jingle_rtcp_fb;
191
192/// XEP-0294: Jingle RTP Header Extensions Negociation
193pub mod jingle_rtp_hdrext;
194
195/// XEP-0297: Stanza Forwarding
196pub mod forwarding;
197
198/// XEP-0300: Use of Cryptographic Hash Functions in XMPP
199pub mod hashes;
200
201/// XEP-0301: In-Band Real Time Text
202pub mod rtt;
203
204/// XEP-0308: Last Message Correction
205pub mod message_correct;
206
207/// XEP-0313: Message Archive Management
208pub mod mam;
209
210/// XEP-0319: Last User Interaction in Presence
211pub mod idle;
212
213/// XEP-0320: Use of DTLS-SRTP in Jingle Sessions
214pub mod jingle_dtls_srtp;
215
216/// XEP-0328: JID Prep
217pub mod jid_prep;
218
219/// XEP-0338: Jingle Grouping Framework
220pub mod jingle_grouping;
221
222/// XEP-0339: Source-Specific Media Attributes in Jingle
223pub mod jingle_ssma;
224
225/// XEP-0352: Client State Indication
226pub mod csi;
227
228/// XEP-0353: Jingle Message Initiation
229pub mod jingle_message;
230
231/// XEP-0359: Unique and Stable Stanza IDs
232pub mod stanza_id;
233
234/// XEP-0363: HTTP File Upload
235pub mod http_upload;
236
237/// XEP-0369: Mediated Information eXchange (MIX)
238pub mod mix;
239
240/// XEP-0373: OpenPGP for XMPP
241pub mod openpgp;
242
243/// XEP-0380: Explicit Message Encryption
244pub mod eme;
245
246/// XEP-0380: OMEMO Encryption (experimental version 0.3.0)
247pub mod legacy_omemo;
248
249/// XEP-0390: Entity Capabilities 2.0
250pub mod ecaps2;
251
252/// XEP-0402: PEP Native Bookmarks
253pub mod bookmarks2;
254
255/// XEP-0421: Anonymous unique occupant identifiers for MUCs
256pub mod occupant_id;
257
258/// XEP-0441: Message Archive Management Preferences
259pub mod mam_prefs;
260
261/// XEP-0444: Message Reactions
262pub mod reactions;