This gem is a plugin for Lita, a customisable chatbot. To install Lita in your chat room, visit Lita. Raindar is specific to Australia - the chatbot responds to a users request of 'weather LOCATION' with a GIF of the most recent radar from the Bureau of Meteorology. It is responsive to all locations in Australia that have a radar listed on the BOM website.

Add this line to your application's Gemfile:

gem 'raindar'

And then execute:

$ bundle

Or install it yourself as:

$ gem install raindar

In lita_config.rb, it is necessary to set an imgur_api_key:

$ config.handlers.raindar.imgur_api_key = ENV["IMGUR_API_KEY"]

Once the gem is installed and imgur_api_key set, the commands are as follows. Note that lita is used as an example. This will be your specific robot name

lita weather LOCATION

To print a list of known locations:

lita radar locations

Locations are:

Adelaide
Albany
Alice Springs
Bairnsdale
Bowen
Brisbane
Broome
Cairns
Canberra
Carnarvon
Ceduna
Dampier
Darwin
Emerald
Esperance
Geraldton
Giles
Gladstone
Gove
Grafton
Gulf of Carpentaria
Gympie
Halls Creek
Hobart
Kalgoorlie
Katherine
Learmonth
Longreach
Mackay
Melbourne
Mildura
Moree
Mount Isa
Mt Gambier
Namoi
Newcastle
Perth
Port Headland
Sydney
Townsville
Wagga Wagga
Warrego
Warruwi
Weipa
West Takone
Willis Island
Wollongong
Woomera
Wyndham
Yarrawonga

Bug reports and pull requests are welcome on GitHub at https://github.com/eleanorakh/raindar. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

The gem is available as open source under the terms of the MIT License.