servant-reason alternatives and similar packages
Based on the "servant" category.
Alternatively, view servant-reason alternatives based on common mentions on social networks and blogs.
-
servant
Servant is a Haskell DSL for describing, serving, querying, mocking, documenting web applications and more! -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
servant-generate
Generate default implementations for servers in a flexible way (a.k.a servant-mock on steroids) -
-
CodeRabbit: AI Code Reviews for Developers
Do you think we are missing an alternative of servant-reason or a related project?
README
Servant Reason
Automatically derive bindings for Servant APIs in Reason. Originally build by converting servant-elm to Reason. Types are generated using reason-export.
More docs on Hackage.
A full example of how to integrate Servant and Reason is available at servant-reason-example.
Usage
Run the tests if you want a concrete example. They will build a _test-cache directory that contains a sample Reason repository for a servant API. test also contain example output files for different kinds of bindings.
Usage is simple and automatic. If you have an API like the one below
{-# LANGUAGE DataKinds #-}
{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE TypeOperators #-}
import Reason (Spec (Spec), specsToDir, toReasonDecoderSource,
toReasonTypeSource)
import GHC.Generics (Generic)
import Servant.API ((:>), Capture, Get, JSON)
import Servant.Reason (ReasonType, Proxy (Proxy), defReasonImports,
generateReasonForAPI)
data Book = Book
{ name :: String
} deriving (Generic)
instance ReasonType Book
type BooksApi = "books" :> Capture "bookId" Int :> Get '[JSON] Book
You can expose your API to reason with:
module Main where
import Data.Proxy
import Reason
import Data.Text hiding (intercalate, map)
import Db
main :: IO ()
main = do
let code = defReasonImports
: toReasonTypeSource (Proxy :: Proxy Book)
: toReasonDecoderSource (Proxy :: Proxy Book)
: generateReasonForAPI (Proxy :: Proxy BooksApi))
writeFile "Api.re" $ intercalate "\n\n" $ map unpack code
That's it. You can now include Api.re in a Reason project.
Reason setup
The generated code needs access to two Reason libraries @glennsl/bs-json and bs-fetch. Get the latest install instructions from the upstream repos, but at the time of writing these were:
npm install --save @glennsl/bs-json
npm install --save bs-fetch
Then add @glennsl/bs-json and bs-fetch to bs-dependencies in your bsconfig.json:
{
...
"bs-dependencies": ["@glennsl/bs-json", "bs-fetch"]
}