README.md

This commit is contained in:
Tony Garnock-Jones 2021-08-19 19:28:28 -04:00
parent 8787c3becd
commit 3b740a5d6f
1 changed files with 33 additions and 0 deletions

33
README.md Normal file
View File

@ -0,0 +1,33 @@
# syndicate-sh
This is an implementation of the Syndicate network protocol (based on
[Preserves](https://preserves.gitlab.io/)) for Bash.
**Q.** Is this a joke, or is this serious?
**A.** Yes.
## Dependencies
First, it depends on Bash-specific shell features.
Second, you'll need the `preserves-tool` program, which `syndicate.sh`
uses to slice and dice network packets. It's written in Rust, so you
can get it with:
cargo install preserves-tools
Third, you'll need a Syndicate network server ("broker"). The best
option at present is the Rust-language server:
cargo install syndicate-server
## Running the demo
Start the server in one terminal, in the same directory as the
`syndicate.sh` file:
syndicate-server -s ./sock
Then, in one or more other terminals, run `syndicate.sh`:
./syndicate.sh