A preview of the RedEyes web framework

RedEyesPreview.scala

/*
 * RedEyes generates rich descriptions of the API, as well as valid examples for
 * all parameters (in this case, example header, query parameter, and content).
 *
 * The API can also be used to generate client libraries in a variety of languages.
 *
 * Service handlers are strongly-typed (e.g. retrieveEmployees expects an integer 
 * and a ModelDesc). Any errors in using the API automatically generate rich
 * descriptions on what was expected.
 */
val headers = contentType("application/json") <|> contentType("text/json")

val api = Handlers.retrieveEmployees <| GET >*> path("/employees/") >*> headers >*> queryInt("limit") <*> (contentText[ModelDesc] ^? "A filter on the employees to retrieve")

val documentation = describe(api).toMarkdown

val server = NioServerCompiler.compile(api)

server.run(config).unsafePerformIO