bzhipchat 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Mojo Tech
+
+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.textile

@@ -0,0 +1,67 @@
+h1. HipChat Wrapper
+
+A very basic wrapper for the HipChat HTTP API.
+
+h2. Usage
+
+bc.. client = HipChat::Client.new(api_token)
+client['my room'].send('username', 'I talk')
+
+# Send notifications to users (default false)
+client['my room'].send('username', 'I quit!', :notify => true)
+
+# Color it red. or "yellow", "green", "purple", "random" (default "yellow")
+client['my room'].send('username', 'Build failed!', :color => 'red')
+
+h2. Capistrano
+
+bc.. require 'hipchat/capistrano'
+
+set :hipchat_token, "<your token>"
+set :hipchat_room_name, "Your room"
+set :hipchat_announce, false # notify users
+set :hipchat_color, 'green' #finished deployment message color
+set :hipchat_failed_color, 'red' #cancelled deployment message color
+
+h3. Who did it?
+
+To determine the user that is currently running the deploy, the capistrano tasks will look for the following:
+
+# The $HIPCHAT_USER environment variable
+# The hipchat_human capistrano var.
+# The git user.name var.
+# The $USER environment variable.
+
+h2. Rails 3 Rake Task
+
+Send a message using a rake task:
+
+bc. rake hipchat:send["hello world"]
+
+Options like the room, API token, user name and notification flag can be set in YAML.
+
+RAILS_ROOT/config/hipchat.yml:
+
+bc.. token: "<your token>"
+room: "Your room"
+user: "Your name" # Default to `whoami`
+notify: true # Defaults to false
+
+h2. Engine Yard
+
+Use a "deploy hook":http://bit.ly/qnbIkP to send messages from Engine Yard's Cloud platform.
+
+RAILS_ROOT/deploy/after_restart.rb:
+
+bc.. on_app_master do
+  message  = "Deploying revision #{revision[0...6]} to #{node[:environment][:name]}"
+  message += " (with migrations)" if migrate?
+  message += "."
+
+  # Send a message via rake task assuming a hipchat.yml in your config like above
+  run "cd #{release_path} && bundle exec rake hipchat:send MESSAGE='#{message}'"
+end
+
+h2. Copyright
+
+Copyright (c) 2010 Mojo Tech. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,32 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "hipchat"
+    gem.summary = %Q{Ruby library to interact with HipChat}
+    gem.description = %Q{Ruby library to interact with HipChat}
+    gem.email = "gems@mojotech.com"
+    gem.homepage = "http://github.com/mojotech/hipchat"
+    gem.authors = ["MojoTech"]
+    gem.add_dependency "httparty"
+    gem.add_development_dependency "rspec", "~> 2.0"
+    gem.add_development_dependency "rr", "~> 1.0"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "hipchat #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.4.1

data/hipchat.gemspec

@@ -0,0 +1,58 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "bzhipchat"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Betazeta"]
+  s.date = "2013-08-27"
+  s.description = "Ruby library to interact with HipChat, forked by boris.quiroz@betazeta.com"
+  s.email = "boris.quiroz@betazeta.com"
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.textile"
+  ]
+  s.files = [
+    ".document",
+    "LICENSE",
+    "README.textile",
+    "Rakefile",
+    "VERSION",
+    "hipchat.gemspec",
+    "lib/hipchat.rb",
+    "lib/hipchat/capistrano.rb",
+    "lib/hipchat/chef.rb",
+    "lib/hipchat/rails3_tasks.rb",
+    "lib/hipchat/railtie.rb",
+    "spec/hipchat_spec.rb",
+    "spec/spec.opts",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/boris/hipchat"
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "Ruby library to interact with HipChat, forked by boris.quiroz@betazeta.com"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.0"])
+      s.add_development_dependency(%q<rr>, ["~> 1.0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.0"])
+      s.add_dependency(%q<rr>, ["~> 1.0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.0"])
+    s.add_dependency(%q<rr>, ["~> 1.0"])
+  end
+end
+

data/lib/hipchat/capistrano.rb

@@ -0,0 +1,97 @@
+require 'hipchat'
+
+Capistrano::Configuration.instance(:must_exist).load do
+  set :hipchat_send_notification, false
+  set :hipchat_with_migrations, false
+
+  namespace :hipchat do
+    task :set_client do
+      set :hipchat_client, HipChat::Client.new(hipchat_token)
+    end
+
+    task :trigger_notification do
+      set :hipchat_send_notification, true
+    end
+
+    task :configure_for_migrations do
+      set :hipchat_with_migrations, true
+    end
+
+    task :notify_deploy_started do
+      if hipchat_send_notification
+        on_rollback do
+          send_options.merge!(:color => failed_message_color)
+          hipchat_client[hipchat_room_name].
+            send(deploy_user, "#{human} cancelled deployment of #{deployment_name} to #{env}.", send_options)
+        end
+
+        message = "#{human} esta haciendo deploy #{deployment_name} a #{stage}"
+        message << " (with migrations)" if hipchat_with_migrations
+        message << "."
+
+        hipchat_client[hipchat_room_name].send(deploy_user, message, send_options)
+      end
+    end
+
+    task :notify_deploy_finished do
+      hipchat_client[hipchat_room_name].
+        send(deploy_user, "#{human} termino deploy #{deployment_name} a #{stage}.", send_options)
+    end
+
+    def send_options
+      return @send_options if defined?(@send_options)
+      @send_options = message_color ? {:color => message_color} : {}
+      @send_options.merge!(:notify => message_notification)
+      @send_options
+    end
+
+    def deployment_name
+      if branch
+        name = "#{application}/#{branch}"
+	name += " (revision #{real_revision[0..7]})" if real_revision
+	name
+      else
+        application
+      end
+    end
+
+    def message_color
+      fetch(:hipchat_color, nil)
+    end
+
+    def failed_message_color
+      fetch(:hipchat_failed_color, "red")
+    end
+
+    def message_notification
+      fetch(:hipchat_announce, false)
+    end
+
+    def deploy_user
+      fetch(:hipchat_deploy_user, "Deploy")
+    end
+
+    def human
+      ENV['HIPCHAT_USER'] ||
+        fetch(:hipchat_human,
+              if (u = %x{git config user.name}.strip) != ""
+                u
+              elsif (u = ENV['USER']) != ""
+                u
+              else
+                "Someone"
+              end)
+    end
+
+    def env
+      fetch(:hipchat_env, fetch(:rack_env, fetch(:rails_env, "production")))
+    end
+  end
+
+  before "hipchat:notify_deploy_started", "hipchat:set_client"
+  before "deploy", "hipchat:trigger_notification"
+  before "deploy:migrations", "hipchat:trigger_notification", "hipchat:configure_for_migrations"
+  before "deploy:update_code", "hipchat:notify_deploy_started"
+  after  "deploy", "hipchat:notify_deploy_finished"
+  after  "deploy:migrations", "hipchat:notify_deploy_finished"
+end

data/lib/hipchat/chef.rb

@@ -0,0 +1,31 @@
+require 'hipchat'
+
+#
+# Provides a Chef exception handler so you can send information about
+# chef-client failures to a HipChat room.
+#
+# Docs: http://wiki.opscode.com/display/chef/Exception+and+Report+Handlers
+#
+# Install - add the following to your client.rb:
+#   require 'hipchat/chef'
+#   hipchat_handler = HipChat::NotifyRoom.new("<api token>", "<room name>")
+#   exception_handlers << hipchat_handler
+#
+
+module HipChat
+  class NotifyRoom < Chef::Handler
+
+    def initialize(api_token, room_name, notify_users=false)
+      @api_token = api_token
+      @room_name = room_name
+      @notify_users = notify_users
+    end
+
+    def report
+      msg = "Failure on #{node.name}: #{run_status.formatted_exception}"
+
+      client = HipChat::Client.new(@api_token)
+      client[@room_name].send('Chef', msg, :notify => @notify_users)
+    end
+  end
+end

data/lib/hipchat/rails3_tasks.rb

@@ -0,0 +1,38 @@
+require 'hipchat'
+
+namespace :hipchat do
+  desc "Sends a HipChat message as a particular user"
+  task :send do
+    required_options = [:message, :room, :token, :user]
+    config_file      = Rails.root.join 'config', 'hipchat.yml'
+
+    options = {
+      :message => ENV['MESSAGE'],
+      :user    => ENV['HIPCHAT_USER'],
+      :notify  => ENV['NOTIFY'],
+      :room    => ENV['ROOM'],
+      :token   => ENV['TOKEN']
+    }.reject { |k, v| v.blank? }
+    
+    system_options = {
+      :user    => ENV['USER']
+    }.reject { |k, v| v.blank? }
+
+    if File.exists? config_file
+      options.reverse_merge! YAML.load_file(config_file).symbolize_keys
+    end
+    
+    options.reverse_merge! system_options
+
+    options[:notify] = options[:notify].to_s != 'false'
+
+    if (missing_options = required_options - options.keys).size > 0
+      puts "HipChat needs #{missing_options.to_sentence} to send!"
+      exit
+    end
+
+    client = HipChat::Client.new(options[:token])
+
+    client[options[:room]].send(options[:user], options[:message], :notify => options[:notify])
+  end
+end

data/lib/hipchat/railtie.rb

@@ -0,0 +1,9 @@
+require 'hipchat'
+
+module HipChat
+  class Railtie < Rails::Railtie
+    rake_tasks do
+      require 'hipchat/rails3_tasks'
+    end
+  end
+end

data/lib/hipchat.rb

@@ -0,0 +1,93 @@
+require 'httparty'
+require 'ostruct'
+
+require 'hipchat/railtie' if defined?(Rails::Railtie)
+
+module HipChat
+  class UnknownRoom         < StandardError; end
+  class Unauthorized        < StandardError; end
+  class UnknownResponseCode < StandardError; end
+
+  class Client
+    include HTTParty
+
+    base_uri 'https://api.hipchat.com/v1/rooms'
+    format :json
+
+    def initialize(token)
+      @token = token
+    end
+
+    def rooms
+      @rooms ||= self.class.get("/list", :query => {:auth_token => @token})['rooms'].
+        map { |r| Room.new(@token, r) }
+    end
+
+    def [](name)
+      Room.new(@token, :room_id => name)
+    end
+  end
+
+  class Room < OpenStruct
+    include HTTParty
+
+    base_uri 'https://api.hipchat.com/v1/rooms'
+
+    def initialize(token, params)
+      @token = token
+
+      super(params)
+    end
+
+    # Send a message to this room.
+    #
+    # Usage:
+    #
+    #   # Default
+    #   send 'nickname', 'some message'
+    #
+    #   # Notify users and color the message red
+    #   send 'nickname', 'some message', :notify => true, :color => 'red'
+    #
+    #   # Notify users (deprecated)
+    #   send 'nickname', 'some message', true
+    #
+    # Options:
+    #
+    # +color+::  "yellow", "red", "green", "purple", or "random"
+    #            (default "yellow")
+    # +notify+:: true or false
+    #            (default false)
+    def send(from, message, options_or_notify = {})
+      options = if options_or_notify == true or options_or_notify == false
+        warn "DEPRECATED: Specify notify flag as an option (e.g., :notify => true)"
+        { :notify => options_or_notify }
+      else
+        options_or_notify || {}
+      end
+
+      options = { :color => 'yellow', :notify => false }.merge options
+
+      response = self.class.post('/message',
+        :query => { :auth_token => @token },
+        :body  => {
+          :room_id => room_id,
+          :from    => from,
+          :message => message,
+          :color   => options[:color],
+          :notify  => options[:notify] ? 1 : 0
+        }
+      )
+
+      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

@@ -0,0 +1,66 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe HipChat do
+  subject { HipChat::Client.new("blah") }
+
+  let(:room) { subject["Hipchat"] }
+
+  # Helper for mocking room message post requests
+  def mock_successful_send(from, message, options={})
+    options = {:color => 'yellow', :notify => 0}.merge(options)
+    mock(HipChat::Room).post("/message",
+                             :query => {:auth_token => "blah"},
+                             :body  => {:room_id => "Hipchat",
+                                        :from    => "Dude",
+                                        :message => "Hello world",
+                                        :color   => options[:color],
+                                        :notify  => options[:notify]}) {
+      OpenStruct.new(:code => 200)
+    }
+  end
+
+  describe "sends a message to a room" do
+    it "successfully without custom options" do
+      mock_successful_send 'Dude', 'Hello world'
+
+      room.send("Dude", "Hello world").should be_true
+    end
+
+    it "successfully with notifications on as option" do
+      mock_successful_send 'Dude', 'Hello world', :notify => 1
+
+      room.send("Dude", "Hello world", :notify => true).should be_true
+    end
+
+    it "successfully with custom color" do
+      mock_successful_send 'Dude', 'Hello world', :color => 'red'
+
+      room.send("Dude", "Hello world", :color => 'red').should be_true
+    end
+
+    it "but fails when the room doesn't exist" do
+      mock(HipChat::Room).post(anything, anything) {
+        OpenStruct.new(:code => 404)
+      }
+
+      lambda { room.send "", "" }.should raise_error(HipChat::UnknownRoom)
+    end
+
+    it "but fails when we're not allowed to do so" do
+      mock(HipChat::Room).post(anything, anything) {
+        OpenStruct.new(:code => 401)
+      }
+
+      lambda { room.send "", "" }.should raise_error(HipChat::Unauthorized)
+    end
+
+    it "but fails if we get an unknown response code" do
+      mock(HipChat::Room).post(anything, anything) {
+        OpenStruct.new(:code => 403)
+      }
+
+      lambda { room.send "", "" }.
+        should raise_error(HipChat::UnknownResponseCode)
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'hipchat'
+require 'rspec'
+require 'rspec/autorun'
+
+RSpec.configure do |config|
+  config.mock_with :rr
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: bzhipchat
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Betazeta
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rr
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: Ruby library to interact with HipChat, forked by boris.quiroz@betazeta.com
+email: boris.quiroz@betazeta.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.textile
+files:
+- .document
+- LICENSE
+- README.textile
+- Rakefile
+- VERSION
+- hipchat.gemspec
+- lib/hipchat.rb
+- lib/hipchat/capistrano.rb
+- lib/hipchat/chef.rb
+- lib/hipchat/rails3_tasks.rb
+- lib/hipchat/railtie.rb
+- spec/hipchat_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+homepage: http://github.com/boris/hipchat
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Ruby library to interact with HipChat, forked by boris.quiroz@betazeta.com
+test_files: []