strava-client-rs 0.2.5

Strava API Client lib
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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

//! # Athlete model
//! This model is used to represent the athlete object returned by the Strava API
//! Documentation: https://developers.strava.com/docs/reference/#api-models-DetailedAthlete
//! Contains helper methods to convert units and get athlete information
use serde::{Deserialize, Serialize};

/// Athlete fields returned from the API
#[derive(Serialize, Deserialize, Debug)]
pub struct AthleteCollection {
    pub id: f64,
    pub username: String,
    pub resource_state: i64,
    pub firstname: String,
    pub lastname: String,
    pub city: String,
    pub state: String,
    pub country: String,
    pub sex: String,
    pub premium: bool,
    pub created_at: String,
    pub updated_at: String,
    pub badge_type_id: i64,
    pub profile_medium: String,
    pub profile: String,
    pub friend: Option<serde_json::Value>,
    pub follower: Option<serde_json::Value>,
    pub follower_count: Option<i64>,
    pub friend_count: Option<i64>,
    pub mutual_friend_count: Option<i64>,
    pub athlete_type: Option<i64>,
    pub date_preference: Option<String>,
    pub measurement_preference: Option<String>,
    pub clubs: Option<Vec<Option<serde_json::Value>>>,
    pub ftp: Option<serde_json::Value>,
    pub weight: f64,
    // weight in kg
    pub bikes: Option<Vec<Gear>>,
    pub shoes: Option<Vec<Gear>>,
}

impl AthleteCollection {
    /// Returns the full name of athlete using the firstname and lastname fields
    pub fn get_full_name(&self) -> String {
        format!("{} {}", self.firstname, self.lastname)
    }

    /// Returns the id of the athlete
    pub fn get_id(&self) -> f64 {
        self.id
    }
    /// Returns the username of the athlete
    pub fn get_username(&self) -> String {
        self.username.clone()
    }
    /// Returns the weight in kg of the athlete
    pub fn get_weight(&self) -> f64 {
        self.weight
    }
    /// Converts the weight of the athlete into lb from kg
    pub fn weight_in_lbs(&self) -> f64 {
        self.weight * 2.20462
    }
    /// Returns bool of premium status of athlete
    pub fn get_premium(&self) -> bool {
        self.premium
    }
    /// Returns the sex of the athlete
    pub fn get_sex(&self) -> String {
        self.sex.clone()
    }
    /// Returns the city of the athlete
    pub fn get_city(&self) -> String {
        self.city.clone()
    }
    /// Returns the state of the athlete
    pub fn get_state(&self) -> String {
        self.state.clone()
    }
    /// Returns the shoe Vec of the athlete
    pub fn get_shoes(&self) -> &Vec<Gear> {
        self.shoes.as_ref().unwrap()
    }
    /// Returns the bike vec of the athlete
    pub fn get_bikes(&self) -> &Vec<Gear> {
        self.bikes.as_ref().unwrap()
    }
}

/// Used for both shoes and bikes
#[derive(Serialize, Deserialize, Debug)]
pub struct Gear {
    pub id: String,
    pub primary: bool,
    pub name: String,
    pub resource_state: i64,
    pub distance: f64, // distance in meters
}

/// Athlete stats data
#[derive(Serialize, Deserialize, Debug)]
pub struct AthleteStats {
    pub biggest_ride_distance: f64,
    pub biggest_climb_elevation_gain: Option<serde_json::Value>,
    pub recent_ride_totals: Totals,
    pub all_ride_totals: Totals,
    pub recent_run_totals: Totals,
    pub all_run_totals: Totals,
    pub recent_swim_totals: Totals,
    pub all_swim_totals: Totals,
    pub ytd_ride_totals: Totals,
    pub ytd_run_totals: Totals,
    pub ytd_swim_totals: Totals,
}

/// Athlete totals for each stat
#[derive(Serialize, Deserialize, Debug)]
pub struct Totals {
    pub count: i64,
    pub distance: f64,
    // distance in meters
    pub moving_time: f64,
    // time in seconds
    pub elapsed_time: f64,
    pub elevation_gain: f64,
    pub achievement_count: Option<i64>,
}
impl Totals {
    /// Returns the distance in miles converting from km of the athlete
    pub fn distance_in_miles(&self) -> i64 {
        (self.distance * 0.000621371) as i64
    }
    /// Convert moving time from seconds to mins
    pub fn moving_time_in_mins(&self) -> i64 {
        (self.moving_time / 60.0) as i64
    }
    /// Convert elapsed time  from seconds to mins
    pub fn elapsed_time_in_mins(&self) -> i64 {
        (self.elapsed_time / 60.0) as i64
    }
}