Struct GCalClient

pub struct GCalClient { /* private fields */ }

Client is a Google Calendar client. The access key must have already been fetched and the oauth negotiation should have already been completed. The client itself only implements HTTP verbs that accept Sendable implementations. You must use the decorated clients such as EventClient and CalendarListClient to do transactional work.

Implementations

impl GCalClient

pub fn new(token: OToken, oauth: Option<Arc<OAuth>>) -> ClientResult<Self>

Create a new client. Requires an access key.

Examples found in repository

examples/calendars.rs (line 26)

async fn main() {
    let client_id = std::env::var("GOOGLE_CLIENT_ID")
        .expect("[ERR] Missing the GOOGLE_CLIENT_ID environment variable.");
    let client_secret = std::env::var("GOOGLE_CLIENT_SECRET")
        .expect("[ERR] Missing the GOOGLE_CLIENT_SECRET environment variable.");
    let token = OAuth::new(client_id, client_secret, "http://localhost:5000/auth")
        .naive()
        .await
        .expect("[ERR] Failed to get access key.");

    let calendar_client = GCalClient::new(token, None).unwrap().calendar_client();
    let list = calendar_client
        .list(true, CalendarAccessRole::Reader)
        .await
        .unwrap();

    println!("Calendars:");
    for cal in &list {
        eprintln!("  - {} {}", cal.summary, cal.id);
    }
}

examples/events.rs (line 37)

async fn main() {
    let client_id = std::env::var("GOOGLE_CLIENT_ID")
        .expect("[ERR] Missing the GOOGLE_CLIENT_ID environment variable.");
    let client_secret = std::env::var("GOOGLE_CLIENT_SECRET")
        .expect("[ERR] Missing the GOOGLE_CLIENT_SECRET environment variable.");

    let token = OAuth::new(client_id, client_secret, "http://localhost:5000/auth")
        .naive()
        .await
        .expect("[ERR] Failed to get access key.");
    println!("Refresh: {:?}", token.refresh);

    // # Mini example showing how to refresh the access token.
    //
    // println!("Ref: {}", token.refresh.unwrap());
    // let token = OAuth::new(client_id, client_secret, "http://localhost:5000".to_string())
    //     .exhange_refresh("REF TOKEN HERE".to_string())
    //     .await
    //     .unwrap();

    let (calendar_client, event_client) = GCalClient::new(token, None).unwrap().clients();

    let list = calendar_client
        .list(true, CalendarAccessRole::Reader)
        .await
        .unwrap();

    let start = Local::now();
    let end = Local::now().checked_add_signed(Duration::days(7)).unwrap();

    let mut event_list = Vec::new();
    for calendar in list {
        event_list.extend(
            event_client
                .list(calendar.id.clone(), start, end)
                .await
                .unwrap(),
        );
    }

    println!("Events: ");
    for event in &event_list {
        println!("  - {} : {}", event.summary, event.calendar_id);
    }
}

pub fn calendar_client(&self) -> CalendarListClient

Examples found in repository

examples/calendars.rs (line 26)

async fn main() {
    let client_id = std::env::var("GOOGLE_CLIENT_ID")
        .expect("[ERR] Missing the GOOGLE_CLIENT_ID environment variable.");
    let client_secret = std::env::var("GOOGLE_CLIENT_SECRET")
        .expect("[ERR] Missing the GOOGLE_CLIENT_SECRET environment variable.");
    let token = OAuth::new(client_id, client_secret, "http://localhost:5000/auth")
        .naive()
        .await
        .expect("[ERR] Failed to get access key.");

    let calendar_client = GCalClient::new(token, None).unwrap().calendar_client();
    let list = calendar_client
        .list(true, CalendarAccessRole::Reader)
        .await
        .unwrap();

    println!("Calendars:");
    for cal in &list {
        eprintln!("  - {} {}", cal.summary, cal.id);
    }
}

pub fn event_client(&self) -> EventClient

pub fn clients(self) -> (CalendarListClient, EventClient)

Examples found in repository

examples/events.rs (line 37)

async fn main() {
    let client_id = std::env::var("GOOGLE_CLIENT_ID")
        .expect("[ERR] Missing the GOOGLE_CLIENT_ID environment variable.");
    let client_secret = std::env::var("GOOGLE_CLIENT_SECRET")
        .expect("[ERR] Missing the GOOGLE_CLIENT_SECRET environment variable.");

    let token = OAuth::new(client_id, client_secret, "http://localhost:5000/auth")
        .naive()
        .await
        .expect("[ERR] Failed to get access key.");
    println!("Refresh: {:?}", token.refresh);

    // # Mini example showing how to refresh the access token.
    //
    // println!("Ref: {}", token.refresh.unwrap());
    // let token = OAuth::new(client_id, client_secret, "http://localhost:5000".to_string())
    //     .exhange_refresh("REF TOKEN HERE".to_string())
    //     .await
    //     .unwrap();

    let (calendar_client, event_client) = GCalClient::new(token, None).unwrap().clients();

    let list = calendar_client
        .list(true, CalendarAccessRole::Reader)
        .await
        .unwrap();

    let start = Local::now();
    let end = Local::now().checked_add_signed(Duration::days(7)).unwrap();

    let mut event_list = Vec::new();
    for calendar in list {
        event_list.extend(
            event_client
                .list(calendar.id.clone(), start, end)
                .await
                .unwrap(),
        );
    }

    println!("Events: ");
    for event in &event_list {
        println!("  - {} : {}", event.summary, event.calendar_id);
    }
}

pub fn set_debug(&mut self)

pub async fn get( &self, action: Option<String>, target: impl Sendable, ) -> ClientResult<Response>

Perform a GET request.

pub async fn post( &self, action: Option<String>, target: impl Sendable, ) -> ClientResult<Response>

Perform a POST request.

pub async fn put( &self, action: Option<String>, target: impl Sendable, ) -> ClientResult<Response>

Perform a PUT request.

pub async fn patch( &self, action: Option<String>, target: impl Sendable, ) -> ClientResult<Response>

Perform a PATCH request.

pub async fn delete( &self, action: Option<String>, target: impl Sendable, ) -> ClientResult<Response>

Perform a DELETE request.

Trait Implementations

impl Clone for GCalClient

fn clone(&self) -> GCalClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GCalClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.