Version one of the API, untested but mother approved

Author: kdaigle

README

@@ -0,0 +1,18 @@
+Hipchat Ruby Library
+=====================
+
+This is just the first version of my copy of the HipChat API.  I'm not sure I'm entirely in love with the way it calls Hipchat's API but it assumes a pretty auto-magical format.  The future version may cut that back.
+
+The simple way to use this is as follows:
+
+hipchat = Hipchat::Base.new("yourAPIcode")
+
+rooms = hipchat.rooms
+
+main_room = rooms.first
+
+main_room.speak("Bot Name", "This is a simple message")
+
+users = main_room.users # => Returns a the users in the room
+
+users.first.profile # => Returns the special information about the user

README.md

@@ -0,0 +1,7 @@
+require 'crack'
+require 'httparty'
+require 'uri'
+
+require File.dirname(__FILE__) + '/hipchat/base'
+require File.dirname(__FILE__) + '/hipchat/room'
+require File.dirname(__FILE__) + '/hipchat/user'

lib/hipchat.rb

@@ -0,0 +1,25 @@
+module Hipchat
+
+  class Base
+    include HTTParty
+    base_uri 'api.hipchat.com/v1'
+
+    attr_accessor :auth_token
+
+    def initialize(auth_token)
+      self.auth_token = auth_token
+    end
+
+    def rooms
+      rooms_json = self.class.get("/rooms/list", :query => {:auth_token => @auth_token})
+      Room.instantiate_rooms(auth_token, rooms_json)
+    end
+
+    def users
+      users_json = self.class.get("/users/list", :query => {:auth_token => @auth_token})
+      User.instantiate_users(auth_token, users_json)
+    end
+
+  end
+
+end

lib/hipchat/base.rb

@@ -0,0 +1,34 @@
+module Hipchat
+
+  class Room < Hipchat::Base
+
+    attr_accessor :auth_token, :room_hash
+
+    def self.instantiate_rooms(auth_token, rooms_json)
+      rooms_json['rooms'].inject([]) do |rooms, room_json|
+        rooms << Room.new(auth_token, room_json)
+      end
+    end
+
+    def initialize(auth_token, room_hash)
+      self.auth_token = auth_token
+      self.room_hash = room_hash
+    end
+
+    def method_missing(method_name)
+      super unless [:name, :room_id, :topic, :last_active, :owner_user_id].include?(method_name)
+      room_hash[method_name.to_s]
+    end
+
+    def users
+      users_hash = self.class.get("/rooms/show", :query => {:room_id => self.room_id, :auth_token => self.auth_token})
+      User.instantiate_users(auth_token, users_hash)
+    end
+
+    def speak(from_name, message)
+      self.class.post("/rooms/message", :body => {:from => URI.escape(from_name), :message => URI.escape(message), :room_id => self.room_id}, :query => {:auth_token => self.auth_token})
+    end
+
+  end
+
+end

lib/hipchat/room.rb

@@ -0,0 +1,32 @@
+module Hipchat
+
+  class User < Hipchat::Base
+
+    attr_accessor :auth_token, :user_hash
+
+    def self.instantiate_users(auth_token, users_json)
+      users_json = users_json.keys.include?("users") ? users_json["users"] : users_json['room']['participants']
+      users_json.inject([]) do |users, user_json|
+        users << User.new(auth_token, user_json)
+      end
+    end
+
+    def initialize(auth_token, user_hash)
+      self.auth_token = auth_token
+      self.user_hash  = user_hash
+    end
+
+    def profile
+      user_hash = self.class.get("/users/show", :query => {:user_id => self.user_id, :auth_token => self.auth_token})
+      self.user_hash.merge!(user_hash["user"])
+      self
+    end
+
+    def method_missing(method_name)
+      super unless [:user_id, :name, :email, :title, :photo_url, :status, :is_group_admin].include?(method_name)
+      user_hash[method_name.to_s]
+    end
+
+  end
+
+end