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//! [`TryFrom<Element>`]: ../try_from/trait.TryFrom.html
16//! [`Element`]: ../minidom/element/struct.Element.html
17
18// Copyright (c) 2017-2019 Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
19// Copyright (c) 2017-2019 Maxime “pep” Buquet <pep@bouah.net>
20//
21// This Source Code Form is subject to the terms of the Mozilla Public
22// License, v. 2.0. If a copy of the MPL was not distributed with this
23// file, You can obtain one at http://mozilla.org/MPL/2.0/.
24
25#![deny(missing_docs)]
26
27pub use minidom::Element;
28pub use jid::{Jid, BareJid, FullJid, JidParseError};
29pub use std::convert::{TryFrom, TryInto};
30pub use crate::util::error::Error;
31
32/// XML namespace definitions used through XMPP.
33pub mod ns;
34
35#[macro_use]
36mod util;
37
38/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
39pub mod bind;
40/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
41pub mod iq;
42/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
43pub mod message;
44/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
45pub mod presence;
46/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
47pub mod sasl;
48/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
49pub mod stanza_error;
50/// RFC 6120: Extensible Messaging and Presence Protocol (XMPP): Core
51pub mod stream;
52
53/// RFC 6121: Extensible Messaging and Presence Protocol (XMPP): Instant Messaging and Presence
54pub mod roster;
55
56/// RFC 7395: An Extensible Messaging and Presence Protocol (XMPP) Subprotocol for WebSocket
57pub mod websocket;
58
59/// XEP-0004: Data Forms
60pub mod data_forms;
61
62/// XEP-0030: Service Discovery
63pub mod disco;
64
65/// XEP-0045: Multi-User Chat
66pub mod muc;
67
68/// XEP-0047: In-Band Bytestreams
69pub mod ibb;
70
71/// XEP-0048: Bookmarks
72pub mod bookmarks;
73
74/// XEP-0059: Result Set Management
75pub mod rsm;
76
77/// XEP-0060: Publish-Subscribe
78pub mod pubsub;
79
80/// XEP-0077: In-Band Registration
81pub mod ibr;
82
83/// XEP-0082: XMPP Date and Time Profiles
84pub mod date;
85
86/// XEP-0084: User Avatar
87pub mod avatar;
88
89/// XEP-0085: Chat State Notifications
90pub mod chatstates;
91
92/// XEP-0092: Software Version
93pub mod version;
94
95/// XEP-0107: User Mood
96pub mod mood;
97
98/// XEP-0114: Jabber Component Protocol
99pub mod component;
100
101/// XEP-0115: Entity Capabilities
102pub mod caps;
103
104/// XEP-0157: Contact Addresses for XMPP Services
105pub mod server_info;
106
107/// XEP-0166: Jingle
108pub mod jingle;
109
110/// XEP-0167: Jingle RTP Sessions
111pub mod jingle_rtp;
112
113/// XEP-0172: User Nickname
114pub mod nick;
115
116/// XEP-0176: Jingle ICE-UDP Transport Method
117pub mod jingle_ice_udp;
118
119/// XEP-0184: Message Delivery Receipts
120pub mod receipts;
121
122/// XEP-0191: Blocking Command
123pub mod blocking;
124
125/// XEP-0198: Stream Management
126pub mod sm;
127
128/// XEP-0199: XMPP Ping
129pub mod ping;
130
131/// XEP-0202: Entity Time
132pub mod time;
133
134/// XEP-0203: Delayed Delivery
135pub mod delay;
136
137/// XEP-0221: Data Forms Media Element
138pub mod media_element;
139
140/// XEP-0224: Attention
141pub mod attention;
142
143/// XEP-0234: Jingle File Transfer
144pub mod jingle_ft;
145
146/// XEP-0260: Jingle SOCKS5 Bytestreams Transport Method
147pub mod jingle_s5b;
148
149/// XEP-0261: Jingle In-Band Bytestreams Transport Method
150pub mod jingle_ibb;
151
152/// XEP-0297: Stanza Forwarding
153pub mod forwarding;
154
155/// XEP-0300: Use of Cryptographic Hash Functions in XMPP
156pub mod hashes;
157
158/// XEP-0308: Last Message Correction
159pub mod message_correct;
160
161/// XEP-0313: Message Archive Management
162pub mod mam;
163
164/// XEP-0319: Last User Interaction in Presence
165pub mod idle;
166
167/// XEP-0320: Use of DTLS-SRTP in Jingle Sessions
168pub mod jingle_dtls_srtp;
169
170/// XEP-0353: Jingle Message Initiation
171pub mod jingle_message;
172
173/// XEP-0359: Unique and Stable Stanza IDs
174pub mod stanza_id;
175
176/// XEP-0380: Explicit Message Encryption
177pub mod eme;
178
179/// XEP-0390: Entity Capabilities 2.0
180pub mod ecaps2;