beeminder-rs/README.md

beeminder-rs

An incomplete Rust client library for the Beeminder API.

Why use curl if you can just use serde and reqwest to have 200 dependencies?

You'll find that I add endpoints as I need them. Feel free to create an issue if you need a specific endpoint.

Installation

Add to your Cargo.toml:

[dependencies]
beeminder-rs = "0.1.0"

Usage

use beeminder::{BeeminderClient, types::CreateDatapoint};
use time::OffsetDateTime;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = BeeminderClient::new(std::env::var("BEEMINDER_API_KEY")?);

    // username defaults to 'me'; use `with_username` to change it
    // let client = BeeminderClient::new("api-key").with_username("foo");
    
    // Create a datapoint
    let datapoint = CreateDatapoint::new(42.0)
        .with_timestamp(OffsetDateTime::now_utc())
        .with_comment("Meditation session");
        
    client.create_datapoint("meditation", &datapoint).await?;
    
    // Fetch recent datapoints
    let datapoints = client
        .get_datapoints("meditation", Some("timestamp"), Some(10))
        .await?;
        
    Ok(())
}

Requirements

• Valid Beeminder API key

License

MIT