!6      !"#$%&'()* + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { |}~     Safe1345ST=Union of two APIs, first takes precedence in case of overlap.Example::{8type MyApi = "books" :> Get '[JSON] [Book] -- GET /booksM :<|> "books" :> ReqBody '[JSON] Book :> Post '[JSON] () -- POST /books:}33Safe,-1F#=A simple datatype to hold data required to decorate a request'Combinator for  -https://tools.ietf.org/html/rfc2617#section-2Basic Access Authentication.6IMPORTANT*: Only use Basic Auth over HTTPS! Credentials are not hashed or encrypted. Note also that because the same credentials are sent on every request, Basic Auth is not as secure as some alternatives. Further, the implementation in servant-server does not protect against some types of timing attacks.QIn Basic Auth, username and password are base64-encoded and transmitted via the  AuthorizationF header. Handshakes are not required, making it relatively efficient.#$&%''#$%&#$%&Safe,-1F"Y(ICapture all remaining values from the request path under a certain type a.Example: -- GET /src/*Jtype MyAPI = "src" :> CaptureAll "segments" Text :> Get '[JSON] SourceFile);Capture a value from the request path under a certain type a.Example:-- GET /books/:isbn?type MyApi = "books" :> Capture "isbn" Text :> Get '[JSON] Book())( None+,-16;=>?FNSTVJ**A type for responses without content-body.5YInstantiate this class to register a way of deserializing a type based on the request's  Content-Type header.)import Network.HTTP.Media hiding (Accept)2import qualified Data.ByteString.Lazy.Char8 as BSC)data MyContentType = MyContentType String:{#instance Accept MyContentType whereE contentType _ = "example" // "prs.me.mine" /: ("charset", "utf-8"):}:{5instance Read a => MimeUnrender MyContentType a where- mimeUnrender _ bs = case BSC.take 12 bs ofC "MyContentType" -> return . read . BSC.unpack $ BSC.drop 12 bs8 _ -> Left "didn't start with the magic incantation":}Ftype MyAPI = "path" :> ReqBody '[MyContentType] Int :> Get '[JSON] Int7"Variant which is given the actual  provided by the other party.8In the most cases you don't want to branch based on the . See  3https://github.com/haskell-servant/servant/pull/552pr552 for a motivating example.:MInstantiate this class to register a way of serializing a type based on the Accept header.Example: data MyContentType instance Accept MyContentType where contentType _ = "example" // "prs.me.mine" /: ("charset", "utf-8") instance Show a => MimeRender MyContentType a where mimeRender _ val = pack ("This is MINE! " ++ show val) type MyAPI = "path" :> Get '[MyContentType] Int> Instances of >> represent mimetypes. They are used for matching against the Accept2 HTTP header of the request, and for setting the  Content-Type header of the responseExample:&import Network.HTTP.Media ((//), (/:)) data HTML:{instance Accept HTML where; contentType _ = "text" // "html" /: ("charset", "utf-8"):}FLike @ but allows all JSON values instead of just objects and arrays.;Will handle trailing whitespace, but not trailing junk. ie.-eitherDecodeLenient "1 " :: Either String IntRight 11eitherDecodeLenient "1 junk" :: Either String Int1Left "trailing junk after valid JSON: endOfInput"G application/octet-streamH text/plain;charset=utf-8I !application/x-www-form-urlencodedJ application/jsonKL idM BC.packN fromStrict . TextS.encodeUtf8OPurlEncodeAsForm Note that the *mimeUnrender p (mimeRender p x) == Right x> law only holds if every element of x is non-null (i.e., not ("", ""))QR Right . toStrictS  Right . idT Right . BC.unpackU (left show . TextS.decodeUtf8' . toStrictV left show . TextL.decodeUtf8'WurlDecodeAsForm Note that the *mimeUnrender p (mimeRender p x) == Right x> law only holds if every element of x is non-null (i.e., not ("", ""))X eitherDecode*+,-./0123456789:;<=>@?ABCDEFDCBA>?@:;567*+<=8923401./,-FE *+,-./0123456789:;<=>?@ Safe,-1FRl/Add more verbose description for (part of) API.Example::{type MyApi = Description? "This comment is visible in multiple Servant interpretations \( \and can be really long if necessary. \, \Haskell multiline support is not perfect \ \but it's still very readable.":> Get '[JSON] Book:}m&Add a short summary for (part of) API.Example:^type MyApi = Summary "Get book by ISBN." :> "books" :> Capture "isbn" Text :> Get '[JSON] Booklmlm Safe1V2nVAn empty API: one which serves nothing. Morally speaking, this should be the unit of :<|>=. Implementors of interpretations of API types should treat n" as close to the unit as possible.nonono Safe,-1FY tgA generalized Authentication combinator. Use this if you have a non-standard authentication technique.5NOTE: THIS API IS EXPERIMENTAL AND SUBJECT TO CHANGE.tt Safe,-13F\u4Extract the given header's value as a value of type a.Example:2newtype Referer = Referer Text deriving (Eq, Show)-- GET /view-my-refererNtype MyApi = "view-my-referer" :> Header "from" Referer :> Get '[JSON] RefereruvwxuvwxuvwxSafe]dSafe16f|-Was this request made over an SSL connection?UNote that this value will not tell you if the client originally made this request over SSL, but rather whether the current connection is SSL. The distinction lies with reverse proxies. In many cases, the client will connect to a load balancer over SSL, but connect to the WAI handler without SSL. In such a case, the handlers would get ~=, but from a user perspective, there is a secure connection.}1the connection to the server is secure (HTTPS)~4the connection to the server is not secure (HTTP)|}~|}~|}~Safe,-1FSTwM]Lookup a potentially value-less query string parameter with boolean semantics. If the param sym] is there without any value, or if it's there with value "true" or "1", it's interpreted as ". Otherwise, it's interpreted as .Example:-- /books?publishedCtype MyApi = "books" :> QueryFlag "published" :> Get '[JSON] [Book]$Lookup the values associated to the symB query string parameter and try to extract it as a value of type [a]K. This is typically meant to support query string parameters of the form param[]=val1&param[]=val2< and so on. Note that servant doesn't actually require the [],s and will fetch the values just fine with param=val1&param=val2, too.Example:5-- /books?authors[]=<author1>&authors[]=<author2>&...Htype MyApi = "books" :> QueryParams "authors" Text :> Get '[JSON] [Book]#Lookup the value associated to the symB query string parameter and try to extract it as a value of type a.Example:-- /books?author=<author name>Ftype MyApi = "books" :> QueryParam "author" Text :> Get '[JSON] [Book]Safe1&Endpoint for plugging in your own Wai  Applications. The given  ApplicationY will get the request as received by the server, potentially with a modified (stripped) pathInfo if the  Application is being routed with .:In addition to just letting you plug in your existing WAI  Applications, this can also be used with  ghttps://hackage.haskell.org/package/servant-server/docs/Servant-Utils-StaticFiles.html#v:serveDirectoryserveDirectoryK to serve static files stored in a particular directory on your filesystemSafe1dRProvides access to the host or IP address from which the HTTP request was sent.Safe,-1F,Extract the request body as a value of type a.Example:-- POST /booksAtype MyApi = "books" :> ReqBody '[JSON] Book :> Post '[JSON] BookNone&',-3;<=>?AFSTVNote: if there are multiple occurences of a header in the argument, the values are interspersed with commas before deserialization (see  <http://www.w3.org/Protocols/rfc2616/rfc2616-sec4.html#sec4.2RFC2616 Sec 4.2)XResponse Header objects. You should never need to construct one directly. Instead, use .The underlying value of a HList of headers. addHeader` adds a header to a response. Note that it changes the type of the value in the following ways: .A simple value is wrapped in "Headers '[hdr]":Mlet example1 = addHeader 5 "hi" :: Headers '[Header "someheader" Int] String;getHeaders example1[("someheader","5")] YA value that already has a header has its new header *prepended* to the existing list:Mlet example1 = addHeader 5 "hi" :: Headers '[Header "someheader" Int] String;flet example2 = addHeader True example1 :: Headers '[Header "1st" Bool, Header "someheader" Int] StringgetHeaders example2#[("1st","true"),("someheader","5")]Note that while in your handlers type annotations are not required, since the type can be inferred from the API type, in other cases you may find yourself needing to add annotations.,Deliberately do not add a header to a value.Ilet example1 = noHeader "hi" :: Headers '[Header "someheader" Int] StringgetHeaders example1[]3N.B.: The same header can't be added multiple timesSafe,1FSTg7The contained API (second argument) can be found under  ("/" ++ path)" (path being the first argument).Example:-- GET /hello/world'-- returning a JSON encoded World value4type MyApi = "hello" :> "world" :> Get '[JSON] World4NoneSafe,-16F  with 206 status code.  with 205 status code. with 205 status code. with 205 status code.  with 205 status code.  with 205 status code.  with 204 status code. with 204 status code. with 204 status code.  with 204 status code.  with 204 status code.  with 203 status code. with 203 status code. with 203 status code.  with 203 status code.  with 203 status code.  with 202 status code. with 202 status code. with 202 status code.  with 202 status code.  with 202 status code.  with 201 status code. with 200 status code. with 200 status code.  with 200 status code.  with 200 status code.  with 200 status code.Verb is a general type for representing HTTP verbs (a.k.a. methods). For convenience, type synonyms for each verb with a 200 response code are provided, but you are free to define your own:;type Post204 contentTypes a = Verb 'POST 204 contentTypes a( 1 None +,->?FSTQ HIf both a or b produce an empty constraint, produce an empty constraint.JIf either a or b produce an empty constraint, produce an empty constraint.+Check that a value is an element of a list:,ok (Proxy :: Proxy (Elem Bool '[Int, Bool]))OK.ok (Proxy :: Proxy (Elem String '[Int, Bool]))...... [Char]...'[Int, Bool......Append two type-level lists.Apply (e :>) to every API in xs.Check that every element of xs is an endpoint of api (using ).Aok (Proxy :: Proxy (AllIsIn (Endpoints SampleAPI) SampleAPI)) OKCheck whether sub is a sub API of api.Like  , but uses  rather than .Closed type family, check if endpoint is exactly within api.Aok (Proxy :: Proxy (IsIn ("hello" :> Get '[JSON] Int) SampleAPI))OKUnlike !, this requires an *exact* match.Qok (Proxy :: Proxy (IsIn (Get '[JSON] Int) (Header "h" Bool :> Get '[JSON] Int)))...... Could not deduce......Check that every element of xs is an endpoint of api (using ).Check whether sub is a sub-API of api.Iok (Proxy :: Proxy (IsSubAPI SampleAPI (SampleAPI :<|> Get '[JSON] Int)))OKIok (Proxy :: Proxy (IsSubAPI (SampleAPI :<|> Get '[JSON] Int) SampleAPI))...... Could not deduce...... This uses IsElem0 for checking; thus the note there applies here.Closed type family, check if endpoint is within api. Uses " if it exhausts all other options.Cok (Proxy :: Proxy (IsElem ("hello" :> Get '[JSON] Int) SampleAPI))OKAok (Proxy :: Proxy (IsElem ("bye" :> Get '[JSON] Int) SampleAPI))...... Could not deduce......eAn endpoint is considered within an api even if it is missing combinators that don't affect the URL:Sok (Proxy :: Proxy (IsElem (Get '[JSON] Int) (Header "h" Bool :> Get '[JSON] Int)))OKXok (Proxy :: Proxy (IsElem (Get '[JSON] Int) (ReqBody '[JSON] Bool :> Get '[JSON] Int)))OKN.B.:*  IsElem a bH can be seen as capturing the notion of whether the URL represented by a$ would match the URL represented by b*, *not* whether a request represented by a matches the endpoints serving b (for the latter, use ).You may use this type family to tell the type checker that your custom type may be skipped as part of a link. This is useful for things like H that are optional in a URI and do not affect them if they are omitted.data CustomThing7type instance IsElem' e (CustomThing :> s) = IsElem e s Note that 0 is called, which will mutually recurse back to ) if it exhausts all other options again.Once you have written a HasLink instance for  CustomThing you are ready to go.%Flatten API into a list of endpoints.Refl :: Endpoints SampleAPI :~: '["hello" :> Verb 'GET 200 '[JSON] Int, "bye" :> (Capture "name" String :> Verb 'POST 200 '[JSON, PlainText] Bool)]ReflSafe-FV names a specific tagged context to use for the combinators in the API. (See also in servant-server, Servant.Server.Context.) For example: ntype UseNamedContextAPI = WithNamedContext "myContext" '[String] ( ReqBody '[JSON] Int :> Get '[JSON] Int) Both the ReqBody and Get combinators will use the - with type tag "myContext" as their context.Contexts are only relevant for servant-server.'For more information, see the tutorial.None+,-;=>?AFSTV #Construct a toLink for an endpoint.#How to encode array query elements. foo[]=1&foo[]=2  foo=1&foo=2Query parameter.6A safe link datatype. The only way of constructing a  is using , which means any / is guaranteed to be part of the mentioned API. Transform  into .)type API = "something" :> Get '[JSON] Int<linkURI $ safeLink (Proxy :: Proxy API) (Proxy :: Proxy API) something:type API = "sum" :> QueryParams "x" Int :> Get '[JSON] IntFlinkURI $ safeLink (Proxy :: Proxy API) (Proxy :: Proxy API) [1, 2, 3]sum?x[]=1&x[]=2&x[]=3'type API = "foo/bar" :> Get '[JSON] Int<linkURI $ safeLink (Proxy :: Proxy API) (Proxy :: Proxy API) foo%2FbarBtype SomeRoute = "abc" :> Capture "email" String :> Put '[JSON] ()(let someRoute = Proxy :: Proxy SomeRoute/safeLink someRoute someRoute "test@example.com"BLink {_segments = ["abc","test%40example.com"], _queryParams = []}9linkURI $ safeLink someRoute someRoute "test@example.com"abc/test%40example.com Configurable .:type API = "sum" :> QueryParams "x" Int :> Get '[JSON] Int_linkURI' LinkArrayElementBracket $ safeLink (Proxy :: Proxy API) (Proxy :: Proxy API) [1, 2, 3]sum?x[]=1&x[]=2&x[]=3]linkURI' LinkArrayElementPlain $ safeLink (Proxy :: Proxy API) (Proxy :: Proxy API) [1, 2, 3]sum?x=1&x=2&x=3@Create a valid (by construction) relative URI with query params.%This function will only typecheck if endpoint is part of the API apiCreate all links in an API.Note that the apiI type must be restricted to the endpoints that have valid links to them.rtype API = "foo" :> Capture "name" Text :> Get '[JSON] Text :<|> "bar" :> Capture "name" Int :> Get '[JSON] Double8let fooLink :<|> barLink = allLinks (Proxy :: Proxy API) :t fooLinkfooLink :: Text -> Link :t barLinkbarLink :: Int -> Link4Note: nested APIs don't work well with this approachy:kind! MkLink (Capture "nest" Char :> (Capture "x" Int :> Get '[JSON] Int :<|> Capture "y" Double :> Get '[JSON] Double))wMkLink (Capture "nest" Char :> (Capture "x" Int :> Get '[JSON] Int :<|> Capture "y" Double :> Get '[JSON] Double)) :: *-= Char -> (Int -> Link) :<|> (Double -> Link)+The API endpoint you would like to point to-The whole API that this endpoint is a part of+The API endpoint you would like to point to' !"#$NoneUz%&'()*+,- #$%&'()*+567:;>@?ABCDlmnotuvwx|}~None1;=>?AFQSTV Map the leafs of an API type. Helper type family to state the  symmetry.Like .. Log the contents of /P with the function provided as the first argument, and return the value of the WriterT computation Like  , but for lazy WriterT. Like mmorph's 0. Like mmorph's 1.Like mmorph's 2.Like mmorph's 3.          None-ST4  !"!#!$!%!&!'!(!)!*!+,-.,-/,-01231241251261271281289:;<<=>?@ABCDEEFGHIJ K K L M N O P Q R S T U V W X Y Z [ \ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~                 !"#$%&'()*+,-./0*123456789:;<=>?@>?ABCCDEFGHFGIFGJFGKFGLFGMFGNFGOFGPQRSQTUVWXVWYVWZVW[\%servant-0.12.1-29b8uknnaUX9kT63waxDFZServant.API.HttpVersionServant.API.VerbsServant.Utils.EnterServant.Utils.LinksServant.API.VaultServant.API.AlternativeServant.API.BasicAuthServant.API.CaptureServant.API.ContentTypesServant.API.DescriptionServant.API.EmptyServant.API.Experimental.AuthServant.API.HeaderServant.API.IsSecureServant.API.QueryParamServant.API.RawServant.API.RemoteHostServant.API.ReqBodyServant.API.ResponseHeadersServant.API.SubServant.API.TypeLevelServant.API.WithNamedContext*Servant.API.Internal.Test.ComprehensiveAPI Data.Aeson eitherDecode:> Servant.API&http-types-0.11-2S6BQkKLMX49qmdMBIfo0RNetwork.HTTP.Types.Version httpMinor httpMajor HttpVersionNetwork.HTTP.Types.MethodPATCHOPTIONSCONNECTTRACEDELETEPUTHEADPOSTGET StdMethod1natural-transformation-0.4-6wBZb2D4z6vGOq59DPbie9Control.Natural$$NT:~>)network-uri-2.6.1.0-RmiO7Es4EVIxdXQfHHaUt Network.URI uriFragmenturiQueryuriPath uriAuthority uriSchemeURI$vault-0.3.0.7-CpYaErKpkSKD9hnmq7g45GData.Vault.LazyVault:<|> $fMonoid:<|>$fSemigroup:<|>$fEq:<|> $fShow:<|> $fFunctor:<|>$fTraversable:<|>$fFoldable:<|> $fBounded:<|> BasicAuthDatabasicAuthUsernamebasicAuthPassword BasicAuth CaptureAllCapture NoContentAllMimeUnrenderallMimeUnrender AllMimeRender allMimeRenderAllMimeallMime AllCTUnrendercanHandleCTypeH handleCTypeH MimeUnrender mimeUnrendermimeUnrenderWithType AllCTRender handleAcceptH MimeRender mimeRender AcceptHeaderAccept contentType contentTypes OctetStreamFormUrlEncoded PlainTextJSONcanHandleAcceptHeitherDecodeLenient$fAcceptTYPEOctetStream$fAcceptTYPEPlainText$fAcceptTYPEFormUrlEncoded$fAcceptTYPEJSON%$fMimeRenderTYPEOctetStreamByteString&$fMimeRenderTYPEOctetStreamByteString0$fMimeRenderTYPEPlainText[]$fMimeRenderTYPEPlainTextText$fMimeRenderTYPEPlainTextText0$fMimeRenderTYPEFormUrlEncodeda$fMimeRenderTYPEJSONa'$fMimeUnrenderTYPEOctetStreamByteString($fMimeUnrenderTYPEOctetStreamByteString0$fMimeUnrenderTYPEPlainText[]$fMimeUnrenderTYPEPlainTextText $fMimeUnrenderTYPEPlainTextText0!$fMimeUnrenderTYPEFormUrlEncodeda$fMimeUnrenderTYPEJSONa $fAllMime: $fAllMime[]$fAllCTRender[]()$fAllMimeRender:a$fAllMimeRender:a0$fAllCTRender:a$fAllMimeUnrender:a$fAllMimeUnrender[]a$fAllCTUnrenderctypsa$fAllMimeRender:NoContent$fAllMimeRender:NoContent0$fEqAcceptHeader$fShowAcceptHeader$fReadAcceptHeader$fGenericAcceptHeader$fShowNoContent $fEqNoContent$fReadNoContent$fGenericNoContent DescriptionSummaryEmptyAPI $fEqEmptyAPI$fShowEmptyAPI$fBoundedEmptyAPI$fEnumEmptyAPI AuthProtectHeader MissingHeaderUndecodableHeader $fEqHeader $fShowHeader$fFunctorHeaderIsSecureSecure NotSecure $fEqIsSecure$fShowIsSecure$fReadIsSecure$fGenericIsSecure $fOrdIsSecure QueryFlag QueryParams QueryParamRaw RemoteHostReqBody AddHeader GetHeaders getHeadersBuildHeadersTobuildHeadersTo HeaderValMapHListHNilHConsHeaders getResponsegetHeadersHList addHeadernoHeader$fBuildHeadersTo:$fBuildHeadersTo[]$fGetHeadersHeaders$fGetHeadersHeaders0$fGetHeadersHList$fGetHeadersHList0$fAddHeaderhvanew$fAddHeaderhvHeadersHeaders$fFunctorHeaders ReflectMethod reflectMethodGetPartialContentPutResetContentPatchResetContentDeleteResetContentPostResetContentGetResetContent PutNoContentPatchNoContentDeleteNoContent PostNoContent GetNoContentPutNonAuthoritativePatchNonAuthoritativeDeleteNonAuthoritativePostNonAuthoritativeGetNonAuthoritative PutAccepted PatchAcceptedDeleteAccepted PostAccepted GetAccepted PostCreatedPatchDeletePutPostGetVerb$fReflectMethodStdMethodCONNECT$fReflectMethodStdMethodTRACE$fReflectMethodStdMethodOPTIONS$fReflectMethodStdMethodHEAD$fReflectMethodStdMethodPATCH$fReflectMethodStdMethodDELETE$fReflectMethodStdMethodPUT$fReflectMethodStdMethodPOST$fReflectMethodStdMethodGET $fGenericVerbAndOrElemGoElem IsSubList AppendListMapSubAllIsInIsStrictSubAPIIsIn AllIsElemIsSubAPIIsElemIsElem' EndpointsWithNamedContextHasLinkMkLinktoLinkLinkArrayElementStyleLinkArrayElementBracketLinkArrayElementPlainParam SingleParamArrayElemParam FlagParamLink linkSegmentslinkQueryParamslinkURIlinkURI'safeLinkallLinks $fShowEscaped$fToHttpApiDataLink$fHasLinkTYPE:>$fHasLinkTYPERaw$fHasLinkTYPEVerb$fHasLinkTYPE:>0$fHasLinkTYPE:>1$fHasLinkTYPE:>2$fHasLinkTYPE:>3$fHasLinkTYPE:>4$fHasLinkTYPE:>5$fHasLinkTYPE:<|>$fHasLinkTYPE:>6$fHasLinkTYPE:>7$fHasLinkTYPE:>8$fHasLinkTYPE:>9 $fShowParam $fShowLink$fEqLinkArrayElementStyle$fOrdLinkArrayElementStyle$fShowLinkArrayElementStyle$fEnumLinkArrayElementStyle$fBoundedLinkArrayElementStyleEnterenterEnteredliftNat runReaderTNatevalStateTLNatevalStateTSNatlogWriterTSNatlogWriterTLNathoistNatembedNat squashNat generalizeNat $fEntermmnn$fEnterTaggedmnTagged$fEnter(->)mn(->)$fEnter:<|>m1n1:<|>ComprehensiveAPIWithoutRawComprehensiveAPIcomprehensiveAPIcomprehensiveAPIWithoutRaw)http-media-0.7.1.1-AkJhKzuSnpj5UBL7xZLUM5%Network.HTTP.Media.MediaType.Internal MediaTypebytestring-0.10.8.2Data.ByteString.Lazy fromStrict#text-1.2.2.2-EakMpasry3jA6OIwSZhq9MData.Text.Lazy.Encoding encodeUtf8$aeson-1.2.3.0-IKViWrdpe5qGW36sSFwXh7encodeghc-prim GHC.TypesTrueFalseaddOptionalHeaderEscaped _segments _queryParams,http-api-data-0.3.7.1-8EeT2qzQFwbJEvK9gSheeSWeb.Internal.HttpApiData ToHttpApiData toUrlPiecetoEncodedUrlPiecetoHeader toQueryParamFromHttpApiData parseUrlPiece parseHeaderparseQueryParamtransformers-0.5.2.0Control.Monad.Trans.Classlift!Control.Monad.Trans.Writer.StrictWriterT#mmorph-1.1.0-66Wi5WnKrYM86tQZg3s0IxControl.Monad.Morphhoistembedsquash generalize