a4ad4fe69e
* test: add tests for the desired contract for parsing measurements from line protocol * fix: restrict null chars in measurement * chore: make an explicit Measurement type * refactor: have iox lp parser match influxdb contract, for acceptance of eq in measurements * test: create end_to_end test to confirm same write-then-read behavior with `=` in measurements, is the same as influxdb |
||
---|---|---|
.. | ||
src | ||
Cargo.toml | ||
README.md | ||
RELEASE.md |
README.md
influxdb_line_protocol
This crate contains pure Rust implementations of
-
A parser for InfluxDB Line Protocol developed as part of the InfluxDB IOx project. This implementation is intended to be compatible with the Go implementation, however, this implementation uses a nom combinator-based parser rather than attempting to port the imperative Go logic so there are likely some small diferences.
-
A builder to contruct valid InfluxDB Line Protocol
Example
Here is an example of how to parse the following line
protocol data into a ParsedLine
:
cpu,host=A,region=west usage_system=64.2 1590488773254420000
use influxdb_line_protocol::{ParsedLine, FieldValue};
let mut parsed_lines =
influxdb_line_protocol::parse_lines(
"cpu,host=A,region=west usage_system=64i 1590488773254420000"
);
let parsed_line = parsed_lines
.next()
.expect("Should have at least one line")
.expect("Should parse successfully");
let ParsedLine {
series,
field_set,
timestamp,
} = parsed_line;
assert_eq!(series.measurement, "cpu");
let tags = series.tag_set.unwrap();
assert_eq!(tags[0].0, "host");
assert_eq!(tags[0].1, "A");
assert_eq!(tags[1].0, "region");
assert_eq!(tags[1].1, "west");
let field = &field_set[0];
assert_eq!(field.0, "usage_system");
assert_eq!(field.1, FieldValue::I64(64));
assert_eq!(timestamp, Some(1590488773254420000));