Skip to content

Latest commit

 

History

History
38 lines (25 loc) · 1.3 KB

README.md

File metadata and controls

38 lines (25 loc) · 1.3 KB

Influx Line Protocol

This crate implements InfluxDB Line Protocol v2.

Rationale

The main focus is convenience and safety, and only then performance. Unfortunately, other libraries did not fulfill our needs immediately.

This is how we addressed those concerns:

  • Safety: Each type with its own restrictions.
  • Convenience: built-in traits FromStr and Display for those types.
  • Performance: reducing extra copying and allocations when possible.

We simply like Line Protocol, but we do not need batch parsing all the time. The expected use case for this crate is parsing a single line at once. It may not be optimal, and may not fit everyone.

Comparison to other crates

This package:

  • Intended for parsing lines one-by-one.
    • Imperative style leaning towards "OOP".
  • API and usage as per our company development policies.

influxdb_line_protocol

  • Seemingly intended for batch parsing.
  • Not the most convenient API for us.

rinfluxdb

  • Nice builder-style API for instantiating lines.
  • Not intended for raw string parsing since it's a query client.