mirror of
https://github.com/meilisearch/meilisearch.git
synced 2024-11-30 09:04:59 +08:00
a30e02c18c
implements: https://github.com/meilisearch/specifications/blob/develop/text/0060-refashion-updates-apis.md linked PR: - #1889 - #1891 - #1892 - #1902 - #1906 - #1911 - #1914 - #1915 - #1916 - #1918 - #1924 - #1925 - #1926 - #1930 - #1936 - #1937 - #1942 - #1944 - #1945 - #1946 - #1947 - #1950 - #1951 - #1957 - #1959 - #1960 - #1961 - #1962 - #1964 - https://github.com/meilisearch/milli/pull/414 - https://github.com/meilisearch/milli/pull/409 - https://github.com/meilisearch/milli/pull/406 - https://github.com/meilisearch/milli/pull/418 - close #1687 - close #1786 - close #1940 - close #1948 - close #1949 - close #1932 - close #1956
281 lines
8.6 KiB
Rust
281 lines
8.6 KiB
Rust
use std::{
|
|
panic::{catch_unwind, resume_unwind, UnwindSafe},
|
|
time::Duration,
|
|
};
|
|
|
|
use actix_web::http::StatusCode;
|
|
use paste::paste;
|
|
use serde_json::{json, Value};
|
|
use tokio::time::sleep;
|
|
use urlencoding::encode;
|
|
|
|
use super::service::Service;
|
|
|
|
macro_rules! make_settings_test_routes {
|
|
($($name:ident),+) => {
|
|
$(paste! {
|
|
pub async fn [<update_$name>](&self, value: Value) -> (Value, StatusCode) {
|
|
let url = format!("/indexes/{}/settings/{}", encode(self.uid.as_ref()).to_string(), stringify!($name).replace("_", "-"));
|
|
self.service.post(url, value).await
|
|
}
|
|
|
|
pub async fn [<get_$name>](&self) -> (Value, StatusCode) {
|
|
let url = format!("/indexes/{}/settings/{}", encode(self.uid.as_ref()).to_string(), stringify!($name).replace("_", "-"));
|
|
self.service.get(url).await
|
|
}
|
|
})*
|
|
};
|
|
}
|
|
|
|
pub struct Index<'a> {
|
|
pub uid: String,
|
|
pub service: &'a Service,
|
|
}
|
|
|
|
#[allow(dead_code)]
|
|
impl Index<'_> {
|
|
pub async fn get(&self) -> (Value, StatusCode) {
|
|
let url = format!("/indexes/{}", encode(self.uid.as_ref()).to_string());
|
|
self.service.get(url).await
|
|
}
|
|
|
|
pub async fn load_test_set(&self) -> u64 {
|
|
let url = format!(
|
|
"/indexes/{}/documents",
|
|
encode(self.uid.as_ref()).to_string()
|
|
);
|
|
let (response, code) = self
|
|
.service
|
|
.post_str(url, include_str!("../assets/test_set.json"))
|
|
.await;
|
|
assert_eq!(code, 202);
|
|
let update_id = response["uid"].as_i64().unwrap();
|
|
self.wait_task(update_id as u64).await;
|
|
update_id as u64
|
|
}
|
|
|
|
pub async fn create(&self, primary_key: Option<&str>) -> (Value, StatusCode) {
|
|
let body = json!({
|
|
"uid": self.uid,
|
|
"primaryKey": primary_key,
|
|
});
|
|
self.service.post("/indexes", body).await
|
|
}
|
|
|
|
pub async fn update(&self, primary_key: Option<&str>) -> (Value, StatusCode) {
|
|
let body = json!({
|
|
"primaryKey": primary_key,
|
|
});
|
|
let url = format!("/indexes/{}", encode(self.uid.as_ref()).to_string());
|
|
|
|
self.service.put(url, body).await
|
|
}
|
|
|
|
pub async fn delete(&self) -> (Value, StatusCode) {
|
|
let url = format!("/indexes/{}", encode(self.uid.as_ref()).to_string());
|
|
self.service.delete(url).await
|
|
}
|
|
|
|
pub async fn add_documents(
|
|
&self,
|
|
documents: Value,
|
|
primary_key: Option<&str>,
|
|
) -> (Value, StatusCode) {
|
|
let url = match primary_key {
|
|
Some(key) => format!(
|
|
"/indexes/{}/documents?primaryKey={}",
|
|
encode(self.uid.as_ref()).to_string(),
|
|
key
|
|
),
|
|
None => format!(
|
|
"/indexes/{}/documents",
|
|
encode(self.uid.as_ref()).to_string()
|
|
),
|
|
};
|
|
self.service.post(url, documents).await
|
|
}
|
|
|
|
pub async fn update_documents(
|
|
&self,
|
|
documents: Value,
|
|
primary_key: Option<&str>,
|
|
) -> (Value, StatusCode) {
|
|
let url = match primary_key {
|
|
Some(key) => format!(
|
|
"/indexes/{}/documents?primaryKey={}",
|
|
encode(self.uid.as_ref()).to_string(),
|
|
key
|
|
),
|
|
None => format!(
|
|
"/indexes/{}/documents",
|
|
encode(self.uid.as_ref()).to_string()
|
|
),
|
|
};
|
|
self.service.put(url, documents).await
|
|
}
|
|
|
|
pub async fn wait_task(&self, update_id: u64) -> Value {
|
|
// try 10 times to get status, or panic to not wait forever
|
|
let url = format!("/tasks/{}", update_id);
|
|
for _ in 0..10 {
|
|
let (response, status_code) = self.service.get(&url).await;
|
|
assert_eq!(status_code, 200, "response: {}", response);
|
|
|
|
if response["status"] == "succeeded" || response["status"] == "failed" {
|
|
return response;
|
|
}
|
|
|
|
sleep(Duration::from_secs(1)).await;
|
|
}
|
|
panic!("Timeout waiting for update id");
|
|
}
|
|
|
|
pub async fn get_task(&self, update_id: u64) -> (Value, StatusCode) {
|
|
let url = format!("/indexes/{}/tasks/{}", self.uid, update_id);
|
|
self.service.get(url).await
|
|
}
|
|
|
|
pub async fn list_tasks(&self) -> (Value, StatusCode) {
|
|
let url = format!("/indexes/{}/tasks", self.uid);
|
|
self.service.get(url).await
|
|
}
|
|
|
|
pub async fn get_document(
|
|
&self,
|
|
id: u64,
|
|
_options: Option<GetDocumentOptions>,
|
|
) -> (Value, StatusCode) {
|
|
let url = format!(
|
|
"/indexes/{}/documents/{}",
|
|
encode(self.uid.as_ref()).to_string(),
|
|
id
|
|
);
|
|
self.service.get(url).await
|
|
}
|
|
|
|
pub async fn get_all_documents(&self, options: GetAllDocumentsOptions) -> (Value, StatusCode) {
|
|
let mut url = format!(
|
|
"/indexes/{}/documents?",
|
|
encode(self.uid.as_ref()).to_string()
|
|
);
|
|
if let Some(limit) = options.limit {
|
|
url.push_str(&format!("limit={}&", limit));
|
|
}
|
|
|
|
if let Some(offset) = options.offset {
|
|
url.push_str(&format!("offset={}&", offset));
|
|
}
|
|
|
|
if let Some(attributes_to_retrieve) = options.attributes_to_retrieve {
|
|
url.push_str(&format!(
|
|
"attributesToRetrieve={}&",
|
|
attributes_to_retrieve.join(",")
|
|
));
|
|
}
|
|
|
|
self.service.get(url).await
|
|
}
|
|
|
|
pub async fn delete_document(&self, id: u64) -> (Value, StatusCode) {
|
|
let url = format!(
|
|
"/indexes/{}/documents/{}",
|
|
encode(self.uid.as_ref()).to_string(),
|
|
id
|
|
);
|
|
self.service.delete(url).await
|
|
}
|
|
|
|
pub async fn clear_all_documents(&self) -> (Value, StatusCode) {
|
|
let url = format!(
|
|
"/indexes/{}/documents",
|
|
encode(self.uid.as_ref()).to_string()
|
|
);
|
|
self.service.delete(url).await
|
|
}
|
|
|
|
pub async fn delete_batch(&self, ids: Vec<u64>) -> (Value, StatusCode) {
|
|
let url = format!(
|
|
"/indexes/{}/documents/delete-batch",
|
|
encode(self.uid.as_ref()).to_string()
|
|
);
|
|
self.service
|
|
.post(url, serde_json::to_value(&ids).unwrap())
|
|
.await
|
|
}
|
|
|
|
pub async fn settings(&self) -> (Value, StatusCode) {
|
|
let url = format!(
|
|
"/indexes/{}/settings",
|
|
encode(self.uid.as_ref()).to_string()
|
|
);
|
|
self.service.get(url).await
|
|
}
|
|
|
|
pub async fn update_settings(&self, settings: Value) -> (Value, StatusCode) {
|
|
let url = format!(
|
|
"/indexes/{}/settings",
|
|
encode(self.uid.as_ref()).to_string()
|
|
);
|
|
self.service.post(url, settings).await
|
|
}
|
|
|
|
pub async fn delete_settings(&self) -> (Value, StatusCode) {
|
|
let url = format!(
|
|
"/indexes/{}/settings",
|
|
encode(self.uid.as_ref()).to_string()
|
|
);
|
|
self.service.delete(url).await
|
|
}
|
|
|
|
pub async fn stats(&self) -> (Value, StatusCode) {
|
|
let url = format!("/indexes/{}/stats", encode(self.uid.as_ref()).to_string());
|
|
self.service.get(url).await
|
|
}
|
|
|
|
/// Performs both GET and POST search queries
|
|
pub async fn search(
|
|
&self,
|
|
query: Value,
|
|
test: impl Fn(Value, StatusCode) + UnwindSafe + Clone,
|
|
) {
|
|
let (response, code) = self.search_post(query.clone()).await;
|
|
let t = test.clone();
|
|
if let Err(e) = catch_unwind(move || t(response, code)) {
|
|
eprintln!("Error with post search");
|
|
resume_unwind(e);
|
|
}
|
|
|
|
let (response, code) = self.search_get(query).await;
|
|
if let Err(e) = catch_unwind(move || test(response, code)) {
|
|
eprintln!("Error with get search");
|
|
resume_unwind(e);
|
|
}
|
|
}
|
|
|
|
pub async fn search_post(&self, query: Value) -> (Value, StatusCode) {
|
|
let url = format!("/indexes/{}/search", encode(self.uid.as_ref()).to_string());
|
|
self.service.post(url, query).await
|
|
}
|
|
|
|
pub async fn search_get(&self, query: Value) -> (Value, StatusCode) {
|
|
let params = serde_url_params::to_string(&query).unwrap();
|
|
let url = format!(
|
|
"/indexes/{}/search?{}",
|
|
encode(self.uid.as_ref()).to_string(),
|
|
params
|
|
);
|
|
self.service.get(url).await
|
|
}
|
|
|
|
make_settings_test_routes!(distinct_attribute);
|
|
}
|
|
|
|
pub struct GetDocumentOptions;
|
|
|
|
#[derive(Debug, Default)]
|
|
pub struct GetAllDocumentsOptions {
|
|
pub limit: Option<usize>,
|
|
pub offset: Option<usize>,
|
|
pub attributes_to_retrieve: Option<Vec<&'static str>>,
|
|
}
|