Network.Curl

curl-1.3.1: Haskell binding to libcurl

Network.Curl

Portability	portable
Stability	provisional
Maintainer	emertens@galois.com

Description

A Haskell binding the libcurl library http://curl.haxx.se/, a proven and feature-rich library for interacting with HTTP(S)/FTP servers.

The binding was initially made against version 7.16.2; libcurl does appear to be considerate in not introducing breaking changes wrt older versions. So, unless you're after the latest features (i.e., constructors towards the end the Option type), there's a very good chance your code will work against older installations of libcurl.

Synopsis

module Network.Curl.Opts

module Network.Curl.Easy

module Network.Curl.Post

module Network.Curl.Info

module Network.Curl.Types

module Network.Curl.Code

withCurlDo :: IO a -> IO a

setopts :: Curl -> [CurlOption] -> IO ()

data CurlResponse = CurlResponse {

respCurlCode :: CurlCode

respStatus :: Int

respStatusLine :: String

respHeaders :: [(String, String)]

respBody :: String

respGetInfo :: Info -> IO InfoValue

}

curlGet :: URLString -> [CurlOption] -> IO ()

curlGetString :: URLString -> [CurlOption] -> IO (CurlCode, String)

curlGetResponse :: URLString -> [CurlOption] -> IO CurlResponse

curlHead :: URLString -> [CurlOption] -> IO (String, [(String, String)])

curlMultiPost :: URLString -> [CurlOption] -> [HttpPost] -> IO ()

curlPost :: URLString -> [String] -> IO ()

getResponseCode :: Curl -> IO Int

setDefaultSSLOpts :: Curl -> URLString -> IO ()

callbackWriter :: (String -> IO ()) -> WriteFunction

easyWriter :: (String -> IO ()) -> WriteFunction

ignoreOutput :: WriteFunction

gatherOutput :: IORef [String] -> WriteFunction

method_GET :: [CurlOption]

method_HEAD :: [CurlOption]

method_POST :: [CurlOption]

Documentation

module Network.Curl.Opts

module Network.Curl.Easy

module Network.Curl.Post

module Network.Curl.Info

module Network.Curl.Types

module Network.Curl.Code

withCurlDo :: IO a -> IO a

Should be used once to wrap all uses of libcurl. WARNING: the argument should not return before it is completely done with curl (e.g., no forking or lazy returns)

setopts :: Curl -> [CurlOption] -> IO ()

Set a list of options on a Curl handle.

data CurlResponse

CurlResponse is a record type encoding all the information embodied in a response to your Curl request. Currently only used to gather up the results of doing a GET in curlGetResponse.

Constructors

CurlResponse

respCurlCode :: CurlCode
respStatus :: Int
respStatusLine :: String
respHeaders :: [(String, String)]
respBody :: String
respGetInfo :: Info -> IO InfoValue

curlGet :: URLString -> [CurlOption] -> IO ()

curlGet perform a basic GET, dumping the output on stdout. The list of options are set prior performing the GET request.

curlGetString :: URLString -> [CurlOption] -> IO (CurlCode, String)

curlGetString performs the same request as curlGet, but returns the response body as a Haskell string.

curlGetResponse :: URLString -> [CurlOption] -> IO CurlResponse

curlGetResponse performs a GET, returning all the info it can lay its hands on in the response, a value of type CurlResponse.

curlHead :: URLString -> [CurlOption] -> IO (String, [(String, String)])

Get the headers associated with a particular URL. Returns the status line and the key-value pairs for the headers.

curlMultiPost :: URLString -> [CurlOption] -> [HttpPost] -> IO ()

curlMultiPost perform a multi-part POST submission.

curlPost :: URLString -> [String] -> IO ()

curlPost performs. a common POST operation, namely that of submitting a sequence of name=value pairs.

getResponseCode :: Curl -> IO Int

setDefaultSSLOpts :: Curl -> URLString -> IO ()

callbackWriter :: (String -> IO ()) -> WriteFunction

Imports data into the Haskell world and invokes the callback.

easyWriter :: (String -> IO ()) -> WriteFunction

ignoreOutput :: WriteFunction

The output of Curl is ignored. This function does not marshall data into Haskell.

gatherOutput :: IORef [String] -> WriteFunction

Add chunks of data to an IORef as they arrive.

method_GET :: [CurlOption]

method_HEAD :: [CurlOption]

method_POST :: [CurlOption]

Produced by Haddock version 2.6.0