strava-client-rs 0.1.0

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

//! # Club Module
//!
//! `club.rs` This module is the main interface with the Strava API for club operations. It provides
//! functionality to retrieve data related to a specific club such as the club details,
//! club members, club admins, and club activities.

use crate::api::helpers::{fetch_from_strava_api, strava_v3};
use crate::models::clubs;
use log::{info, trace};

/// Get club details by ID.
///
/// # Arguments
///
/// * `access_token` - The user's access token.
/// * `club_id` - The ID of the club.
///
/// # Returns
///
/// * `Result<clubs::Club>` - Club object or a Boxed Error
pub fn get_club_by_id(
    access_token: &str,
    club_id: &str,
) -> Result<clubs::Club, Box<dyn std::error::Error>> {
    trace!("Club ID: {:?}", club_id);
    let url = strava_v3(format!("/clubs/{}", club_id));
    info!("Calling Clubs by ID Strava API");
    let response = fetch_from_strava_api(url, access_token)?;
    let club: clubs::Club = response.json()?;
    Ok(club)
}

/// Get club members by club ID.
///
/// # Arguments
///
/// * `access_token` - The user's access token.
/// * `club_id` - The ID of the club.
///
/// # Returns
///
/// * `Result<clubs::ClubMembers>` - A list of club members or a Boxed Error
pub fn get_club_members(
    access_token: &str,
    club_id: &str,
) -> Result<clubs::ClubMembers, Box<dyn std::error::Error>> {
    let url = strava_v3(format!("/clubs/{}/members", club_id));
    info!("Calling Strava Club Members API");
    let response = fetch_from_strava_api(url, access_token)?;
    let members: clubs::ClubMembers = response.json()?;
    Ok(members)
}

/// Get club admins by club ID.
///
/// # Arguments
///
/// * `access_token` - The user's access token.
/// * `club_id` - The ID of the club.
///
/// # Returns
///
/// * `Result<clubs::ClubAdmins>` - A list of club admins or a Boxed Error
pub fn get_club_admins(
    access_token: &str,
    club_id: &str,
) -> Result<clubs::ClubAdmins, Box<dyn std::error::Error>> {
    let url = strava_v3(format!("/clubs/{}/admins", club_id));
    info!("Calling Strava Club Admins API");
    let response = fetch_from_strava_api(url, access_token)?;
    let admins: clubs::ClubAdmins = response.json()?;
    Ok(admins)
}

/// Get club activities by club ID.
///
/// # Arguments
///
/// * `access_token` - The user's access token.
/// * `club_id` - The ID of the club.
///
/// # Returns
///
/// * `Result<clubs::ClubActivities>` - A list of club activities or a Boxed Error
pub fn get_club_activities(
    access_token: &str,
    club_id: &str,
) -> Result<clubs::ClubActivities, Box<dyn std::error::Error>> {
    let url = strava_v3(format!("/clubs/{}/activities", club_id));
    info!("Calling Strava Get Club Activities API");
    let response = fetch_from_strava_api(url, access_token)?;
    let club_activities: clubs::ClubActivities = response.json()?;
    Ok(club_activities)
}