rodeo v0.3.0 Rodeo.HTTP

Encapsulates starting, configuring, reloading, and stopping of cowboy web server instances.

Summary

Functions

change_handler!(handler, identifier \\ __MODULE__)

Shortcut for Rodeo.HTTP.reload({"/", handler, []})

reload(matches, identifier \\ __MODULE__)

See Rodeo.HTTP.router for format of matches

router()

Defines a default handler

router(matches)

matches must be in format: [{ "/foo/[...]", Handler, opts }]

start(port \\ 8080, identifier \\ __MODULE__)

Starts the server on a given TCP port port (default: 8080). You can pass :auto to find a random available TCP port. identifier is passed to :cowboy as its listener id

Functions

change_handler!(handler, identifier \\ __MODULE__)

Shortcut for Rodeo.HTTP.reload({"/", handler, []}).

reload(matches, identifier \\ __MODULE__)

See Rodeo.HTTP.router for format of matches.

Example:

iex>Rodeo.HTTP.start
 {:ok, #PID<0.306.0>}

 iex>Rodeo.HTTP.reload( {"/my/new/match", OtherHandler, []} )
 :ok

router()

Defines a default handler

router(matches)

matches must be in format: [{ "/foo/[...]", Handler, opts }]

start(port \\ 8080, identifier \\ __MODULE__)

start(integer, atom) :: {atom, pid, integer}

Starts the server on a given TCP port port (default: 8080). You can pass :auto to find a random available TCP port. identifier is passed to :cowboy as its listener id.

Returns a {:ok, pid, port} tuple.