HeadsUp

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

Installation and Usage

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.

Problems?

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

ws-rs Library Notes/Problems:

• 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.

License

Licensed under the MIT license (LICENSE or http://opensource.org/licenses/MIT).