kindling 0.0.2

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 wal
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,17 @@
+= kindling
+
+Description goes here.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 wal. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,27 @@
+require 'rubygems'
+require 'rake'
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'test'
+  test.ruby_opts << '-rubygems'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :default  => :test
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "kindling"
+    gemspec.summary = "Ruby wrapper for the 37 Signals Campfire API"
+    gemspec.description = "Ruby wrapper for the 37 Signals Campfire API"
+    gemspec.email = "wal@contrast.ie"
+    gemspec.homepage = "http://github.com/contrast/kindling"
+    gemspec.authors = ["Wal McConnell"]
+    Jeweler::GemcutterTasks.new    
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.2

data/kindling.gemspec

@@ -0,0 +1,52 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{kindling}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Wal McConnell"]
+  s.date = %q{2009-12-21}
+  s.description = %q{Ruby wrapper for the 37 Signals Campfire API}
+  s.email = %q{wal@contrast.ie}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "kindling.gemspec",
+     "lib/kindling.rb",
+     "lib/kindling/campfire.rb",
+     "lib/kindling/request.rb",
+     "test/fixtures/rooms.json",
+     "test/kindling/request_test.rb",
+     "test/test_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/contrast/kindling}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Ruby wrapper for the 37 Signals Campfire API}
+  s.test_files = [
+    "test/kindling/request_test.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/lib/kindling/campfire.rb

@@ -0,0 +1,26 @@
+module Kindling
+  
+  class Campfire
+    
+    attr_accessor :api_token, :subdomain, :room_id
+
+    def initialize(api_token, subdomain, room_id)
+      @api_token = api_token
+      @subdomain = subdomain
+      @room_id = room_id
+      rooms
+    end
+
+    def rooms
+      Kindling::Request.rooms(self)
+    end
+    
+    def speak(message)
+      Kindling::Request.speak(message, self)
+    end
+    
+    def credentials
+      {:username => @api_token, :password => 'x'}
+    end
+  end
+end

data/lib/kindling/request.rb

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'httparty'
+require 'json'
+
+class Kindling::Request  
+
+  CAMPFIRE_HOST = 'campfirenow.com'
+  include HTTParty
+  format :json
+  
+  headers 'Content-Type' => 'application/json'
+  
+  def self.rooms(campfire)    
+    response = get rooms_url(campfire), :basic_auth => campfire.credentials
+    case response.code
+    when 404
+      raise Kindling::InvalidSubdomain.new(campfire.subdomain)
+    when 401
+      raise Kindling::InvalidAPIToken.new(campfire.api_token)      
+    when 200
+      return response["rooms"]
+    end
+  end  
+  
+  def self.speak(message, campfire)
+    response = post room_url(campfire), :body => {:message => {:body => message, :type => "Textmessage"}}.to_json, :basic_auth => campfire.credentials
+    case response.code
+    when 404
+      raise Kindling::InvalidRoomID.new(campfire.room_id)
+    when 401
+      raise Kindling::InvalidAPIToken.new(campfire.api_token)      
+    when 200..201
+      response
+    else
+      raise Kindling::Error.new("Unexpected error occured #{response.code}/#{response.message}")
+    end
+  end
+  
+  private 
+    
+  def self.room_url(campfire)
+    "#{subdomain(campfire)}/room/#{campfire.room_id}/speak.json"
+  end
+  
+  def self.rooms_url(campfire)
+    "#{subdomain(campfire)}/rooms.json"
+  end
+  
+  def self.subdomain(campfire)
+    "http://#{campfire.subdomain}.#{CAMPFIRE_HOST}"
+  end
+end

data/lib/kindling.rb

@@ -0,0 +1,10 @@
+module Kindling
+  class Error < StandardError; end
+  class InvalidSubdomain < StandardError; end
+  class InvalidAPIToken < StandardError; end
+  class InvalidRoomID < StandardError; end  
+end
+
+['campfire', 'request'].each do |file|
+  require File.join(File.expand_path(File.dirname(__FILE__)), 'kindling', file)
+end

data/test/fixtures/rooms.json

@@ -0,0 +1,14 @@
+{
+    "rooms": [{
+        "name": "Room 1",
+        "id": 201712
+    },
+    {
+        "name": "Room 2",
+        "id": 298625
+    },
+    {
+        "name": "Room 3",
+        "id": 206877
+    }]
+}

data/test/kindling/request_test.rb

@@ -0,0 +1,62 @@
+require 'test_helper'
+require 'json'
+
+class RequestTest < Test::Unit::TestCase
+
+  context "Request" do
+    setup do 
+      stub_rooms_request({:code => 200, :[] =>  JSON.parse(fixture_file("rooms.json"))["rooms"]})         
+      @campfire = Kindling::Campfire.new(TEST_API_TOKEN, TEST_SUBDOMAIN, TEST_ROOM_ID)
+    end
+
+    context "rooms" do  
+
+      should "should raise error if invalid subdomain" do
+        stub_rooms_request({:code => 404})
+        assert_raises Kindling::InvalidSubdomain do
+          Kindling::Request.rooms(@campfire)
+        end
+      end
+
+      should "should raise error if invalid api_token" do
+        stub_rooms_request({:code => 401})        
+        assert_raises Kindling::InvalidAPIToken do
+          Kindling::Request.rooms(@campfire)
+        end
+      end
+
+      should "should return rooms list" do
+        stub_rooms_request({:code => 200, :[] =>  JSON.parse(fixture_file("rooms.json"))["rooms"]})       
+        assert_equal [{"name"=>"Room 1", "id"=>201712}, {"name"=>"Room 2", "id"=>298625}, {"name"=>"Room 3", "id"=>206877}], Kindling::Request.rooms(@campfire)
+      end
+    end  
+
+
+    context "send message" do  
+      should "send message successfully if 200" do
+        stub_send_message_request('test message', {:code => 200})
+        Kindling::Request.speak("test message", @campfire)
+      end
+      
+      should "send message successfully if 201" do
+        stub_send_message_request('test message', {:code => 201})
+        Kindling::Request.speak("test message", @campfire)
+      end
+      
+      should "raise error if invalid room id" do
+        stub_send_message_request('test message', {:code => 404})
+        assert_raises Kindling::InvalidRoomID do
+          Kindling::Request.speak("test message", @campfire)
+        end
+      end
+
+      should "raise error if invalid API token" do
+        stub_send_message_request('test message', {:code => 401})
+        assert_raises Kindling::InvalidAPIToken do
+          Kindling::Request.speak("test message", @campfire)
+        end
+      end
+
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,28 @@
+require 'test/unit'
+require 'shoulda'
+require 'mocha'
+
+require File.join(File.expand_path(File.dirname(__FILE__)), '..', 'lib', 'kindling')
+
+def fixture_file(filename)
+  return '' if filename == ''
+  file_path = File.expand_path(File.dirname(__FILE__) + '/fixtures/' + filename)
+  File.read(file_path)
+end
+
+TEST_SUBDOMAIN = 'testsubdomain'
+TEST_API_TOKEN = '787654567654323456789098765432345678765432'
+TEST_ROOM_ID = '201712'
+
+def stub_rooms_request(resp)
+  response = mock('Net::HTTPResponse', resp)
+  Kindling::Request.expects(:get).with("http://#{TEST_SUBDOMAIN}.campfirenow.com/rooms.json", {:basic_auth => {:password => 'x', :username => "#{TEST_API_TOKEN}"}}).returns(response)
+end
+
+def stub_send_message_request(message, resp)
+  response = mock('Net::HTTPResponse', resp)  
+  Kindling::Request.expects(:post).with(
+    "http://#{TEST_SUBDOMAIN}.campfirenow.com/room/#{TEST_ROOM_ID}/speak.json", 
+    :body => {:message => {:body => message, :type => "Textmessage"}}.to_json, 
+    :basic_auth => {:password => 'x', :username => "#{TEST_API_TOKEN}"}).returns(response)
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+name: kindling
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Wal McConnell
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-21 00:00:00 +00:00
+default_executable: 
+dependencies: []
+
+description: Ruby wrapper for the 37 Signals Campfire API
+email: wal@contrast.ie
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- kindling.gemspec
+- lib/kindling.rb
+- lib/kindling/campfire.rb
+- lib/kindling/request.rb
+- test/fixtures/rooms.json
+- test/kindling/request_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/contrast/kindling
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for the 37 Signals Campfire API
+test_files: 
+- test/kindling/request_test.rb
+- test/test_helper.rb