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


-- | Weather api implemented in haskell
--   
--   This library implement generic api for retrieving weather by http, and
--   has google weather api as example.
@package weather-api
@version 0.0


-- | Usage:
--   
--   required imports
--   
--   <pre>
--   import WeatherApi
--   import WeatherApi.Google
--   </pre>
--   
--   With handler in case server will alow you to make few requests with
--   one connection
--   
--   <pre>
--   &gt;&gt;&gt; let h = mkWeatherHandler $ initApi "en" "utf-8"
--   
--   &gt;&gt;&gt; getWeather h "moscow"
--   Right (Weather { tempF = 75.0
--                  , tempC = 24.0
--                  , humidity = "Humidity: 25%"
--                  , windCondition = "Wind: S at 16 mph"
--                  , condition = "Clear"
--                  })
--   </pre>
--   
--   Simple case
--   
--   <pre>
--   &gt;&gt;&gt; getWeather' (initApi "en" "utf-8") "moscow"
--   Right (Weather { tempF = 75.0
--                  , tempC = 24.0
--                  , humidity = "Humidity: 25%"
--                  , windCondition = "Wind: S at 16 mph"
--                  , condition = "Clear"
--                  })
--   </pre>
module WeatherApi
data WeatherApiHandler
WeatherApiHandler :: IO (HandleStream String) -> Config -> WeatherApiHandler
stream :: WeatherApiHandler -> IO (HandleStream String)
config :: WeatherApiHandler -> Config
data Config
Config :: String -> Int -> (HandleStream String -> String -> IO (Either String Weather)) -> Config
apiHost :: Config -> String
apiPort :: Config -> Int
queryFun :: Config -> HandleStream String -> String -> IO (Either String Weather)
data Weather
Weather :: Double -> Double -> String -> String -> String -> Weather
tempF :: Weather -> Double
tempC :: Weather -> Double
humidity :: Weather -> String
windCondition :: Weather -> String
condition :: Weather -> String

-- | Retrieve weather using existing handler
getWeather :: WeatherApiHandler -> String -> IO (Either String Weather)

-- | Retrieve weather using just config It's usefull when you don't need
--   one connection for few requests
getWeather' :: Config -> String -> IO (Either String Weather)
mkWeatherHandler :: Config -> WeatherApiHandler
isHandlerAlive :: WeatherApiHandler -> IO Bool
closeHandler :: WeatherApiHandler -> IO ()
instance Eq Weather
instance Show Weather

module WeatherApi.Google

-- | Make config for use with WeatherApi functions
initApi :: Lang -> Enc -> Config