Network.Curl

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.

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

Fields

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.

perform_with_response :: Curl -> IO CurlResponse

Perform the actions already specified on the handle. Collects useful information about the returned message. Note that this function sets the CurlWriteFunction and CurlHeaderFunction options.

do_curl :: Curl -> URLString -> [CurlOption] -> IO CurlResponse

Performs a curl request using an exisitng curl handle. The provided URL will overwride any CurlURL options that are provided in the list of options. See also: perform_with_response.

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]

parseStatusNHeaders :: String -> (String, [(String, String)])

concRev :: [a] -> [[a]] -> [a]