Merge branch 'room-search'
commit
8b13602b3b
|
@ -23,6 +23,7 @@ use std::result::Result as StdResult;
|
||||||
use std::sync::Arc;
|
use std::sync::Arc;
|
||||||
|
|
||||||
use matrix_sdk_common::instant::{Duration, Instant};
|
use matrix_sdk_common::instant::{Duration, Instant};
|
||||||
|
use matrix_sdk_common::js_int::UInt;
|
||||||
use matrix_sdk_common::locks::RwLock;
|
use matrix_sdk_common::locks::RwLock;
|
||||||
use matrix_sdk_common::uuid::Uuid;
|
use matrix_sdk_common::uuid::Uuid;
|
||||||
|
|
||||||
|
@ -248,6 +249,8 @@ impl SyncSettings {
|
||||||
}
|
}
|
||||||
|
|
||||||
use api::r0::account::register;
|
use api::r0::account::register;
|
||||||
|
use api::r0::directory::get_public_rooms;
|
||||||
|
use api::r0::directory::get_public_rooms_filtered;
|
||||||
#[cfg(feature = "encryption")]
|
#[cfg(feature = "encryption")]
|
||||||
use api::r0::keys::{claim_keys, get_keys, upload_keys, KeyAlgorithm};
|
use api::r0::keys::{claim_keys, get_keys, upload_keys, KeyAlgorithm};
|
||||||
use api::r0::membership::{
|
use api::r0::membership::{
|
||||||
|
@ -646,6 +649,92 @@ impl Client {
|
||||||
self.send(request).await
|
self.send(request).await
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Search the homeserver's directory of public rooms.
|
||||||
|
///
|
||||||
|
/// Sends a request to "_matrix/client/r0/publicRooms", returns
|
||||||
|
/// a `get_public_rooms::Response`.
|
||||||
|
///
|
||||||
|
/// # Arguments
|
||||||
|
///
|
||||||
|
/// * `limit` - The number of `PublicRoomsChunk`s in each response.
|
||||||
|
///
|
||||||
|
/// * `since` - Pagination token from a previous request.
|
||||||
|
///
|
||||||
|
/// * `server` - The name of the server, if `None` the requested server is used.
|
||||||
|
///
|
||||||
|
/// # Examples
|
||||||
|
/// ```no_run
|
||||||
|
/// use matrix_sdk::Client;
|
||||||
|
/// # use url::Url;
|
||||||
|
/// # let homeserver = Url::parse("http://example.com").unwrap();
|
||||||
|
/// # let limit = Some(10);
|
||||||
|
/// # let since = Some("since token");
|
||||||
|
/// # let server = Some("server name");
|
||||||
|
///
|
||||||
|
/// let mut cli = Client::new(homeserver).unwrap();
|
||||||
|
/// # use futures::executor::block_on;
|
||||||
|
/// # block_on(async {
|
||||||
|
///
|
||||||
|
/// cli.public_rooms(limit, since, server).await;
|
||||||
|
/// # });
|
||||||
|
/// ```
|
||||||
|
pub async fn public_rooms(
|
||||||
|
&self,
|
||||||
|
limit: Option<u32>,
|
||||||
|
since: Option<&str>,
|
||||||
|
server: Option<&str>,
|
||||||
|
) -> Result<get_public_rooms::Response> {
|
||||||
|
let limit = limit.map(|n| UInt::try_from(n).ok()).flatten();
|
||||||
|
let since = since.map(ToString::to_string);
|
||||||
|
let server = server.map(ToString::to_string);
|
||||||
|
|
||||||
|
let request = get_public_rooms::Request {
|
||||||
|
limit,
|
||||||
|
since,
|
||||||
|
server,
|
||||||
|
};
|
||||||
|
self.send(request).await
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Search the homeserver's directory of public rooms with a filter.
|
||||||
|
///
|
||||||
|
/// Sends a request to "_matrix/client/r0/publicRooms", returns
|
||||||
|
/// a `get_public_rooms_filtered::Response`.
|
||||||
|
///
|
||||||
|
/// # Arguments
|
||||||
|
///
|
||||||
|
/// * `room_search` - The easiest way to create this request is using the `RoomListFilterBuilder`.
|
||||||
|
///
|
||||||
|
/// # Examples
|
||||||
|
/// ```
|
||||||
|
/// # use std::convert::TryFrom;
|
||||||
|
/// # use matrix_sdk::{Client, RoomListFilterBuilder};
|
||||||
|
/// # use matrix_sdk::api::r0::directory::get_public_rooms_filtered::{self, RoomNetwork, Filter};
|
||||||
|
/// # use url::Url;
|
||||||
|
/// # let homeserver = Url::parse("http://example.com").unwrap();
|
||||||
|
/// # let mut rt = tokio::runtime::Runtime::new().unwrap();
|
||||||
|
/// # rt.block_on(async {
|
||||||
|
/// # let last_sync_token = "".to_string();
|
||||||
|
/// let mut client = Client::new(homeserver).unwrap();
|
||||||
|
///
|
||||||
|
/// let generic_search_term = Some("matrix-rust-sdk".to_string());
|
||||||
|
/// let mut builder = RoomListFilterBuilder::new();
|
||||||
|
/// builder
|
||||||
|
/// .filter(Filter { generic_search_term, })
|
||||||
|
/// .since(last_sync_token)
|
||||||
|
/// .room_network(RoomNetwork::Matrix);
|
||||||
|
///
|
||||||
|
/// client.public_rooms_filtered(builder).await;
|
||||||
|
/// # })
|
||||||
|
/// ```
|
||||||
|
pub async fn public_rooms_filtered<R: Into<get_public_rooms_filtered::Request>>(
|
||||||
|
&self,
|
||||||
|
room_search: R,
|
||||||
|
) -> Result<get_public_rooms_filtered::Response> {
|
||||||
|
let request = room_search.into();
|
||||||
|
self.send(request).await
|
||||||
|
}
|
||||||
|
|
||||||
/// Create a room using the `RoomBuilder` and send the request.
|
/// Create a room using the `RoomBuilder` and send the request.
|
||||||
///
|
///
|
||||||
/// Sends a request to `/_matrix/client/r0/createRoom`, returns a `create_room::Response`,
|
/// Sends a request to `/_matrix/client/r0/createRoom`, returns a `create_room::Response`,
|
||||||
|
@ -706,12 +795,14 @@ impl Client {
|
||||||
/// # use matrix_sdk::js_int::UInt;
|
/// # use matrix_sdk::js_int::UInt;
|
||||||
///
|
///
|
||||||
/// # let homeserver = Url::parse("http://example.com").unwrap();
|
/// # let homeserver = Url::parse("http://example.com").unwrap();
|
||||||
/// let mut builder = MessagesRequestBuilder::new();
|
/// let mut builder = MessagesRequestBuilder::new(
|
||||||
/// builder.room_id(RoomId::try_from("!roomid:example.com").unwrap())
|
/// RoomId::try_from("!roomid:example.com").unwrap(),
|
||||||
/// .from("t47429-4392820_219380_26003_2265".to_string())
|
/// "t47429-4392820_219380_26003_2265".to_string(),
|
||||||
/// .to("t4357353_219380_26003_2265".to_string())
|
/// );
|
||||||
|
///
|
||||||
|
/// builder.to("t4357353_219380_26003_2265".to_string())
|
||||||
/// .direction(Direction::Backward)
|
/// .direction(Direction::Backward)
|
||||||
/// .limit(UInt::new(10).unwrap());
|
/// .limit(10);
|
||||||
///
|
///
|
||||||
/// let mut client = Client::new(homeserver).unwrap();
|
/// let mut client = Client::new(homeserver).unwrap();
|
||||||
/// # use futures::executor::block_on;
|
/// # use futures::executor::block_on;
|
||||||
|
@ -951,7 +1042,7 @@ impl Client {
|
||||||
.body(body)
|
.body(body)
|
||||||
.header(reqwest::header::CONTENT_TYPE, "application/json")
|
.header(reqwest::header::CONTENT_TYPE, "application/json")
|
||||||
}
|
}
|
||||||
method => panic!("Unsuported method {}", method),
|
method => panic!("Unsupported method {}", method),
|
||||||
};
|
};
|
||||||
|
|
||||||
let request_builder = if requires_auth {
|
let request_builder = if requires_auth {
|
||||||
|
@ -1395,15 +1486,18 @@ impl Client {
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod test {
|
mod test {
|
||||||
use super::{
|
use super::{
|
||||||
api::r0::uiaa::AuthData, ban_user, create_receipt, create_typing_event, forget_room,
|
api::r0::uiaa::AuthData,
|
||||||
invite_user, kick_user, leave_room, register::RegistrationKind, set_read_marker,
|
ban_user, create_receipt, create_typing_event, forget_room, get_public_rooms,
|
||||||
Invite3pid, MessageEventContent,
|
get_public_rooms_filtered::{self, Filter},
|
||||||
|
invite_user, kick_user, leave_room,
|
||||||
|
register::RegistrationKind,
|
||||||
|
set_read_marker, Invite3pid, MessageEventContent,
|
||||||
};
|
};
|
||||||
use super::{Client, ClientConfig, Session, SyncSettings, Url};
|
use super::{Client, ClientConfig, Session, SyncSettings, Url};
|
||||||
use crate::events::collections::all::RoomEvent;
|
use crate::events::collections::all::RoomEvent;
|
||||||
use crate::events::room::message::TextMessageEventContent;
|
use crate::events::room::message::TextMessageEventContent;
|
||||||
use crate::identifiers::{EventId, RoomId, RoomIdOrAliasId, UserId};
|
use crate::identifiers::{EventId, RoomId, RoomIdOrAliasId, UserId};
|
||||||
use crate::RegistrationBuilder;
|
use crate::{RegistrationBuilder, RoomListFilterBuilder};
|
||||||
|
|
||||||
use matrix_sdk_base::JsonStore;
|
use matrix_sdk_base::JsonStore;
|
||||||
use matrix_sdk_test::{test_json, EventBuilder, EventsJson};
|
use matrix_sdk_test::{test_json, EventBuilder, EventsJson};
|
||||||
|
@ -1751,6 +1845,64 @@ mod test {
|
||||||
{}
|
{}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
#[allow(irrefutable_let_patterns)]
|
||||||
|
async fn room_search_all() {
|
||||||
|
let homeserver = Url::from_str(&mockito::server_url()).unwrap();
|
||||||
|
|
||||||
|
let _m = mock(
|
||||||
|
"GET",
|
||||||
|
Matcher::Regex(r"^/_matrix/client/r0/publicRooms".to_string()),
|
||||||
|
)
|
||||||
|
.with_status(200)
|
||||||
|
.with_body(test_json::PUBLIC_ROOMS.to_string())
|
||||||
|
.create();
|
||||||
|
|
||||||
|
let client = Client::new(homeserver).unwrap();
|
||||||
|
|
||||||
|
if let get_public_rooms::Response { chunk, .. } =
|
||||||
|
client.public_rooms(Some(10), None, None).await.unwrap()
|
||||||
|
{
|
||||||
|
assert_eq!(chunk.len(), 1)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test]
|
||||||
|
#[allow(irrefutable_let_patterns)]
|
||||||
|
async fn room_search_filtered() {
|
||||||
|
let homeserver = Url::from_str(&mockito::server_url()).unwrap();
|
||||||
|
let user = UserId::try_from("@example:localhost").unwrap();
|
||||||
|
|
||||||
|
let session = Session {
|
||||||
|
access_token: "1234".to_owned(),
|
||||||
|
user_id: user.clone(),
|
||||||
|
device_id: "DEVICEID".to_owned(),
|
||||||
|
};
|
||||||
|
|
||||||
|
let _m = mock(
|
||||||
|
"POST",
|
||||||
|
Matcher::Regex(r"^/_matrix/client/r0/publicRooms".to_string()),
|
||||||
|
)
|
||||||
|
.with_status(200)
|
||||||
|
.with_body(test_json::PUBLIC_ROOMS.to_string())
|
||||||
|
.create();
|
||||||
|
|
||||||
|
let client = Client::new(homeserver).unwrap();
|
||||||
|
client.restore_login(session).await.unwrap();
|
||||||
|
|
||||||
|
let generic_search_term = Some("cheese".to_string());
|
||||||
|
let mut request = RoomListFilterBuilder::default();
|
||||||
|
request.filter(Filter {
|
||||||
|
generic_search_term,
|
||||||
|
});
|
||||||
|
|
||||||
|
if let get_public_rooms_filtered::Response { chunk, .. } =
|
||||||
|
client.public_rooms_filtered(request).await.unwrap()
|
||||||
|
{
|
||||||
|
assert_eq!(chunk.len(), 1)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
#[tokio::test]
|
#[tokio::test]
|
||||||
#[allow(irrefutable_let_patterns)]
|
#[allow(irrefutable_let_patterns)]
|
||||||
async fn leave_room() {
|
async fn leave_room() {
|
||||||
|
|
|
@ -52,7 +52,9 @@ mod error;
|
||||||
mod request_builder;
|
mod request_builder;
|
||||||
pub use client::{Client, ClientConfig, SyncSettings};
|
pub use client::{Client, ClientConfig, SyncSettings};
|
||||||
pub use error::{Error, Result};
|
pub use error::{Error, Result};
|
||||||
pub use request_builder::{MessagesRequestBuilder, RegistrationBuilder, RoomBuilder};
|
pub use request_builder::{
|
||||||
|
MessagesRequestBuilder, RegistrationBuilder, RoomBuilder, RoomListFilterBuilder,
|
||||||
|
};
|
||||||
|
|
||||||
#[cfg(not(target_arch = "wasm32"))]
|
#[cfg(not(target_arch = "wasm32"))]
|
||||||
pub(crate) const VERSION: &str = env!("CARGO_PKG_VERSION");
|
pub(crate) const VERSION: &str = env!("CARGO_PKG_VERSION");
|
||||||
|
|
|
@ -1,19 +1,20 @@
|
||||||
use crate::api;
|
use matrix_sdk_common::{
|
||||||
use crate::events::room::power_levels::PowerLevelsEventContent;
|
api::r0::{
|
||||||
use crate::events::EventJson;
|
account::register::{self, RegistrationKind},
|
||||||
use crate::identifiers::{DeviceId, RoomId, UserId};
|
directory::get_public_rooms_filtered::{self, Filter, RoomNetwork},
|
||||||
use api::r0::account::register;
|
filter::RoomEventFilter,
|
||||||
use api::r0::account::register::RegistrationKind;
|
membership::Invite3pid,
|
||||||
use api::r0::filter::RoomEventFilter;
|
message::get_message_events::{self, Direction},
|
||||||
use api::r0::membership::Invite3pid;
|
room::{
|
||||||
use api::r0::message::get_message_events::{self, Direction};
|
|
||||||
use api::r0::room::{
|
|
||||||
create_room::{self, CreationContent, InitialStateEvent, RoomPreset},
|
create_room::{self, CreationContent, InitialStateEvent, RoomPreset},
|
||||||
Visibility,
|
Visibility,
|
||||||
|
},
|
||||||
|
uiaa::AuthData,
|
||||||
|
},
|
||||||
|
events::{room::power_levels::PowerLevelsEventContent, EventJson},
|
||||||
|
identifiers::{DeviceId, RoomId, UserId},
|
||||||
|
js_int::{uint, UInt},
|
||||||
};
|
};
|
||||||
use api::r0::uiaa::AuthData;
|
|
||||||
|
|
||||||
use crate::js_int::UInt;
|
|
||||||
|
|
||||||
/// A builder used to create rooms.
|
/// A builder used to create rooms.
|
||||||
///
|
///
|
||||||
|
@ -39,38 +40,17 @@ use crate::js_int::UInt;
|
||||||
/// ```
|
/// ```
|
||||||
#[derive(Clone, Debug, Default)]
|
#[derive(Clone, Debug, Default)]
|
||||||
pub struct RoomBuilder {
|
pub struct RoomBuilder {
|
||||||
/// Extra keys to be added to the content of the `m.room.create`.
|
|
||||||
creation_content: Option<CreationContent>,
|
creation_content: Option<CreationContent>,
|
||||||
/// List of state events to send to the new room.
|
|
||||||
///
|
|
||||||
/// Takes precedence over events set by preset, but gets overriden by
|
|
||||||
/// name and topic keys.
|
|
||||||
initial_state: Vec<InitialStateEvent>,
|
initial_state: Vec<InitialStateEvent>,
|
||||||
/// A list of user IDs to invite to the room.
|
|
||||||
///
|
|
||||||
/// This will tell the server to invite everyone in the list to the newly created room.
|
|
||||||
invite: Vec<UserId>,
|
invite: Vec<UserId>,
|
||||||
/// List of third party IDs of users to invite.
|
|
||||||
invite_3pid: Vec<Invite3pid>,
|
invite_3pid: Vec<Invite3pid>,
|
||||||
/// If set, this sets the `is_direct` flag on room invites.
|
|
||||||
is_direct: Option<bool>,
|
is_direct: Option<bool>,
|
||||||
/// If this is included, an `m.room.name` event will be sent into the room to indicate
|
|
||||||
/// the name of the room.
|
|
||||||
name: Option<String>,
|
name: Option<String>,
|
||||||
/// Power level content to override in the default power level event.
|
|
||||||
power_level_content_override: Option<PowerLevelsEventContent>,
|
power_level_content_override: Option<PowerLevelsEventContent>,
|
||||||
/// Convenience parameter for setting various default state events based on a preset.
|
|
||||||
preset: Option<RoomPreset>,
|
preset: Option<RoomPreset>,
|
||||||
/// The desired room alias local part.
|
|
||||||
room_alias_name: Option<String>,
|
room_alias_name: Option<String>,
|
||||||
/// Room version to set for the room. Defaults to homeserver's default if not specified.
|
|
||||||
room_version: Option<String>,
|
room_version: Option<String>,
|
||||||
/// If this is included, an `m.room.topic` event will be sent into the room to indicate
|
|
||||||
/// the topic for the room.
|
|
||||||
topic: Option<String>,
|
topic: Option<String>,
|
||||||
/// A public visibility indicates that the room will be shown in the published room
|
|
||||||
/// list. A private visibility will hide the room from the published room list. Rooms
|
|
||||||
/// default to private visibility if this key is not included.
|
|
||||||
visibility: Option<Visibility>,
|
visibility: Option<Visibility>,
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -89,61 +69,68 @@ impl RoomBuilder {
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Set the `InitialStateEvent` vector.
|
/// Sets a list of state events to send to the new room.
|
||||||
|
///
|
||||||
|
/// Takes precedence over events set by preset, but gets overriden by
|
||||||
|
/// name and topic keys.
|
||||||
pub fn initial_state(&mut self, state: Vec<InitialStateEvent>) -> &mut Self {
|
pub fn initial_state(&mut self, state: Vec<InitialStateEvent>) -> &mut Self {
|
||||||
self.initial_state = state;
|
self.initial_state = state;
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Set the vec of `UserId`s.
|
/// Sets a list of user IDs to invite to the room.
|
||||||
|
///
|
||||||
|
/// This will tell the server to invite everyone in the list to the newly created room.
|
||||||
pub fn invite(&mut self, invite: Vec<UserId>) -> &mut Self {
|
pub fn invite(&mut self, invite: Vec<UserId>) -> &mut Self {
|
||||||
self.invite = invite;
|
self.invite = invite;
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Set the vec of `Invite3pid`s.
|
/// Sets a list of third party IDs of users to invite.
|
||||||
pub fn invite_3pid(&mut self, invite: Vec<Invite3pid>) -> &mut Self {
|
pub fn invite_3pid(&mut self, invite: Vec<Invite3pid>) -> &mut Self {
|
||||||
self.invite_3pid = invite;
|
self.invite_3pid = invite;
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Set the vec of `Invite3pid`s.
|
/// If set, this sets the `is_direct` flag on room invites.
|
||||||
pub fn is_direct(&mut self, direct: bool) -> &mut Self {
|
pub fn is_direct(&mut self, direct: bool) -> &mut Self {
|
||||||
self.is_direct = Some(direct);
|
self.is_direct = Some(direct);
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Set the room name. A `m.room.name` event will be sent to the room.
|
/// If this is included, an `m.room.name` event will be sent into the room to indicate
|
||||||
|
/// the name of the room.
|
||||||
pub fn name<S: Into<String>>(&mut self, name: S) -> &mut Self {
|
pub fn name<S: Into<String>>(&mut self, name: S) -> &mut Self {
|
||||||
self.name = Some(name.into());
|
self.name = Some(name.into());
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Set the room's power levels.
|
/// Power level content to override in the default power level event.
|
||||||
pub fn power_level_override(&mut self, power: PowerLevelsEventContent) -> &mut Self {
|
pub fn power_level_override(&mut self, power: PowerLevelsEventContent) -> &mut Self {
|
||||||
self.power_level_content_override = Some(power);
|
self.power_level_content_override = Some(power);
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Convenience for setting various default state events based on a preset.
|
/// Convenience parameter for setting various default state events based on a preset.
|
||||||
pub fn preset(&mut self, preset: RoomPreset) -> &mut Self {
|
pub fn preset(&mut self, preset: RoomPreset) -> &mut Self {
|
||||||
self.preset = Some(preset);
|
self.preset = Some(preset);
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// The local part of a room alias.
|
/// The desired room alias local part.
|
||||||
pub fn room_alias_name<S: Into<String>>(&mut self, alias: S) -> &mut Self {
|
pub fn room_alias_name<S: Into<String>>(&mut self, alias: S) -> &mut Self {
|
||||||
self.room_alias_name = Some(alias.into());
|
self.room_alias_name = Some(alias.into());
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Room version, defaults to homeserver's version if left unspecified.
|
/// Room version to set for the room. Defaults to homeserver's default if not specified.
|
||||||
pub fn room_version<S: Into<String>>(&mut self, version: S) -> &mut Self {
|
pub fn room_version<S: Into<String>>(&mut self, version: S) -> &mut Self {
|
||||||
self.room_version = Some(version.into());
|
self.room_version = Some(version.into());
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// If included, a `m.room.topic` event will be sent to the room.
|
/// If this is included, an `m.room.topic` event will be sent into the room to indicate
|
||||||
|
/// the topic for the room.
|
||||||
pub fn topic<S: Into<String>>(&mut self, topic: S) -> &mut Self {
|
pub fn topic<S: Into<String>>(&mut self, topic: S) -> &mut Self {
|
||||||
self.topic = Some(topic.into());
|
self.topic = Some(topic.into());
|
||||||
self
|
self
|
||||||
|
@ -193,67 +180,54 @@ impl Into<create_room::Request> for RoomBuilder {
|
||||||
/// # let last_sync_token = "".to_string();
|
/// # let last_sync_token = "".to_string();
|
||||||
/// let mut client = Client::new(homeserver).unwrap();
|
/// let mut client = Client::new(homeserver).unwrap();
|
||||||
///
|
///
|
||||||
/// let mut builder = MessagesRequestBuilder::new();
|
/// let mut builder = MessagesRequestBuilder::new(
|
||||||
/// builder.room_id(room_id)
|
/// RoomId::try_from("!roomid:example.com").unwrap(),
|
||||||
/// .from(last_sync_token)
|
/// "t47429-4392820_219380_26003_2265".to_string(),
|
||||||
/// .direction(Direction::Forward);
|
/// );
|
||||||
|
///
|
||||||
|
/// builder.to("t4357353_219380_26003_2265".to_string())
|
||||||
|
/// .direction(Direction::Backward)
|
||||||
|
/// .limit(10);
|
||||||
///
|
///
|
||||||
/// client.room_messages(builder).await.is_err();
|
/// client.room_messages(builder).await.is_err();
|
||||||
/// # })
|
/// # })
|
||||||
/// ```
|
/// ```
|
||||||
#[derive(Clone, Debug, Default)]
|
#[derive(Clone, Debug)]
|
||||||
pub struct MessagesRequestBuilder {
|
pub struct MessagesRequestBuilder {
|
||||||
/// The room to get events from.
|
room_id: RoomId,
|
||||||
room_id: Option<RoomId>,
|
from: String,
|
||||||
/// The token to start returning events from.
|
|
||||||
///
|
|
||||||
/// This token can be obtained from a
|
|
||||||
/// prev_batch token returned for each room by the sync API, or from a start or end token
|
|
||||||
/// returned by a previous request to this endpoint.
|
|
||||||
from: Option<String>,
|
|
||||||
/// The token to stop returning events at.
|
|
||||||
///
|
|
||||||
/// This token can be obtained from a prev_batch
|
|
||||||
/// token returned for each room by the sync endpoint, or from a start or end token returned
|
|
||||||
/// by a previous request to this endpoint.
|
|
||||||
to: Option<String>,
|
to: Option<String>,
|
||||||
/// The direction to return events from.
|
|
||||||
direction: Option<Direction>,
|
direction: Option<Direction>,
|
||||||
/// The maximum number of events to return.
|
limit: Option<u32>,
|
||||||
///
|
|
||||||
/// Default: 10.
|
|
||||||
limit: Option<UInt>,
|
|
||||||
/// A filter of the returned events with.
|
|
||||||
filter: Option<RoomEventFilter>,
|
filter: Option<RoomEventFilter>,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl MessagesRequestBuilder {
|
impl MessagesRequestBuilder {
|
||||||
/// Create a `MessagesRequestBuilder` builder to make a `get_message_events::Request`.
|
/// Create a `MessagesRequestBuilder` builder to make a `get_message_events::Request`.
|
||||||
///
|
///
|
||||||
/// The `room_id` and `from`` fields **need to be set** to create the request.
|
/// # Arguments
|
||||||
pub fn new() -> Self {
|
|
||||||
Self::default()
|
|
||||||
}
|
|
||||||
|
|
||||||
/// RoomId is required to create a `get_message_events::Request`.
|
|
||||||
pub fn room_id(&mut self, room_id: RoomId) -> &mut Self {
|
|
||||||
self.room_id = Some(room_id);
|
|
||||||
self
|
|
||||||
}
|
|
||||||
|
|
||||||
/// A `next_batch` token or `start` or `end` from a previous `get_message_events` request.
|
|
||||||
///
|
///
|
||||||
/// This is required to create a `get_message_events::Request`.
|
/// * `room_id` - The id of the room that is being requested.
|
||||||
pub fn from(&mut self, from: String) -> &mut Self {
|
///
|
||||||
self.from = Some(from);
|
/// * `from` - The token to start returning events from. This token can be obtained from
|
||||||
self
|
/// a `prev_batch` token from a sync response, or a start or end token from a previous request
|
||||||
|
/// to this endpoint.
|
||||||
|
pub fn new(room_id: RoomId, from: String) -> Self {
|
||||||
|
Self {
|
||||||
|
room_id,
|
||||||
|
from,
|
||||||
|
to: None,
|
||||||
|
direction: None,
|
||||||
|
limit: None,
|
||||||
|
filter: None,
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// A `next_batch` token or `start` or `end` from a previous `get_message_events` request.
|
/// A `next_batch` token or `start` or `end` from a previous `get_message_events` request.
|
||||||
///
|
///
|
||||||
/// This token signals when to stop receiving events.
|
/// This token signals when to stop receiving events.
|
||||||
pub fn to(&mut self, to: String) -> &mut Self {
|
pub fn to<S: Into<String>>(&mut self, to: S) -> &mut Self {
|
||||||
self.to = Some(to);
|
self.to = Some(to.into());
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -266,7 +240,9 @@ impl MessagesRequestBuilder {
|
||||||
}
|
}
|
||||||
|
|
||||||
/// The maximum number of events to return.
|
/// The maximum number of events to return.
|
||||||
pub fn limit(&mut self, limit: UInt) -> &mut Self {
|
///
|
||||||
|
/// The default is 10.
|
||||||
|
pub fn limit(&mut self, limit: u32) -> &mut Self {
|
||||||
self.limit = Some(limit);
|
self.limit = Some(limit);
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
@ -281,11 +257,11 @@ impl MessagesRequestBuilder {
|
||||||
impl Into<get_message_events::Request> for MessagesRequestBuilder {
|
impl Into<get_message_events::Request> for MessagesRequestBuilder {
|
||||||
fn into(self) -> get_message_events::Request {
|
fn into(self) -> get_message_events::Request {
|
||||||
get_message_events::Request {
|
get_message_events::Request {
|
||||||
room_id: self.room_id.expect("`room_id` and `from` need to be set"),
|
room_id: self.room_id,
|
||||||
from: self.from.expect("`room_id` and `from` need to be set"),
|
from: self.from,
|
||||||
to: self.to,
|
to: self.to,
|
||||||
dir: self.direction.unwrap_or(Direction::Backward),
|
dir: self.direction.unwrap_or(Direction::Backward),
|
||||||
limit: self.limit,
|
limit: self.limit.map(UInt::from),
|
||||||
filter: self.filter,
|
filter: self.filter,
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -324,8 +300,6 @@ pub struct RegistrationBuilder {
|
||||||
|
|
||||||
impl RegistrationBuilder {
|
impl RegistrationBuilder {
|
||||||
/// Create a `RegistrationBuilder` builder to make a `register::Request`.
|
/// Create a `RegistrationBuilder` builder to make a `register::Request`.
|
||||||
///
|
|
||||||
/// The `room_id` and `from`` fields **need to be set** to create the request.
|
|
||||||
pub fn new() -> Self {
|
pub fn new() -> Self {
|
||||||
Self::default()
|
Self::default()
|
||||||
}
|
}
|
||||||
|
@ -334,16 +308,16 @@ impl RegistrationBuilder {
|
||||||
///
|
///
|
||||||
/// May be empty for accounts that should not be able to log in again
|
/// May be empty for accounts that should not be able to log in again
|
||||||
/// with a password, e.g., for guest or application service accounts.
|
/// with a password, e.g., for guest or application service accounts.
|
||||||
pub fn password(&mut self, password: &str) -> &mut Self {
|
pub fn password<S: Into<String>>(&mut self, password: S) -> &mut Self {
|
||||||
self.password = Some(password.to_string());
|
self.password = Some(password.into());
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// local part of the desired Matrix ID.
|
/// local part of the desired Matrix ID.
|
||||||
///
|
///
|
||||||
/// If omitted, the homeserver MUST generate a Matrix ID local part.
|
/// If omitted, the homeserver MUST generate a Matrix ID local part.
|
||||||
pub fn username(&mut self, username: &str) -> &mut Self {
|
pub fn username<S: Into<String>>(&mut self, username: S) -> &mut Self {
|
||||||
self.username = Some(username.to_string());
|
self.username = Some(username.into());
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -351,16 +325,19 @@ impl RegistrationBuilder {
|
||||||
///
|
///
|
||||||
/// If this does not correspond to a known client device, a new device will be created.
|
/// If this does not correspond to a known client device, a new device will be created.
|
||||||
/// The server will auto-generate a device_id if this is not specified.
|
/// The server will auto-generate a device_id if this is not specified.
|
||||||
pub fn device_id(&mut self, device_id: &str) -> &mut Self {
|
pub fn device_id<S: Into<String>>(&mut self, device_id: S) -> &mut Self {
|
||||||
self.device_id = Some(device_id.to_string());
|
self.device_id = Some(device_id.into());
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
/// A display name to assign to the newly-created device.
|
/// A display name to assign to the newly-created device.
|
||||||
///
|
///
|
||||||
/// Ignored if `device_id` corresponds to a known device.
|
/// Ignored if `device_id` corresponds to a known device.
|
||||||
pub fn initial_device_display_name(&mut self, initial_device_display_name: &str) -> &mut Self {
|
pub fn initial_device_display_name<S: Into<String>>(
|
||||||
self.initial_device_display_name = Some(initial_device_display_name.to_string());
|
&mut self,
|
||||||
|
initial_device_display_name: S,
|
||||||
|
) -> &mut Self {
|
||||||
|
self.initial_device_display_name = Some(initial_device_display_name.into());
|
||||||
self
|
self
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -405,6 +382,92 @@ impl Into<register::Request> for RegistrationBuilder {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Create a builder for making get_public_rooms_filtered requests.
|
||||||
|
///
|
||||||
|
/// # Examples
|
||||||
|
/// ```
|
||||||
|
/// # use std::convert::TryFrom;
|
||||||
|
/// # use matrix_sdk::{Client, RoomListFilterBuilder};
|
||||||
|
/// # use matrix_sdk::api::r0::directory::get_public_rooms_filtered::{self, RoomNetwork, Filter};
|
||||||
|
/// # use url::Url;
|
||||||
|
/// # let homeserver = Url::parse("http://example.com").unwrap();
|
||||||
|
/// # let mut rt = tokio::runtime::Runtime::new().unwrap();
|
||||||
|
/// # rt.block_on(async {
|
||||||
|
/// # let last_sync_token = "".to_string();
|
||||||
|
/// let mut client = Client::new(homeserver).unwrap();
|
||||||
|
///
|
||||||
|
/// let generic_search_term = Some("matrix-rust-sdk".to_string());
|
||||||
|
/// let mut builder = RoomListFilterBuilder::new();
|
||||||
|
/// builder
|
||||||
|
/// .filter(Filter { generic_search_term, })
|
||||||
|
/// .since(last_sync_token)
|
||||||
|
/// .room_network(RoomNetwork::Matrix);
|
||||||
|
///
|
||||||
|
/// client.public_rooms_filtered(builder).await.is_err();
|
||||||
|
/// # })
|
||||||
|
/// ```
|
||||||
|
#[derive(Clone, Debug, Default)]
|
||||||
|
pub struct RoomListFilterBuilder {
|
||||||
|
server: Option<String>,
|
||||||
|
limit: Option<u32>,
|
||||||
|
since: Option<String>,
|
||||||
|
filter: Option<Filter>,
|
||||||
|
room_network: Option<RoomNetwork>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl RoomListFilterBuilder {
|
||||||
|
/// Create a `RoomListFilterBuilder` builder to make a `get_message_events::Request`.
|
||||||
|
pub fn new() -> Self {
|
||||||
|
Self::default()
|
||||||
|
}
|
||||||
|
|
||||||
|
/// The server to fetch the public room lists from.
|
||||||
|
///
|
||||||
|
/// `None` means the server this request is sent to.
|
||||||
|
pub fn server<S: Into<String>>(&mut self, server: S) -> &mut Self {
|
||||||
|
self.server = Some(server.into());
|
||||||
|
self
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Limit for the number of results to return.
|
||||||
|
pub fn limit(&mut self, limit: u32) -> &mut Self {
|
||||||
|
self.limit = Some(limit);
|
||||||
|
self
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Pagination token from a previous request.
|
||||||
|
pub fn since<S: Into<String>>(&mut self, since: S) -> &mut Self {
|
||||||
|
self.since = Some(since.into());
|
||||||
|
self
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Filter to apply to the results.
|
||||||
|
pub fn filter(&mut self, filter: Filter) -> &mut Self {
|
||||||
|
self.filter = Some(filter);
|
||||||
|
self
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Network to fetch the public room lists from.
|
||||||
|
///
|
||||||
|
/// Defaults to the Matrix network.
|
||||||
|
pub fn room_network(&mut self, room_network: RoomNetwork) -> &mut Self {
|
||||||
|
self.room_network = Some(room_network);
|
||||||
|
self
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Into<get_public_rooms_filtered::Request> for RoomListFilterBuilder {
|
||||||
|
fn into(self) -> get_public_rooms_filtered::Request {
|
||||||
|
get_public_rooms_filtered::Request {
|
||||||
|
room_network: self.room_network.unwrap_or_default(),
|
||||||
|
limit: self.limit.map(UInt::from),
|
||||||
|
server: self.server,
|
||||||
|
since: self.since,
|
||||||
|
filter: self.filter,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
mod test {
|
mod test {
|
||||||
use std::collections::BTreeMap;
|
use std::collections::BTreeMap;
|
||||||
|
@ -483,13 +546,14 @@ mod test {
|
||||||
device_id: "DEVICEID".to_owned(),
|
device_id: "DEVICEID".to_owned(),
|
||||||
};
|
};
|
||||||
|
|
||||||
let mut builder = MessagesRequestBuilder::new();
|
let mut builder = MessagesRequestBuilder::new(
|
||||||
|
RoomId::try_from("!roomid:example.com").unwrap(),
|
||||||
|
"t47429-4392820_219380_26003_2265".to_string(),
|
||||||
|
);
|
||||||
builder
|
builder
|
||||||
.room_id(RoomId::try_from("!roomid:example.com").unwrap())
|
|
||||||
.from("t47429-4392820_219380_26003_2265".to_string())
|
|
||||||
.to("t4357353_219380_26003_2265".to_string())
|
.to("t4357353_219380_26003_2265".to_string())
|
||||||
.direction(Direction::Backward)
|
.direction(Direction::Backward)
|
||||||
.limit(UInt::new(10).unwrap())
|
.limit(10)
|
||||||
.filter(RoomEventFilter {
|
.filter(RoomEventFilter {
|
||||||
lazy_load_options: LazyLoadOptions::Enabled {
|
lazy_load_options: LazyLoadOptions::Enabled {
|
||||||
include_redundant_members: false,
|
include_redundant_members: false,
|
||||||
|
|
|
@ -375,6 +375,28 @@ lazy_static! {
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
lazy_static! {
|
||||||
|
pub static ref PUBLIC_ROOMS: JsonValue = json!({
|
||||||
|
"chunk": [
|
||||||
|
{
|
||||||
|
"aliases": [
|
||||||
|
"#murrays:cheese.bar"
|
||||||
|
],
|
||||||
|
"avatar_url": "mxc://bleeker.street/CHEDDARandBRIE",
|
||||||
|
"guest_can_join": false,
|
||||||
|
"name": "CHEESE",
|
||||||
|
"num_joined_members": 37,
|
||||||
|
"room_id": "!ol19s:bleecker.street",
|
||||||
|
"topic": "Tasty tasty cheese",
|
||||||
|
"world_readable": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"next_batch": "p190q",
|
||||||
|
"prev_batch": "p1902",
|
||||||
|
"total_room_count_estimate": 115
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
lazy_static! {
|
lazy_static! {
|
||||||
pub static ref REGISTRATION_RESPONSE_ERR: JsonValue = json!({
|
pub static ref REGISTRATION_RESPONSE_ERR: JsonValue = json!({
|
||||||
"errcode": "M_FORBIDDEN",
|
"errcode": "M_FORBIDDEN",
|
||||||
|
|
|
@ -9,7 +9,7 @@ pub mod sync;
|
||||||
|
|
||||||
pub use events::{
|
pub use events::{
|
||||||
ALIAS, ALIASES, EVENT_ID, KEYS_QUERY, KEYS_UPLOAD, LOGIN, LOGIN_RESPONSE_ERR, LOGOUT, MEMBER,
|
ALIAS, ALIASES, EVENT_ID, KEYS_QUERY, KEYS_UPLOAD, LOGIN, LOGIN_RESPONSE_ERR, LOGOUT, MEMBER,
|
||||||
MESSAGE_EDIT, MESSAGE_TEXT, NAME, POWER_LEVELS, PRESENCE, REACTION, REGISTRATION_RESPONSE_ERR,
|
MESSAGE_EDIT, MESSAGE_TEXT, NAME, POWER_LEVELS, PRESENCE, PUBLIC_ROOMS, REACTION,
|
||||||
ROOM_ID, ROOM_MESSAGES, TYPING,
|
REGISTRATION_RESPONSE_ERR, ROOM_ID, ROOM_MESSAGES, TYPING,
|
||||||
};
|
};
|
||||||
pub use sync::{DEFAULT_SYNC_SUMMARY, INVITE_SYNC, LEAVE_SYNC, LEAVE_SYNC_EVENT, MORE_SYNC, SYNC};
|
pub use sync::{DEFAULT_SYNC_SUMMARY, INVITE_SYNC, LEAVE_SYNC, LEAVE_SYNC_EVENT, MORE_SYNC, SYNC};
|
||||||
|
|
Loading…
Reference in New Issue