README.md

A Relay Server

The relay-server is an HTTP service that has two functions:

• Accepting messages and storing all of them. POST method. For example, curl 'http://127.0.0.1:9776' -X POST -d 'message'.
• Returning the messages in the same order as received for each client. For example, curl 'http://127.0.0.1:9776/?id=alice'.

Installation (optional)

cargo install relay-server --git https://github.com/Trust-Machines/core-eng

Start the relay-server server

Run

cargo run relay-server 

from the root of the repository, or

relay-server

if the relay-server is installed.

The default address is http://127.0.0.1:9776.

Integration Test

1. Start the server cargo run relay-server
2. Run ./test.sh in another terminal.
3. Close the server using Ctrl+C.

Using the server as a library

The relay-server library is designed not to use IO directly, and all IO bindings are moved to executables. See /src/bin/relay-server.rs as an example.

// create a server
let mut server = relay_server::Server::default();
// send a message using a bidirectional stream.
{
  const REQUEST: &str = "\
    POST / HTTP/1.0\r\n\
    Content-Length: 6\r\n\
    \r\n\
    Hello!";
  let response = server.call(REQUEST.as_bytes()).unwrap();
  const RESPONSE: &str = "\
    HTTP/1.0 200 OK\r\n\
    \r\n";
  assert_eq!(std::str::from_utf8(&response).unwrap(), RESPONSE);
}