Data.Swagger.ParamSchema

Convert a type into a plain ParamSchema.

An example type and instance:

{-# LANGUAGE OverloadedStrings #-}   -- allows to write Text literals

import Control.Lens

data Direction = Up | Down

instance ToParamSchema Direction where
  toParamSchema _ = mempty
     & type_ ?~ SwaggerString
     & enum_ ?~ [ "Up", "Down" ]

Instead of manually writing your ToParamSchema instance you can use a default generic implementation of toParamSchema.

To do that, simply add deriving Generic clause to your datatype and declare a ToParamSchema instance for your datatype without giving definition for toParamSchema.

For instance, the previous example can be simplified into this:

{-# LANGUAGE DeriveGeneric #-}

import GHC.Generics (Generic)

data Direction = Up | Down deriving Generic

instance ToParamSchema Direction

A configurable generic ParamSchema creator.

>>> :set -XDeriveGeneric>>> data Color = Red | Blue deriving Generic>>> encode $ genericToParamSchema defaultSchemaOptions (Proxy :: Proxy Color)"{\"enum\":[\"Red\",\"Blue\"],\"type\":\"string\"}"

Default plain schema for Bounded, Integral types.

>>> encode $ toParamSchemaBoundedIntegral (Proxy :: Proxy Int8)"{\"maximum\":127,\"minimum\":-128,\"type\":\"integer\"}"

Default schema for password string. "password" format is used to hint UIs the input needs to be obscured.

Default schema for binary data (any sequence of octets).

Default schema for binary data (base64 encoded).

Options that specify how to encode your type to Swagger schema.

Default encoding SchemaOptions.

SchemaOptions
{ fieldLabelModifier     = id
, constructorTagModifier = id
, datatypeNameModifier   = id
, allNullaryToStringTag  = True
, unwrapUnaryRecords     = False
}