-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | A simple abstraction over the "http-client" connection manager
--   
--   A simple abstraction over the "http-client" connection manager
@package http-client-session
@version 0.1.2

module HTTPClient.Session

-- | A session on an HTTP manager.
data Session a
run :: Session a -> Manager -> IO (Either HttpException a)
withManager :: (Manager -> IO (Either HttpException a)) -> Session a
requestLBSResponse :: Request -> Session (Response ByteString)
requestLBSBody :: Request -> Session ByteString
requestBSBody :: Request -> Session ByteString

-- | Keeps track of open connections for keep-alive.
--   
--   If possible, you should share a single <a>Manager</a> between multiple
--   threads and requests.
--   
--   Since 0.1.0
data Manager :: *

-- | An exception which may be generated by this library
data HttpException :: *

-- | Most exceptions are specific to a <a>Request</a>. Inspect the
--   <a>HttpExceptionContent</a> value for details on what occurred.
HttpExceptionRequest :: Request -> HttpExceptionContent -> HttpException

-- | A URL (first field) is invalid for a given reason (second argument).
InvalidUrlException :: String -> String -> HttpException

-- | All information on how to connect to a host and what should be sent in
--   the HTTP request.
--   
--   If you simply wish to download from a URL, see <tt>parseRequest</tt>.
--   
--   The constructor for this data type is not exposed. Instead, you should
--   use either the <tt>defaultRequest</tt> value, or <tt>parseRequest</tt>
--   to construct from a URL, and then use the records below to make
--   modifications. This approach allows http-client to add configuration
--   options without breaking backwards compatibility.
--   
--   For example, to construct a POST request, you could do something like:
--   
--   <pre>
--   initReq &lt;- parseRequest "http://www.example.com/path"
--   let req = initReq
--               { method = "POST"
--               }
--   </pre>
--   
--   For more information, please see
--   <a>http://www.yesodweb.com/book/settings-types</a>.
--   
--   Since 0.1.0
data Request :: *
instance Control.Monad.Error.Class.MonadError Network.HTTP.Client.Types.HttpException HTTPClient.Session.Session
instance Control.Monad.IO.Class.MonadIO HTTPClient.Session.Session
instance GHC.Base.Monad HTTPClient.Session.Session
instance GHC.Base.Applicative HTTPClient.Session.Session
instance GHC.Base.Functor HTTPClient.Session.Session