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


-- | Post tweets from stdin
--   
--   a Command Line Interface Tweeter
@package clit
@version 0.2.0.2


-- | Various utilities to tweet using the twitter api
--   
--   Make sure you have a file credentials file (default the executable
--   looks for is `.cred`) with the following info:
--   
--   <pre>
--   api-key: API_KEY
--   
--   api-sec: API_SECRE
--   
--   tok: OAUTH_TOKEN
--   
--   tok-sec: TOKEN_SECRET
--   </pre>
module Web.Tweet

-- | Tweet a string given a path to credentials; return the id of the
--   status.
--   
--   <pre>
--   basicTweet "On the airplane." ".cred"
--   </pre>
basicTweet :: String -> FilePath -> IO Int

-- | tweet, given a <a>Tweet</a> and path to credentials. Return id of
--   posted tweet.
tweetData :: Tweet -> FilePath -> IO Int

-- | thread tweets together nicely. Takes a string, a list of handles to
--   reply to, plus the ID of the status you're replying to. If you need to
--   thread tweets without replying, pass a <a>Nothing</a> as the third
--   argument.
--   
--   <pre>
--   thread "Hi I'm back in New York!" ["friend1","friend2"] Nothing 1 ".cred"
--   </pre>
thread :: String -> [String] -> Maybe Int -> Int -> FilePath -> IO ()

-- | Default value for Bool for trim_user (<a>True</a> in our case)

-- | Data type for our request: consists of the status text, whether to
--   trium user information in the response, the handles to mention, and
--   optionally the id of the status to reply to.
data Tweet
Tweet :: String -> Bool -> [String] -> Maybe Int -> Tweet
[_status] :: Tweet -> String
[_trimUser] :: Tweet -> Bool
[_handles] :: Tweet -> [String]
[_replyID] :: Tweet -> Maybe Int
trimUser :: Lens' Tweet Bool
status :: Lens' Tweet String
replyID :: Lens' Tweet (Maybe Int)
handles :: Lens' Tweet [String]

-- | Sign a request using your OAuth dev token. Uses the IO monad because
--   signatures require a timestamp
signRequest :: FilePath -> Request -> IO Request

-- | Convert a tweet to a percent-encoded url for querying an API
urlString :: Tweet -> String


-- | Provides IO action that parses command line options and tweets from
--   stdin
module Web.Tweet.Exec

-- | Executes parser
exec :: IO ()

-- | Data type for our program: one optional path to a credential file,
--   (optionally) the number of tweets to make, the id of the status you're
--   replying to, and a list of users you wish to mention.
data Program
Program :: Maybe FilePath -> Maybe String -> Maybe String -> Maybe [String] -> Program