https://github.com/yoeight/eventstoredb-client-rust-experimental

Rust EventStoreDB gRPC Client with experimental features.
https://github.com/yoeight/eventstoredb-client-rust-experimental

Last synced: 10 days ago
JSON representation

Rust EventStoreDB gRPC Client with experimental features.

• Host: GitHub
• URL: https://github.com/yoeight/eventstoredb-client-rust-experimental
• Owner: YoEight
• License: mit
• Created: 2021-12-09T15:16:41.000Z (almost 3 years ago)
• Default Branch: experimental
• Last Pushed: 2023-12-17T04:14:05.000Z (11 months ago)
• Last Synced: 2024-10-13T04:15:25.181Z (24 days ago)
• Language: Rust
• Size: 1.36 MB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# EventStoreDB Rust Client

[![Crates.io][crates-badge]][crates-url]

[![Crates.io][crates-download]][crates-url]

[![Build Status][ci-badge]][ci-url]

![Discord](https://img.shields.io/discord/415421715385155584.svg)

![Crates.io](https://img.shields.io/crates/l/eventstore.svg)

[crates-badge]: https://img.shields.io/crates/v/eventstore.svg

[crates-download]: https://img.shields.io/crates/d/eventstore.svg

[crates-url]: https://crates.io/crates/eventstore

[ci-badge]: https://github.com/EventStore/EventStoreDB-Client-Rust/workflows/CI/badge.svg

[ci-url]: https://github.com/EventStore/EventStoreDB-Client-Rust/actions

[Documentation](https://docs.rs/eventstore)

Official Rust [EventStoreDB rust gRPC] gRPC Client.

[EventStoreDB] is an open-source database built from the ground up for Event Sourcing, with Complex Event Processing in Javascript.

## EventStoreDB Server Compatibility

This client is compatible with version `20.6.1` upwards and works on Linux, MacOS and Windows.

Server setup instructions can be found here [EventStoreDB Docs], follow the docker setup for the simplest configuration.

# Example

```rust

use eventstore::{ Client, EventData };

use serde::{Serialize, Deserialize};

#[derive(Serialize, Deserialize, Debug)]

struct Foo {

    is_rust_a_nice_language: bool,

}

#[tokio::main]

async fn main() -> Result<(), Box> {

    // Creates a client settings for a single node configuration.

    let settings = "esdb://admin:changeit@localhost:2113".parse()?;

    let client = Client::new(settings)?;

    let payload = Foo {

        is_rust_a_nice_language: true,

    };

    // It is not mandatory to use JSON as a data format however EventStoreDB

    // provides great additional value if you do so.

    let evt = EventData::json("language-poll", &payload)?;

    client

        .append_to_stream("language-stream", &Default::default(), evt)

        .await?;

    let mut stream = client

        .read_stream("language-stream", &Default::default())

        .await?;

    while let Some(event) = stream.next().await? {

        let event = event.get_original_event()

          .as_json::()?;

        // Do something productive with the result.

        println!("{:?}", event);

    }

    Ok(())

}

```

## Support

Information on support can be found here: [EventStoreDB Support]

## Documentation

Documentation for EventStoreDB can be found here: [EventStoreDB Docs]

Bear in mind that this client is not yet properly documented. We are working hard on a new version of the documentation.

## Community

We have a community discussion space at [EventStoreDB Discuss].

[EventStoreDB]: https://eventstore.com/

[EventStoreDB rust gRPC]: https://developers.eventstore.com/clients/grpc/getting-started?codeLanguage=Rust

[eventstoredb docs]: https://developers.eventstore.com/latest.html

[eventstoredb discuss]: https://discuss.eventstore.com/

[eventstoredb support]: https://eventstore.com/support/