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


-- | Extra functionality for shellmate.
--   
--   HTTP downloads and parsing for various file formats.
@package shellmate-extras
@version 0.3


-- | High level functions for downloading files.
module Control.Shell.Download

-- | A Uniform Resource Locator.
type URI = String

-- | Download content specified by a url using curl, returning the content
--   as a <a>String</a>.
fetch :: URI -> Shell String

-- | Download content specified by a url using curl, returning the content
--   as a strict <a>ByteString</a>.
fetchBytes :: URI -> Shell ByteString

-- | Download content specified by a url using curl, writing the content to
--   the file specified by the given <a>FilePath</a>.
fetchFile :: FilePath -> URI -> Shell ()

-- | Download the content as for <a>fetch</a>, but return it as a list of
--   parsed tags using the tagsoup html parser.
fetchTags :: URI -> Shell [Tag String]

-- | Download the content as for <a>fetch</a>, but return it as parsed XML,
--   using the xml-light parser.
fetchXML :: URI -> Shell [Content]

-- | Download the content as for <a>fetch</a>, but return it as as parsed
--   RSS or Atom content, using the feed library parser.
fetchFeed :: URI -> Shell Feed