perspective_api 1.0.0

An unopinionated client and a somewhat opinionated service for the Perspective API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

use reqwest::StatusCode;
use tracing::debug;
use url::Url;

use crate::client::AnalyzeCommentError;
use crate::client::AnalyzeCommentErrorResponse;
use crate::client::AnalyzeCommentRequest;
use crate::client::AnalyzeCommentResponse;
use crate::client::PerspectiveClient;

use super::BASE_URL;
// Tests for the interaction with the API are in the `tests` directory.
impl PerspectiveClient {
    /// This function encapsulates the interaction with the Perspective API, taking a request object and returning a success response or a custom error.
    pub async fn analyze(&self, request: AnalyzeCommentRequest) -> Result<AnalyzeCommentResponse, AnalyzeCommentError> {
        let url = Url::parse_with_params(BASE_URL, [("key", &self.api_key)]).expect("no api_keys can fail this function and the base url is const");
        debug!("URL: {}", &url);

        let response = self.client.post(url).json(&request).send().await?;

        match response.status() {
            StatusCode::OK => {
                let body = &response.text().await?;
                debug!("Response: {}", &body);
                Ok(serde_json::from_str(body)?)
            }
            StatusCode::FORBIDDEN => Err(AnalyzeCommentError::NoApiKey),
            _ => {
                let body = &response.text().await?;
                debug!("Response: {}", &body);
                Err(serde_json::from_str::<AnalyzeCommentErrorResponse>(body)?)?
            }
        }
    }
}