Running and options
Bond.run(app, host, port) serves the app with the HTTP server of std/http and returns when it closes. Bond.start(app, host, port) returns the server at once. With port 0 it picks a free port, and Bond.local_port(server) says which. Bond.wait(server) waits for it and Bond.stop(server) closes it.
The server belongs to the task that started it, so call it from main.
import Bond from "pkg/bond/bond"
def hello(conn: Bond.Conn) -> Result[Bond.Conn]
return ok(Bond.text(conn, 200, "hello"))
end
def main() -> Void
app = Bond.app() |> Bond.get("/hello", &hello)
server = Bond.start(app, "127.0.0.1", 0).unwrap!
puts("listening on #{Bond.local_port(server)}")
Bond.wait(server).unwrap!
endOptions #
Bond.run_with(app, host, port, options) and Bond.start_with(app, host, port, options) take the options of the server of std/http. HTTP.ServerOptions has request_timeout_ms, idle_timeout_ms, max_connections and max_body_bytes. Every field has a default, so HTTP.ServerOptions(max_body_bytes: 4_194_304) changes one field and keeps the rest. The other functions use HTTP.ServerOptions().
Bond reads the body whole before it calls the app, as Conn holds it as bytes. A refused body is answered by HTTP.body_refusal and the app is not called: a body over max_body_bytes is a 413, a chunk line that is too long a 431 and a bad chunk a 400, all with Connection: close. A client that leaves before the body is whole gets no answer.