mediawiki_rest_api 0.2.1

A Rust client for the MediaWiki REST 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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

use crate::{
    error::RestApiError,
    prelude::{RestApi, SearchResults},
};
use std::collections::HashMap;

#[derive(Clone, Copy, Debug)]
pub struct Search;

impl Search {
    pub async fn search<S: Into<String>>(_ctype: S, _api: &RestApi) -> Result<(), RestApiError> {
        unimplemented!()
    }

    pub async fn page<S: Into<String>>(
        query: S,
        limit: Option<usize>,
        api: &RestApi,
    ) -> Result<SearchResults, RestApiError> {
        let path = "/search/page";
        let mut params = HashMap::new();
        params.insert("q".to_string(), query.into());
        if let Some(limit) = limit {
            params.insert("limit".to_string(), limit.to_string());
        }
        let request = api
            .build_request(path, params, reqwest::Method::GET)
            .await?
            .build()?;
        let response = api.execute(request).await?;
        let ret: SearchResults = response.json().await?;
        Ok(ret)
    }

    pub async fn title<S: Into<String>>(
        query: S,
        limit: Option<usize>,
        api: &RestApi,
    ) -> Result<SearchResults, RestApiError> {
        let path = "/search/title";
        let mut params = HashMap::new();
        params.insert("q".to_string(), query.into());
        if let Some(limit) = limit {
            params.insert("limit".to_string(), limit.to_string());
        }
        let request = api
            .build_request(path, params, reqwest::Method::GET)
            .await?
            .build()?;
        let response = api.execute(request).await?;
        let ret: SearchResults = response.json().await?;
        Ok(ret)
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use serde_json::Value;
    use wiremock::matchers::{method, path, query_param};
    use wiremock::{Mock, MockServer, ResponseTemplate};

    #[tokio::test]
    async fn test_search_page() {
        let query = "Rust programming language";
        let test_text: String =
            std::fs::read_to_string("test_data/search_page.json").expect("Test file missing");
        let json: Value = serde_json::from_str(&test_text).expect("Failed to parse JSON");

        let mock_server = MockServer::start().await;
        Mock::given(method("GET"))
            .and(path("w/rest.php/v1/search/page"))
            .and(query_param("q", query))
            .respond_with(ResponseTemplate::new(200).set_body_json(&json))
            .mount(&mock_server)
            .await;
        let api = RestApi::builder(&(mock_server.uri() + "/w/rest.php"))
            .expect("Failed to create RestApi")
            .build();

        // let api = crate::rest_api_builder::RestApiBuilder::wikipedia("en").build();
        let results = Search::page(query, None, &api)
            .await
            .expect("Failed to get page content");
        assert_eq!(results.pages.len(), 50);
    }

    #[tokio::test]
    async fn test_search_title() {
        let query = "Rust";
        let test_text: String =
            std::fs::read_to_string("test_data/search_title.json").expect("Test file missing");
        let json: Value = serde_json::from_str(&test_text).expect("Failed to parse JSON");

        let mock_server = MockServer::start().await;
        Mock::given(method("GET"))
            .and(path("w/rest.php/v1/search/title"))
            .and(query_param("q", query))
            .respond_with(ResponseTemplate::new(200).set_body_json(&json))
            .mount(&mock_server)
            .await;
        let api = RestApi::builder(&(mock_server.uri() + "/w/rest.php"))
            .expect("Failed to create RestApi")
            .build();

        // let api = crate::rest_api_builder::RestApiBuilder::wikipedia("en").build();
        let results = Search::title(query, None, &api)
            .await
            .expect("Failed to get page content");
        assert!(
            results
                .pages
                .iter()
                .any(|page| page.title == "Rust (programming language)")
        );
    }
}