general_pub_sub
| Crates.io | general_pub_sub |
| lib.rs | general_pub_sub |
| version | 0.1.0 |
| source | src |
| created_at | 2021-05-02 18:51:32.40151 |
| updated_at | 2021-05-06 18:36:43.820286 |
| description | A general use, fast, and flexible PubSub implementation |
| homepage | |
| repository | https://github.com/DustinEwan/rust-general_pub_sub |
| max_upload_size | |
| id | 392252 |
| size | 58,944 |
(DustinEwan)
documentation
README
General Pub Sub
A fast, flexible, general use Pub Sub for Rust.
Explore the docs »
Report Bug
·
Request Feature
Table of Contents
About The Project
PubSub is an increasingly commonly used pattern for scaling out applications. However, there isn't a canonical library for implementing PubSub in Rust.
All of the pros / cons of PubSub are beyond the scope of this readme, but the basic gist can be found on the Publish-Subscribe Pattern Wikipedia Page.
My goal with this library is to provide an implementation that is, above all, fast, and is also flexible and easy to use.
Getting Started
Installation
Add the following to your cargo.toml
[dependencies]
general_pub_sub = "<version>"
Alternatively, you could use cargo-edit.
cargo install cargo-edit
cargo add general_pub_sub
Please refer to the crates.io documentation on dependencies for more details.
Usage
Examples of how to utilize PubSub, please refer to the examples in the source code.
All examples can be executed by cloning the repo and running
cargo run --example <name>
for example, to run the networking.rs example:
cargo run --example networking
For more examples and documentation of the API, please refer to the Documentation
Roadmap
See the open issues for a list of proposed features (and known issues).
Contributing
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
-
Fork the Project
-
Create your Feature Branch (
git checkout -b feature/AmazingFeature) -
Commit your Changes (
git commit -m 'Add some AmazingFeature') -
Push to the Branch (
git push origin feature/AmazingFeature) -
Open a Pull Request
License
Distributed under the GNU GPL v3 License. See LICENSE for more information.
Contact
Dustin Ewan - dustineewan@gmail.com
Project Link: https://github.com/dustinewan/rust-general_pub_sub