votesmart 0.2.2

A client wrapper for the Votesmart 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

use crate::VotesmartProxy;
use reqwest::{Error, Response};

pub struct Officials<'a>(pub &'a VotesmartProxy);

impl Officials<'_> {
    /// This method grabs a list of officials according to state representation
    pub async fn get_statewide(&self, state_id: String) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&stateId={state_id}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Officials.getStatewide",
            state_id = state_id,
        );

        self.0.client.get(url).send().await
    }

    /// This method grabs a list of officials according to office and state representation.
    pub async fn get_by_office_state(
        &self,
        office_id: i32,
        state_id: Option<&str>,
    ) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&officeId={office_id}&stateId={state_id}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Officials.getByOfficeState",
            office_id = office_id,
            state_id = state_id.unwrap_or(""),
        );

        self.0.client.get(url).send().await
    }

    /// This method grabs a list of officials according to office type and state representation.
    pub async fn get_by_office_type_state(
        &self,
        office_type_id: i32,
        state_id: Option<&str>,
    ) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&officeTypeId={office_type_id}&stateId={state_id}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Officials.getByOfficeTypeState",
            office_type_id = office_type_id,
            state_id = state_id.unwrap_or(""),
        );

        self.0.client.get(url).send().await
    }

    /// This method grabs a list of officials according to a lastName match.
    pub async fn get_by_last_name(&self, last_name: String) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&lastName={last_name}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Officials.getByLastname",
            last_name = last_name
        );

        self.0.client.get(url).send().await
    }

    /// This method grabs a list of officials according to a fuzzy lastName match.
    pub async fn get_by_levenshtein(&self, last_name: String) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&lastName={last_name}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Officials.getByLevenshtein",
            last_name = last_name
        );

        self.0.client.get(url).send().await
    }

    /// This method grabs a list of officials according to the district they are running for.
    pub async fn get_by_district(&self, district_id: i32) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&districtId={district_id}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Officials.getByDistrict",
            district_id = district_id
        );

        self.0.client.get(url).send().await
    }

    /// This method grabs a list of officials according to the zip code they represent.
    pub async fn get_by_zip(&self, zip5: i32, zip4: Option<&str>) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&zip5={zip5}&zip4={zip4}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Officials.getByZip",
            zip5 = zip5,
            zip4 = zip4.unwrap_or("")
        );

        self.0.client.get(url).send().await
    }
}