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

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

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

impl Election<'_> {
    /// This method grabs district basic election data according to electionId.
    pub async fn get_election(&self, election_id: i32) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&electionId={election_id}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Election.getElection",
            election_id = election_id
        );

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

    /// This method grabs district basic election data according to year and stateid.
    pub async fn get_election_by_year_state(
        &self,
        year: i32,
        state_id: Option<&str>,
    ) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&year={year}&stateId={state_id}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Election.getElectionByYearState",
            year = year,
            state_id = state_id.unwrap_or("")
        );

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

    /// This method grabs district basic election data according to zip code.
    pub async fn get_election_by_zip(
        &self,
        zip5: i32,
        zip4: Option<&str>,
        year: Option<i32>,
    ) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&zip5={zip5}&zip4={zip4}&year={year}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Election.getElectionByZip",
            zip5 = zip5,
            zip4 = zip4.unwrap_or(""),
            year = year.unwrap_or_else(|| time::OffsetDateTime::now_utc().year()),
        );

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

    /// This method grabs district basic election data according to electionId and stageId. Per state lists of a Presidential election are available by specifying the stateId.
    pub async fn get_stage_candidates(
        &self,
        election_id: i32,
        stage_id: i32,
        major: String,
        party: Option<&str>,
        district_id: Option<&str>,
        state_id: Option<&str>,
    ) -> Result<Response, Error> {
        let url = format!(
            "{base_url}{operation}?key={key}&electionId={election_id}&stageId={stage_id}&major={major}&party={party}&districtId={district_id}&stateId={state_id}&o=JSON",
            base_url = &self.0.base_url,
            key = &self.0.api_key,
            operation = "Election.getStageCandidates",
            election_id = election_id,
            stage_id = stage_id,
            major = major,
            party = party.unwrap_or(""),
            district_id = district_id.unwrap_or(""),
            state_id = state_id.unwrap_or(""),
        );

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