pub use crate::generated::services::documents::{DocumentsService, ListDocumentsParams};
use crate::error::Error;
use crate::generated::types::{Document, ReplaceDocumentRequestContent};
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct UpdateDocumentRequest {
pub title: Option<String>,
pub content: Option<String>,
}
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct DocumentFields {
pub title: String,
pub content: String,
}
impl DocumentFields {
fn from_document(document: &Document) -> Result<DocumentFields, Error> {
if document.title.trim().is_empty() {
return Err(Error::malformed_response(
"GetDocument returned a document with a blank \"title\", which the API never \
renders",
)
.with_hint(MALFORMED_HINT));
}
Ok(DocumentFields {
title: document.title.clone(),
content: document.content.clone().unwrap_or_default(),
})
}
fn apply(&mut self, request: &UpdateDocumentRequest) {
if let Some(title) = &request.title {
self.title.clone_from(title);
}
if let Some(content) = &request.content {
self.content.clone_from(content);
}
}
fn into_body(self) -> ReplaceDocumentRequestContent {
ReplaceDocumentRequestContent {
title: Some(self.title),
content: Some(self.content),
}
}
}
const MALFORMED_HINT: &str = "The merge-safe update and edit resend this record's fields \
verbatim, so a malformed response cannot be written back \
safely. Use replace to write the record deliberately.";
impl DocumentsService<'_> {
pub async fn update(
&self,
document_id: i64,
request: &UpdateDocumentRequest,
) -> Result<Document, Error> {
let mut fields = DocumentFields::from_document(&self.get(document_id).await?)?;
fields.apply(request);
self.replace(document_id, &fields.into_body()).await
}
pub async fn edit<F>(&self, document_id: i64, mutate: F) -> Result<Document, Error>
where
F: FnOnce(&mut DocumentFields) -> Result<(), Error>,
{
let mut fields = DocumentFields::from_document(&self.get(document_id).await?)?;
mutate(&mut fields)?;
self.replace(document_id, &fields.into_body()).await
}
}