Mini tutorial

[ppom0]

Hi!
This library really looks amazing, I was looking for a Rust Serf implementation and I'm glad I found it :)

However I'm strugling to figure out how to use it. An example mini-agent implementation that would just print received messages to stdout (or something like this) would really help the onboarding! Or even bigger examples if you're already using it elsewhere 👀

Many thanks

[al8n]

Hi! Thanks!
I will work on the examples. For now, maybe you can get some ideas about how to use it from the test cases.

[ppom0]

Okay thanks!

[austin-barrington]

Hello @al8n, Did you get anywhere with some examples / tutorials please? I am using the go implementation of serf at the moment and would like to explore the rust implementation.

[al8n]

Hello @al8n, Did you get anywhere with some examples / tutorials please? I am using the go implementation of serf at the moment and would like to explore the rust implementation.

Hi @austin-barrington, unfortunately, you can only reference the test cases in https://github.com/al8n/serf/tree/main/core/src/serf/base/tests and https://github.com/al8n/serf/tree/main/serf/test to find how to use it.

Basically, the usage should be similar to Go's implementation, the only differences are:

1. Users need to choose a runtime tokio, async-std or smol.
2. Users need to choose a transport implementation from memberlist, either memberlist::net::NetTransport or memberlist::quinn::QuinnTransport, there are some type alias in serf.
3. Users need to choose an encoding/decoding layer, the builtin one is Lpe.

[alidehghan]

could you please provide an easy sample to run? @al8n

[austin-barrington]

Thanks, I completed the go implementation which is being used a distributed control plane in my project but I shall give this a go when I next get time to focus. If I can I'll try make a minimal version you might be able to use here. (no promises though)

[al8n]

The example (a toy eventually consensus distributed database) will be available in the next release within 2 weeks.

[al8n]

Need more time to refactor the encoding/decoding, and adapt to the newest memberlist.

[al8n]

A toy eventually consistent distributed registry toyconsul is available now.

A production level example (A standalone serf server and client) will be implemented in the next few weeks.

A Discord server is also available here

[ppom0]

Great, thanks!
I'll try to integrate it into reaction this year 😃