5 releases

0.1.4 Mar 4, 2021
0.1.3 Mar 2, 2021
0.1.2 Mar 2, 2021
0.1.1 Feb 28, 2021
0.1.0 Feb 28, 2021

#4 in #client-library

Download history 44/week @ 2024-09-20 33/week @ 2024-09-27 18/week @ 2024-10-04 54/week @ 2024-10-11 51/week @ 2024-10-18 62/week @ 2024-10-25 31/week @ 2024-11-01 57/week @ 2024-11-08 70/week @ 2024-11-15 38/week @ 2024-11-22 32/week @ 2024-11-29 73/week @ 2024-12-06 23/week @ 2024-12-13 1/week @ 2024-12-20 15/week @ 2024-12-27 27/week @ 2025-01-03

90 downloads per month

MIT license

13KB
327 lines

🦀 InfluxDB Rust Client

tests docs

NB! - This library is still in development and is not ready for production!

An unofficial client-library for InfluxDB v2.

⬇️ Installation

influxdb-client = "0.1.4"

❤️‍🔥 Usage

Insert by building a Point

use influxdb_client::{Client, Point, Precision, TimestampOptions};

let client = Client::new("http://localhost:8086", "token")
    .with_org_id("168f31904923e853")
    .with_bucket("tradely")
    .with_precision(Precision::MS);

let point = Point::new("test")
    .tag("ticker", "GME")
    .field("price", 420.69)
    .timestamp(1614956250000);

let points = vec![point];

// Insert with the timestamp from the point (1614956250000)
let result = client.insert_points(&points, TimestampOptions::FromPoint).await;

Insert using a struct


use influxdb_client::{Client, Precision, PointSerialize, TimestampOptions, Timestamp};
use influxdb_client::derives::PointSerialize;

let client = Client::new("http://localhost:8086", "token")
    .with_org_id("168f31904923e853")
    .with_bucket("tradely")
    .with_precision(Precision::MS);

#[derive(PointSerialize)]
#[point(measurement = "test")]
struct Ticker {
    #[point(tag)]
    ticker: String,
    #[point(field = "tickerPrice")]
    price: f64,
    #[point(timestamp)]
    timestamp: Timestamp,
}

let point = Ticker {
    ticker: String::from("GME"),
    price: 420.69,
    timestamp: Timestamp::from(1614956250000)
};

let points = vec![point];

// Insert without timestamp - InfluxDB will automatically set the timestamp
let result = client.insert_points(&points, TimestampOptions::None).await;

🪧 TODO

This todolist is still in progress and will be expanded in the future.

  • Implement insertion into InfluxDB from client
  • Implement procedural macro for implementing PointSerialize
  • Implement querying
  • Implement other important things

Dependencies

~4–20MB
~216K SLoC