AppFlowy-Cloud/tests/util/test_client.rs

726 lines
19 KiB
Rust

use assert_json_diff::{
assert_json_eq, assert_json_include, assert_json_matches_no_panic, CompareMode, Config,
};
use bytes::Bytes;
use client_api::collab_sync::{SinkConfig, SyncObject, SyncPlugin};
use client_api::{WSClient, WSClientConfig};
use collab::core::collab::MutexCollab;
use collab::core::collab_plugin::EncodedCollab;
use collab::core::collab_state::SyncState;
use collab::core::origin::{CollabClient, CollabOrigin};
use collab::preclude::Collab;
use collab_entity::CollabType;
use collab_folder::Folder;
use database_entity::dto::{
AFAccessLevel, AFRole, AFSnapshotMeta, AFSnapshotMetas, AFUserWorkspaceInfo, AFWorkspace,
AFWorkspaceMember, BatchQueryCollabResult, CollabParams, CreateCollabParams,
InsertCollabMemberParams, QueryCollab, QueryCollabParams, QuerySnapshotParams, SnapshotData,
UpdateCollabMemberParams,
};
use mime::Mime;
use serde_json::Value;
use shared_entity::dto::workspace_dto::{
BlobMetadata, CreateWorkspaceMember, WorkspaceMemberChangeset, WorkspaceSpaceUsage,
};
use shared_entity::response::AppResponseError;
use sqlx::types::Uuid;
use std::collections::HashMap;
use std::ops::Deref;
use std::path::{Path, PathBuf};
use std::sync::Arc;
use tokio::time::{timeout, Duration};
use tokio_stream::StreamExt;
use crate::localhost_client;
use crate::user::utils::{generate_unique_registered_user, User};
use crate::util::setup_log;
pub(crate) struct TestClient {
pub user: User,
pub ws_client: WSClient,
pub api_client: client_api::Client,
pub collab_by_object_id: HashMap<String, TestCollab>,
pub device_id: String,
}
pub(crate) struct TestCollab {
#[allow(dead_code)]
pub origin: CollabOrigin,
pub collab: Arc<MutexCollab>,
}
impl TestClient {
pub(crate) async fn new(device_id: String, registered_user: User, start_ws_conn: bool) -> Self {
setup_log();
let api_client = localhost_client();
api_client
.sign_in_password(&registered_user.email, &registered_user.password)
.await
.unwrap();
// Connect to server via websocket
let ws_client = WSClient::new(
WSClientConfig {
buffer_capacity: 100,
ping_per_secs: 6,
retry_connect_per_pings: 5,
},
api_client.clone(),
);
if start_ws_conn {
ws_client
.connect(api_client.ws_url(&device_id).unwrap(), &device_id)
.await
.unwrap();
}
Self {
user: registered_user,
ws_client,
api_client,
collab_by_object_id: Default::default(),
device_id,
}
}
pub(crate) async fn new_user() -> Self {
let registered_user = generate_unique_registered_user().await;
let device_id = Uuid::new_v4().to_string();
Self::new(device_id, registered_user, true).await
}
pub(crate) async fn new_user_without_ws_conn() -> Self {
let registered_user = generate_unique_registered_user().await;
let device_id = Uuid::new_v4().to_string();
Self::new(device_id, registered_user, false).await
}
pub(crate) async fn user_with_new_device(registered_user: User) -> Self {
let device_id = Uuid::new_v4().to_string();
Self::new(device_id, registered_user, true).await
}
pub(crate) async fn add_workspace_member(
&self,
workspace_id: &str,
other_client: &TestClient,
role: AFRole,
) {
self
.try_add_workspace_member(workspace_id, other_client, role)
.await
.unwrap();
}
pub(crate) async fn get_user_workspace_info(&self) -> AFUserWorkspaceInfo {
self.api_client.get_user_workspace_info().await.unwrap()
}
pub(crate) async fn open_workspace(&self, workspace_id: &str) -> AFWorkspace {
self.api_client.open_workspace(workspace_id).await.unwrap()
}
pub(crate) async fn get_user_folder(&self) -> Folder {
let uid = self.uid().await;
let workspace_id = self.workspace_id().await;
let data = self
.api_client
.get_collab(QueryCollabParams::new(
&workspace_id,
CollabType::Folder,
&workspace_id,
))
.await
.unwrap();
Folder::from_collab_doc_state(
uid,
CollabOrigin::Empty,
data.doc_state.to_vec(),
&workspace_id,
vec![],
)
.unwrap()
}
pub(crate) async fn try_update_workspace_member(
&self,
workspace_id: &str,
other_client: &TestClient,
role: AFRole,
) -> Result<(), AppResponseError> {
let workspace_id = Uuid::parse_str(workspace_id).unwrap().to_string();
let email = other_client.email().await;
self
.api_client
.update_workspace_member(
workspace_id,
WorkspaceMemberChangeset::new(email).with_role(role),
)
.await
}
pub(crate) async fn try_add_workspace_member(
&self,
workspace_id: &str,
other_client: &TestClient,
role: AFRole,
) -> Result<(), AppResponseError> {
let email = other_client.email().await;
self
.api_client
.add_workspace_members(workspace_id, vec![CreateWorkspaceMember { email, role }])
.await
}
pub(crate) async fn try_remove_workspace_member(
&self,
workspace_id: &str,
other_client: &TestClient,
) -> Result<(), AppResponseError> {
let email = other_client.email().await;
self
.api_client
.remove_workspace_members(workspace_id.to_string(), vec![email])
.await
}
pub async fn get_workspace_members(&self, workspace_id: &str) -> Vec<AFWorkspaceMember> {
self
.api_client
.get_workspace_members(workspace_id)
.await
.unwrap()
}
pub(crate) async fn add_client_as_collab_member(
&self,
workspace_id: &str,
object_id: &str,
other_client: &TestClient,
access_level: AFAccessLevel,
) {
let uid = other_client.uid().await;
self
.api_client
.add_collab_member(InsertCollabMemberParams {
uid,
workspace_id: workspace_id.to_string(),
object_id: object_id.to_string(),
access_level,
})
.await
.unwrap();
}
pub(crate) async fn update_collab_member_access_level(
&self,
workspace_id: &str,
object_id: &str,
other_client: &TestClient,
access_level: AFAccessLevel,
) {
let uid = other_client.uid().await;
self
.api_client
.update_collab_member(UpdateCollabMemberParams {
uid,
workspace_id: workspace_id.to_string(),
object_id: object_id.to_string(),
access_level,
})
.await
.unwrap();
}
pub(crate) async fn wait_object_sync_complete(&self, object_id: &str) {
self
.wait_object_sync_complete_with_secs(object_id, 20)
.await;
}
pub(crate) async fn wait_object_sync_complete_with_secs(&self, object_id: &str, secs: u64) {
let mut sync_state = self
.collab_by_object_id
.get(object_id)
.unwrap()
.collab
.lock()
.subscribe_sync_state();
let duration = Duration::from_secs(secs);
while let Ok(Some(state)) = timeout(duration, sync_state.next()).await {
if state == SyncState::SyncFinished {
break;
}
}
}
#[allow(dead_code)]
pub async fn get_blob_metadata(&self, workspace_id: &str, file_id: &str) -> BlobMetadata {
let url = self.api_client.get_blob_url(workspace_id, file_id);
self.api_client.get_blob_metadata(&url).await.unwrap()
}
pub async fn upload_blob<T: Into<Bytes>>(&self, file_id: &str, data: T, mime: &Mime) {
let workspace_id = self.workspace_id().await;
let url = self.api_client.get_blob_url(&workspace_id, file_id);
self.api_client.put_blob(&url, data, mime).await.unwrap()
}
pub async fn delete_file(&self, file_id: &str) {
let workspace_id = self.workspace_id().await;
let url = self.api_client.get_blob_url(&workspace_id, file_id);
self.api_client.delete_blob(&url).await.unwrap();
}
pub async fn get_workspace_usage(&self) -> WorkspaceSpaceUsage {
let workspace_id = self.workspace_id().await;
self
.api_client
.get_workspace_usage(&workspace_id)
.await
.unwrap()
}
pub(crate) async fn workspace_id(&self) -> String {
self
.api_client
.get_workspaces()
.await
.unwrap()
.0
.first()
.unwrap()
.workspace_id
.to_string()
}
pub(crate) async fn email(&self) -> String {
self.api_client.get_profile().await.unwrap().email.unwrap()
}
pub(crate) async fn uid(&self) -> i64 {
self.api_client.get_profile().await.unwrap().uid
}
#[allow(dead_code)]
pub(crate) async fn get_snapshot(
&self,
workspace_id: &str,
object_id: &str,
snapshot_id: &i64,
) -> Result<SnapshotData, AppResponseError> {
self
.api_client
.get_snapshot(
workspace_id,
object_id,
QuerySnapshotParams {
snapshot_id: *snapshot_id,
},
)
.await
}
pub(crate) async fn create_snapshot(
&self,
workspace_id: &str,
object_id: &str,
collab_type: CollabType,
) -> Result<AFSnapshotMeta, AppResponseError> {
self
.api_client
.create_snapshot(workspace_id, object_id, collab_type)
.await
}
pub(crate) async fn get_snapshot_list(
&self,
workspace_id: &str,
object_id: &str,
) -> Result<AFSnapshotMetas, AppResponseError> {
self
.api_client
.get_snapshot_list(workspace_id, object_id)
.await
}
pub(crate) async fn create_collab_list(
&mut self,
workspace_id: &str,
params: Vec<CollabParams>,
) -> Result<(), AppResponseError> {
self
.api_client
.create_collab_list(workspace_id, params)
.await
}
pub(crate) async fn batch_get_collab(
&mut self,
workspace_id: &str,
params: Vec<QueryCollab>,
) -> Result<BatchQueryCollabResult, AppResponseError> {
self.api_client.batch_get_collab(workspace_id, params).await
}
#[allow(clippy::await_holding_lock)]
pub(crate) async fn create_and_edit_collab(
&mut self,
workspace_id: &str,
collab_type: CollabType,
) -> String {
let object_id = Uuid::new_v4().to_string();
self
.create_and_edit_collab_with_data(object_id.clone(), workspace_id, collab_type, None)
.await;
object_id
}
#[allow(clippy::await_holding_lock)]
pub(crate) async fn create_and_edit_collab_with_data(
&mut self,
object_id: String,
workspace_id: &str,
collab_type: CollabType,
encoded_collab_v1: Option<EncodedCollab>,
) {
// Subscribe to object
let handler = self.ws_client.subscribe_collab(object_id.clone()).unwrap();
let (sink, stream) = (handler.sink(), handler.stream());
let origin = CollabOrigin::Client(CollabClient::new(self.uid().await, self.device_id.clone()));
let collab = match encoded_collab_v1 {
None => Arc::new(MutexCollab::new(origin.clone(), &object_id, vec![])),
Some(data) => Arc::new(
MutexCollab::new_with_doc_state(
origin.clone(),
&object_id,
data.doc_state.to_vec(),
vec![],
)
.unwrap(),
),
};
let encoded_collab_v1 = collab.encode_collab_v1().encode_to_bytes().unwrap();
self
.api_client
.create_collab(CreateCollabParams {
object_id: object_id.clone(),
encoded_collab_v1,
collab_type: collab_type.clone(),
override_if_exist: false,
workspace_id: workspace_id.to_string(),
})
.await
.unwrap();
let ws_connect_state = self.ws_client.subscribe_connect_state();
let object = SyncObject::new(&object_id, workspace_id, collab_type, &self.device_id);
let sync_plugin = SyncPlugin::new(
origin.clone(),
object,
Arc::downgrade(&collab),
sink,
SinkConfig::default(),
stream,
Some(handler),
!self.ws_client.is_connected(),
ws_connect_state,
);
collab.lock().add_plugin(Arc::new(sync_plugin));
collab.lock().initialize().await;
let test_collab = TestCollab { origin, collab };
self
.collab_by_object_id
.insert(object_id.clone(), test_collab);
self.wait_object_sync_complete(&object_id).await;
}
pub(crate) async fn open_workspace_collab(&mut self, workspace_id: &str) {
self
.open_collab(workspace_id, workspace_id, CollabType::Folder)
.await;
}
#[allow(clippy::await_holding_lock)]
pub(crate) async fn open_collab(
&mut self,
workspace_id: &str,
object_id: &str,
collab_type: CollabType,
) {
// Subscribe to object
let handler = self
.ws_client
.subscribe_collab(object_id.to_string())
.unwrap();
let (sink, stream) = (handler.sink(), handler.stream());
let origin = CollabOrigin::Client(CollabClient::new(self.uid().await, self.device_id.clone()));
let collab = Arc::new(MutexCollab::new(origin.clone(), object_id, vec![]));
let ws_connect_state = self.ws_client.subscribe_connect_state();
let object = SyncObject::new(object_id, workspace_id, collab_type, &self.device_id);
let sync_plugin = SyncPlugin::new(
origin.clone(),
object,
Arc::downgrade(&collab),
sink,
SinkConfig::default(),
stream,
Some(handler),
!self.ws_client.is_connected(),
ws_connect_state,
);
collab.lock().add_plugin(Arc::new(sync_plugin));
collab.lock().initialize().await;
let test_collab = TestCollab { origin, collab };
self
.collab_by_object_id
.insert(object_id.to_string(), test_collab);
}
pub(crate) async fn disconnect(&self) {
self.ws_client.disconnect().await;
}
pub(crate) async fn reconnect(&self) {
self
.ws_client
.connect(
self.api_client.ws_url(&self.device_id).unwrap(),
&self.device_id,
)
.await
.unwrap();
}
}
pub async fn assert_server_snapshot(
client: &client_api::Client,
workspace_id: &str,
object_id: &str,
snapshot_id: &i64,
expected: Value,
) {
let workspace_id = workspace_id.to_string();
let object_id = object_id.to_string();
let mut retry_count = 0;
loop {
tokio::select! {
_ = tokio::time::sleep(Duration::from_secs(10)) => {
panic!("Query snapshot timeout");
},
result =client.get_snapshot(&workspace_id,&object_id,QuerySnapshotParams {snapshot_id: *snapshot_id },
) => {
retry_count += 1;
match &result {
Ok(snapshot_data) => {
let encoded_collab_v1 =
EncodedCollab::decode_from_bytes(&snapshot_data.encoded_collab_v1).unwrap();
let json = Collab::new_with_doc_state(
CollabOrigin::Empty,
&object_id,
encoded_collab_v1.doc_state.to_vec(),
vec![],
)
.unwrap()
.to_json_value();
if retry_count > 10 {
assert_json_eq!(json, expected);
break;
}
if assert_json_matches_no_panic(&json, &expected, Config::new(CompareMode::Inclusive)).is_ok() {
break;
}
tokio::time::sleep(Duration::from_millis(1000)).await;
},
Err(e) => {
if retry_count > 10 {
panic!("Query snapshot failed: {}", e);
}
tokio::time::sleep(Duration::from_millis(1000)).await;
}
}
},
}
}
}
pub async fn assert_server_collab(
workspace_id: &str,
client: &mut client_api::Client,
object_id: &str,
collab_type: &CollabType,
secs: u64,
expected: Value,
) {
let collab_type = collab_type.clone();
let object_id = object_id.to_string();
let mut retry_count = 0;
loop {
tokio::select! {
_ = tokio::time::sleep(Duration::from_secs(secs)) => {
panic!("Query collab timeout");
},
result = client.get_collab(QueryCollabParams::new(
&object_id,
collab_type.clone(),
workspace_id,
)) => {
retry_count += 1;
match &result {
Ok(data) => {
let json = Collab::new_with_doc_state(CollabOrigin::Empty, &object_id, data.doc_state.to_vec(), vec![]).unwrap().to_json_value();
if retry_count > 10 {
dbg!(workspace_id, object_id);
assert_json_eq!(json, expected);
break;
}
if assert_json_matches_no_panic(&json, &expected, Config::new(CompareMode::Inclusive)).is_ok() {
break;
}
tokio::time::sleep(Duration::from_millis(1000)).await;
},
Err(e) => {
if retry_count > 10 {
panic!("Query collab failed: {}", e);
}
tokio::time::sleep(Duration::from_millis(1000)).await;
}
}
},
}
}
}
pub(crate) async fn assert_client_collab(
client: &mut TestClient,
object_id: &str,
key: &str,
expected: Value,
_retry_duration: u64,
) {
let secs = 30;
let object_id = object_id.to_string();
let mut retry_count = 0;
loop {
tokio::select! {
_ = tokio::time::sleep(Duration::from_secs(secs)) => {
panic!("timeout");
},
json = async {
client
.collab_by_object_id
.get_mut(&object_id)
.unwrap()
.collab
.lock()
.to_json_value()
} => {
retry_count += 1;
if retry_count > 30 {
assert_eq!(json[key], expected[key], "object_id: {}", object_id);
break;
}
if json[key] == expected[key] {
break;
}
tokio::time::sleep(Duration::from_millis(1000)).await;
}
}
}
}
pub(crate) async fn assert_client_collab_include_value(
client: &mut TestClient,
object_id: &str,
expected: Value,
) {
let secs = 30;
let object_id = object_id.to_string();
let mut retry_count = 0;
loop {
tokio::select! {
_ = tokio::time::sleep(Duration::from_secs(secs)) => {
panic!("timeout");
},
json = async {
client
.collab_by_object_id
.get_mut(&object_id)
.unwrap()
.collab
.lock()
.to_json_value()
} => {
retry_count += 1;
if retry_count > 30 {
assert_json_include!(actual: json, expected: expected);
break;
}
if assert_json_matches_no_panic(&json, &expected, Config::new(CompareMode::Inclusive)).is_ok() {
break;
}
tokio::time::sleep(Duration::from_millis(1000)).await;
}
}
}
}
#[allow(dead_code)]
pub async fn get_collab_json_from_server(
client: &client_api::Client,
workspace_id: &str,
object_id: &str,
collab_type: CollabType,
) -> Value {
let bytes = client
.get_collab(QueryCollabParams::new(object_id, collab_type, workspace_id))
.await
.unwrap();
Collab::new_with_doc_state(
CollabOrigin::Empty,
object_id,
bytes.doc_state.to_vec(),
vec![],
)
.unwrap()
.to_json_value()
}
pub struct TestTempFile(PathBuf);
impl TestTempFile {
fn cleanup(dir: &PathBuf) {
let _ = std::fs::remove_dir_all(dir);
}
}
impl AsRef<Path> for TestTempFile {
fn as_ref(&self) -> &Path {
&self.0
}
}
impl Deref for TestTempFile {
type Target = PathBuf;
fn deref(&self) -> &Self::Target {
&self.0
}
}
impl Drop for TestTempFile {
fn drop(&mut self) {
Self::cleanup(&self.0)
}
}