Skip to content

A communication framework that wraps over rust websocket implementations to enforce standardised communication between peers.

License

Notifications You must be signed in to change notification settings

riptide-org/ws-com-framework

Repository files navigation

Websocket Communication Framework for RipTide

Test codecov

Overview

During the development of the RipTide filesharing application, a reliable means of communication between the central api and the server agent was required. Ws-com-framework is a simple framework for converting message to/from binary to be sent over websocket implementations.

It relies on protobuf3 and the prost crate internally for these conversions.

Development

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Install protoc
sudo dnf install protobuf protobuf-devel #F36

# Run tests
cargo test

Contributing

Code Guidelines

Please write tests if we have good test coverage we can avoid any bugs down the line.

Outside of this we use standard Rust formatting for code. This will be enforced through use of clippy and rustfmt.

Commit Guidelines

In all commits, please try to follow the convention for commits.

Ideally aim to push every commit you make, rather than accumulating a large number of commits before pushing, this helps to keep everyone on the same codebase when collaborating.

The exception for this is that you should not commit non-compiling code to the main branch. Open a new branch and commit to that instead.

Use of Pull Requests

Outside of exceptional cases, please always push commits to a new branch and then generate a pull request with your new feature. Automated actions will attempt to validate that your code does not break anything existing, but this doesn't guarantee your code works. Please write tests!

About

A communication framework that wraps over rust websocket implementations to enforce standardised communication between peers.

Topics

Resources

License

Stars

Watchers

Forks

Languages