pep/xmpp-rs-mirror
1
0
Fork 0
mirror of https://gitlab.com/xmpp-rs/xmpp-rs.git synced 2024-07-12 22:21:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Added a "leave room" method.

Browse source
This commit is contained in:
Werner Kroneman 2023-12-08 19:38:52 +01:00
parent 03e955d24f
commit 249d2aeed6
1 changed files with 34 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

34
xmpp/src/lib.rs
View file

@ -241,6 +241,40 @@ impl Agent {
let _ = self.client.send_stanza(presence.into()).await;
}
/// Send a "leave room" request to the server.
///
/// The returned future will resolve when the request has been sent,
/// not when the room has actually been left.
///
/// If successful, a `RoomLeft` event should be received later as a confirmation.
///
/// See: https://xmpp.org/extensions/xep-0045.html#exit
///
/// # Arguments
///
/// * `room_jid`: The JID of the room to leave, including the nickname.
/// * `lang`: The language of the status message.
/// * `status`: The status message to send.
pub async fn leave_room(&mut self, room_jid: FullJid, lang: impl Into<String>, status: impl Into<String>) {
// XEP-0054 specifies that, to leave a room, the client must send a presence stanza
// with type="unavailable".
let mut presence =
Presence::new(PresenceType::Unavailable).with_to(room_jid);
// Optionally, the client may include a status message in the presence stanza.
// TODO: Should this be optional? The XEP says "MAY", but the method signature requires the arguments.
// XEP-0054: "The occupant MAY include normal <status/> information in the unavailable presence stanzas"
presence.set_status(lang, status);
// Send the presence stanza.
if let Err(e) = self.client.send_stanza(presence.into()).await {
// Report any errors to the log.
error!("Failed to send leave room presence: {}", e);
}
}
pub async fn send_message(
&mut self,
recipient: Jid,