hipchat 0.6.1 → 0.7.0

data/README.textile

@@ -20,6 +20,14 @@ client['my room'].send('username', 'Build failed!', :color => 'red')
 # Have your message rendered as text in HipChat (see https://www.hipchat.com/docs/api/method/rooms/message)
 client['my room'].send('username', '@coworker Build faild!', :message_format => 'text')
 
+# Update the topic of a room in HipChat (see https://www.hipchat.com/docs/api/method/rooms/topic)
+client['my room'].topic('Free Ice Cream in the kitchen')
+
+# Change the from field for a topic update (default "API")
+client['my room'].topic('Weekely sales: $10,000', :from => 'Sales Team')
+
+
+
 h2. Capistrano
 
 bc.. require 'hipchat/capistrano'

data/VERSION

@@ -1 +1 @@
-0.6.1
+0.7.0

data/hipchat.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{hipchat}
-  s.version = "0.6.1"
+  s.version = "0.7.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["HipChat/Atlassian"]
-  s.date = %q{2012-11-06}
+  s.date = %q{2012-11-10}
   s.description = %q{Ruby library to interact with HipChat}
   s.email = %q{support@hipchat.com}
   s.extra_rdoc_files = [

data/lib/hipchat.rb

@@ -90,5 +90,40 @@ module HipChat
         raise UnknownResponseCode, "Unexpected #{response.code} for room `#{room_id}'"
       end
     end
+
+    # Change this room's topic
+    #
+    # Usage:
+    #
+    #   # Default
+    #   topic 'my awesome topic'
+    #
+    # Options:
+    #
+    # +from+::  the name of the person changing the topic
+    #            (default "API")
+    def topic(new_topic, options = {})
+
+      options = { :from => 'API' }.merge options
+
+      response = self.class.post('/topic',
+        :query => { :auth_token => @token },
+        :body  => {
+          :room_id        => room_id,
+          :from           => options[:from],
+          :topic          => new_topic
+        }
+      )
+
+      case response.code
+      when 200; true
+      when 404
+        raise UnknownRoom,  "Unknown room: `#{room_id}'"
+      when 401
+        raise Unauthorized, "Access denied to room `#{room_id}'"
+      else
+        raise UnknownResponseCode, "Unexpected #{response.code} for room `#{room_id}'"
+      end
+    end
   end
 end

data/spec/hipchat_spec.rb

@@ -20,6 +20,56 @@ describe HipChat do
     }
   end
 
+  def mock_successful_topic_change(topic, options={})
+    options = {:from => 'API'}.merge(options)
+    mock(HipChat::Room).post("/topic",
+                             :query => {:auth_token => "blah"},
+                             :body  => {:room_id => "Hipchat",
+                                        :from    => options[:from],
+                                        :topic   => "Nice topic" } ) {
+      OpenStruct.new(:code => 200)
+    }
+  end
+
+  describe "#topic" do
+    it "is successful without custom options" do
+      mock_successful_topic_change("Nice topic")
+
+      room.topic("Nice topic").should be_true
+    end
+
+    it "is successful with a custom from" do
+      mock_successful_topic_change("Nice topic", :from => "Me")
+
+      room.topic("Nice topic", :from => "Me").should be_true
+    end
+
+    it "fails when the room doesn't exist" do
+      mock(HipChat::Room).post(anything, anything) {
+        OpenStruct.new(:code => 404)
+      }
+
+      lambda { room.topic "" }.should raise_error(HipChat::UnknownRoom)
+    end
+
+    it "fails when we're not allowed to do so" do
+      mock(HipChat::Room).post(anything, anything) {
+        OpenStruct.new(:code => 401)
+      }
+
+      lambda { room.topic "" }.should raise_error(HipChat::Unauthorized)
+    end
+
+    it "fails if we get an unknown response code" do
+      mock(HipChat::Room).post(anything, anything) {
+        OpenStruct.new(:code => 403)
+      }
+
+      lambda { room.topic "" }.
+        should raise_error(HipChat::UnknownResponseCode)
+    end
+  end
+
   describe "sends a message to a room" do
     it "successfully without custom options" do
       mock_successful_send 'Dude', 'Hello world'

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 6
-  - 1
-  version: 0.6.1
+  - 7
+  - 0
+  version: 0.7.0
 platform: ruby
 authors: 
 - HipChat/Atlassian
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-11-06 00:00:00 -08:00
+date: 2012-11-10 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency