hipchat.rb

require 'httparty'
require 'cgi'

class Hipchat
  include HTTParty

  class << self
    # Defaults to use if options aren't provided
    # Most of these are hipchat API defaults
    DEFAULTS = {
      :auth_token => ENV['HIPCHAT_AUTH_TOKEN'],
      :room_id => ENV['HIPCHAT_ROOM_ID'],
      :from => ENV['HIPCHAT_FROM'] || 'Cruise Control',
      :message_format => 'html',
      :notify => '1', # default is 0, but I like notifications
      :color => 'yellow',
      :format => 'json',
      :message => '' # This has to be overridden, btw.
    }

    def hip_post(message, options = {})
      # Chunkify message in case the message is over the 10,000 characters limit
      # Note, I'm chunkifying at 9,000 to account for the extra characters CGI::escape may end up adding. I know, I know, I should do this differently, it's a TODO, okay?
      start, last = 0, 9_000
      while start < message.length
        self.post("https://api.hipchat.com/v1/rooms/message?" + query_parameters(options.merge(:message => message[start...last])))
        start = last
        last += 10_000
      end
    end

    private

    # Turn the hash into a query string
    def query_parameters(options = {})
      # Keep only accepted parameters and overwrite defaults if provided
      options = DEFAULTS.merge(options.reject{|k, v| !DEFAULTS.include?(k)})
      # Join the k=v pairs with & to make a query string.
      options.collect{|key, value| "#{CGI.escape(key.to_s)}=#{CGI.escape(value.to_s)}"}.join("&")
    end
  end

end