Network.Wai.UrlMap

This module gives you a way to mount applications under sub-URIs. For example:

bugsApp, helpdeskApp, apiV1, apiV2, mainApp :: Application

myApp :: Application
myApp = mapUrls $
      mount "bugs"     bugsApp
  <|> mount "helpdesk" helpdeskApp
  <|> mount "api"
          (   mount "v1" apiV1
          <|> mount "v2" apiV2
          )
  <|> mountRoot mainApp

Documentation

data UrlMap' a

Instances

Functor UrlMap'

Defined in Network.Wai.UrlMap

Methods

fmap :: (a -> b) -> UrlMap' a -> UrlMap' b

(<$) :: a -> UrlMap' b -> UrlMap' a

Applicative UrlMap'

Defined in Network.Wai.UrlMap

Methods

pure :: a -> UrlMap' a

(<*>) :: UrlMap' (a -> b) -> UrlMap' a -> UrlMap' b

liftA2 :: (a -> b -> c) -> UrlMap' a -> UrlMap' b -> UrlMap' c

(*>) :: UrlMap' a -> UrlMap' b -> UrlMap' b

(<*) :: UrlMap' a -> UrlMap' b -> UrlMap' a

Alternative UrlMap'

Defined in Network.Wai.UrlMap

Methods

empty :: UrlMap' a

(<|>) :: UrlMap' a -> UrlMap' a -> UrlMap' a

some :: UrlMap' a -> UrlMap' [a]

many :: UrlMap' a -> UrlMap' [a]

type UrlMap = UrlMap' Application

mount' :: ToApplication a => Path -> a -> UrlMap

Mount an application under a given path. The ToApplication typeclass gives you the option to pass either an Application or an UrlMap as the second argument.

mount :: ToApplication a => Text -> a -> UrlMap

A convenience function like mount', but for mounting things under a single path segment.

mountRoot :: ToApplication a => a -> UrlMap

Mount something at the root. Use this for the last application in the block, to avoid 500 errors from none of the applications matching.

mapUrls :: UrlMap -> Application