Package mig-server version 0.2.1.0-0

mig-server

Version 0.2.1.0 revision 0 uploaded 2023-11-29T07:03:22.000Z by AntonKholomiov.

Package meta

Synopsis

Build lightweight and composable servers

Description

With library mig we can build lightweight and composable servers. There are only couple of combinators to assemble servers from parts. It supports generic handler functions as servant does. But strives to use more simple model for API. It does not go to describing Server API at type level which leads to simpler error messages.

The main features are:

lightweight library
expressive DSL to compose servers
type-safe handlers
handlers are encoded with generic haskell functions
built on top of WAI and warp server libraries.

Example of hello world server:

{-# Language OverloadedStrings #-}
import Mig.Json.IO

-- | We can render the server and run it on port 8085.
-- It uses wai and warp.
main :: IO ()
main = runServer 8085 server

-- | Init simple hello world server whith two routes:
server :: Server IO
server =
  "api/v1" /.
      [ "hello" /. hello
      , "bye" /. bye
      ]

-- | Handler takes no inputs and marked as Get HTTP-request that returns Text.
hello :: Get (Resp Text)
hello = pure $ ok "Hello World"

-- | Handle with URL-param query and json body input as Post HTTP-request that returns Text.
bye :: Query "name" Text -> Body Text -> Post (Resp Text)
bye (Query name) (Body greeting) =
  pure $ ok $ "Bye to " <> name <> " " <> greeting

Please see: