#bolt #protocol #neo4j

bolt-proto

Bolt protocol primitives: values, messages, and serialization / deserialization

13 releases (breaking)

Uses new Rust 2021

0.11.0 Nov 24, 2021
0.10.0 Mar 30, 2021
0.9.2 Mar 29, 2021
0.9.1 Sep 18, 2020
0.3.0 Dec 25, 2019

#139 in Network programming

Download history 38/week @ 2021-08-14 11/week @ 2021-08-21 16/week @ 2021-09-04 600/week @ 2021-09-11 507/week @ 2021-09-18 657/week @ 2021-09-25 604/week @ 2021-10-02 756/week @ 2021-10-09 732/week @ 2021-10-16 529/week @ 2021-10-23 184/week @ 2021-10-30 382/week @ 2021-11-06 356/week @ 2021-11-13 592/week @ 2021-11-20 177/week @ 2021-11-27

1,549 downloads per month
Used in 6 crates (3 directly)

MIT license

84KB
2K SLoC

This crate contains the primitives used in the Bolt protocol. The Message and Value enums are of particular importance, and are the primary units of information sent and consumed by Bolt clients/servers.

The Message enum encapsulates all possible messages that can be sent between client and server.

pub enum Message {
    // V1-compatible message types
    Init(Init),
    Run(Run),
    DiscardAll,
    PullAll,
    AckFailure,
    Reset,
    Record(Record),
    Success(Success),
    Failure(Failure),
    Ignored,

    // V3+-compatible message types
    Hello(Hello),
    Goodbye,
    RunWithMetadata(RunWithMetadata),
    Begin(Begin),
    Commit,
    Rollback,

    // V4+-compatible message types
    Discard(Discard),
    Pull(Pull),

    // V4.3+-compatible message types
    Route(Route),
}

See the documentation for more details.

The Value enum encapsulates all possible values that can be sent in each kind of Message. Structures like List and Map allow Values to be nested with arbitrary complexity.

pub enum Value {
    // V1-compatible value types
    Boolean(bool),
    Integer(i64),
    Float(f64),
    Bytes(Vec<u8>),
    List(Vec<Value>),
    Map(HashMap<String, Value>),
    Null,
    String(String),
    Node(Node),
    Relationship(Relationship),
    Path(Path),
    UnboundRelationship(UnboundRelationship),

    // V2+-compatible value types
    Date(NaiveDate),                       // A date without a time zone, i.e. LocalDate
    Time(NaiveTime, FixedOffset),          // A time with UTC offset, i.e. OffsetTime
    DateTimeOffset(DateTime<FixedOffset>), // A date-time with UTC offset, i.e. OffsetDateTime
    DateTimeZoned(DateTime<Tz>),           // A date-time with time zone ID, i.e. ZonedDateTime
    LocalTime(NaiveTime),                  // A time without time zone
    LocalDateTime(NaiveDateTime),          // A date-time without time zone
    Duration(Duration),
    Point2D(Point2D),
    Point3D(Point3D),
}

You should rarely ever have to construct variants directly (with the exception of Value::Null). Instead, you should typically use Value::from on the type you wish to convert. See the documentation for more details.

Dependencies

~2.5–3.5MB
~65K SLoC

ua