HeadsUp

A very basic peer-to-peer or multi-user chat application.

Ensure that Rust is installed. Clone this repository, change directories, then type cargo run.

You can specify the IP and port to listen on by using the --server command line switch, e.g.:

cargo run -- --server localhost:5000

Use the --client switch to specify a server url to connect to upon startup:

cargo run -- --server localhost:5000 --client cogciprocate.com:3030

After opening application, type /connect {url} to connect to a server. Type /help at any time for a complete list of commands.

This is an experimental for-fun project but please feel free to report any problems or ask questions on the Issues page.

There are some errors that are not propagated back out to the on_error handler and that are only detectable when logging is enabled. (Relevant issue: housleyjk/ws-rs#155).
- UPDATE: Further investigation has lead to the source of the unpropagated error. See my comment in the above issue thread.
Some errors cause a panic rather than propagating an error. One example is that a client can be running but is not yet connected. When the user tries to close this connection, it causes a panic rather than propagating an error even though this is a very recoverable error. Further investigation required before filing an issue.
- UPDATE: Solved: Using ws::Builder and disabling the panic_on_internal setting alleviates this.
Conclusion: The ws-rs library isn't quite robust enough to be used in a production environment, but it's probably close.

c0gent / headsup