pusher-client-merman 0.2.1

data/.document

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

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/Gemfile.lock

@@ -0,0 +1,23 @@
+PATH
+  remote: .
+  specs:
+    pusher-client (0.2.1)
+      addressable (~> 2.3.1)
+      libwebsocket (= 0.1.0)
+      ruby-hmac (~> 0.4.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.1)
+    bacon (1.1.0)
+    libwebsocket (0.1.0)
+    ruby-hmac (0.4.0)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  bacon
+  pusher-client!

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Logan Koester
+
+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,88 @@
+= pusher-client (Ruby)
+
+pusher-client is a ruby gem for consuming WebSockets from the Pusher[http://pusherapp.com] web service.
+
+The connection to Pusher can optionally be maintained in its own thread (see Asynchronous Usage).
+
+This gem no longer depends on em-http, and is compatible with jruby since 0.2.
+
+When binding to a global event, note that you still must be subscribed to the channels the event
+may be sent on. You can't just bind a global event without subscribing to any channels and call it a day.
+
+== Installation
+  gem install pusher-client
+== Single-Threaded Usage
+The application will pause at socket.connect and handle events from Pusher as they happen.
+
+  require 'pusher-client'
+  PusherClient.logger = Logger.new(STDOUT)
+  options = {:secret => 'YOUR_APPLICATION_SECRET'} 
+  socket = PusherClient::Socket.new(YOUR_APPLICATION_KEY, options)
+
+  # Subscribe to two channels
+  socket.subscribe('channel1')
+  socket.subscribe('channel2')
+
+  # Subscribe to presence channel
+  socket.subscribe('presence-channel3', USER_ID)
+
+  # Subscribe to private channel
+  socket.subscribe('private-channel4', USER_ID)
+
+  # Bind to a global event (can occur on either channel1 or channel2)
+  socket.bind('globalevent') do |data|
+    puts data
+  end
+
+  # Bind to a channel event (can only occur on channel1)
+  socket['channel1'].bind('channelevent') do |data|
+    puts data
+  end
+
+  socket.connect
+
+== Asynchronous Usage
+The socket will remain open in the background as long as your main application thread is running,
+and you can continue to subscribe/unsubscribe to channels and bind new events.
+
+  require 'pusher-client'
+  PusherClient.logger = Logger.new(STDOUT)
+  socket = PusherClient::Socket.new(YOUR_APPLICATION_KEY)
+  socket.connect(true) # Connect asynchronously
+
+  # Subscribe to two channels
+  socket.subscribe('channel1')
+  socket.subscribe('channel2')
+
+  # Bind to a global event (can occur on either channel1 or channel2)
+  socket.bind('globalevent') do |data|
+    puts data
+  end
+
+  # Bind to a channel event (can only occur on channel1)
+  socket['channel1'].bind('channelevent') do |data|
+    puts data
+  end
+
+  loop do
+    sleep(1) # Keep your main thread running
+  end
+
+For further documentation, read the source & test suite. Some features of the JavaScript client
+are not yet implemented.
+
+== Contributing to pusher-client
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2010 Logan Koester. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "pusher-client"
+  gem.homepage = "http://github.com/pusher/pusher-ruby-client"
+  gem.license = "MIT"
+  gem.summary = %Q{Ruby client for consuming WebSockets from http://pusher.com}
+  gem.description = %Q{Ruby client for consuming WebSockets from http://pusher.com}
+  gem.email = "logan@logankoester.com"
+  gem.authors = ["Logan Koester", "Phil Leggetter"]
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "pusher-client #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.2-alpha

data/examples/hello_pusher.rb

@@ -0,0 +1,20 @@
+# Usage: $ PUSHER_KEY=YOURKEY ruby examples/hello_pusher.rb
+
+require 'rubygems'
+require './lib/pusher-client.rb'
+require 'pp'
+
+APP_KEY = ENV['PUSHER_KEY'] # || "YOUR_APPLICATION_KEY"
+
+PusherClient.logger = Logger.new(STDOUT)
+socket = PusherClient::Socket.new(APP_KEY)
+
+# Subscribe to a channel
+socket.subscribe('hellopusher')
+
+# Bind to a channel event
+socket['hellopusher'].bind('hello') do |data|
+  pp data
+end
+
+socket.connect

data/examples/hello_pusher_async.rb

@@ -0,0 +1,23 @@
+# Usage: $ PUSHER_KEY=YOURKEY ruby examples/hello_pusher.rb
+
+require 'rubygems'
+require './lib/pusher-client.rb'
+require 'pp'
+
+APP_KEY = ENV['PUSHER_KEY'] # || "YOUR_APPLICATION_KEY"
+
+PusherClient.logger = Logger.new('/dev/null')
+socket = PusherClient::Socket.new(APP_KEY)
+socket.connect(true)
+
+# Subscribe to a channel
+socket.subscribe('hellopusher')
+
+# Bind to a channel event
+socket['hellopusher'].bind('hello') do |data|
+  pp data
+end
+
+loop do
+  sleep 1
+end

data/lib/pusher-client.rb

@@ -0,0 +1,24 @@
+autoload :Logger, 'logger'
+
+module PusherClient
+  HOST = 'ws.pusherapp.com'
+  WS_PORT = 80
+  WSS_PORT = 443
+
+  @logger = Logger.new(STDOUT)
+
+  def self.logger
+    @logger
+  end
+
+  def self.logger=(logger)
+    @logger = logger
+  end
+end
+
+Thread.abort_on_exception = true
+
+require File.dirname(__FILE__) + '/pusher-client/websocket.rb'
+require File.dirname(__FILE__) + '/pusher-client/socket.rb'
+require File.dirname(__FILE__) + '/pusher-client/channel.rb'
+require File.dirname(__FILE__) + '/pusher-client/channels.rb'

data/lib/pusher-client/channel.rb

@@ -0,0 +1,54 @@
+module PusherClient
+
+  class Channel
+    attr_accessor :global, :subscribed
+    attr_reader :name, :callbacks, :global_callbacks
+
+    def initialize(channel_name)
+      @name = channel_name
+      @global = false
+      @callbacks = {}
+      @global_callbacks = {}
+      @subscribed = false
+    end
+
+    def bind(event_name, &callback)
+      @callbacks[event_name] = callbacks[event_name] || []
+      @callbacks[event_name] << callback
+      return self
+    end
+
+    def dispatch_with_all(event_name, data)
+      dispatch(event_name, data)
+      dispatch_global_callbacks(event_name, data)
+    end
+
+    def dispatch(event_name, data)
+      PusherClient.logger.debug "Dispatching callbacks for #{event_name}"
+      if @callbacks[event_name]
+        @callbacks[event_name].each do |callback|
+          callback.call(data)
+        end
+      else
+        PusherClient.logger.debug "No callbacks to dispatch for #{event_name}"
+      end
+    end
+
+    def dispatch_global_callbacks(event_name, data)
+      if @global_callbacks[event_name]
+        PusherClient.logger.debug "Dispatching global callbacks for #{event_name}"
+        @global_callbacks[event_name].each do |callback|
+          callback.call(data)
+        end
+      else
+        PusherClient.logger.debug "No global callbacks to dispatch for #{event_name}"
+      end
+    end
+
+    def acknowledge_subscription(data)
+      @subscribed = true
+    end
+
+  end
+
+end

data/lib/pusher-client/channels.rb

@@ -0,0 +1,38 @@
+module PusherClient
+  class Channels
+
+    attr_reader :channels
+
+    def initialize
+      @channels = {}
+    end
+
+    def add(channel_name)
+      unless @channels[channel_name]
+        @channels[channel_name] = Channel.new(channel_name)
+      end
+      @channels[channel_name]
+    end
+
+    def find(channel_name)
+      @channels[channel_name]
+    end
+
+    def remove(channel_name)
+      @channels.delete(channel_name)
+      @channels
+    end
+
+    def empty?
+      @channels.empty?
+    end
+
+    def size
+      @channels.size
+    end
+
+    alias :<< :add
+    alias :[] :find
+
+  end
+end

data/lib/pusher-client/socket.rb

@@ -0,0 +1,199 @@
+require 'json'
+require 'hmac-sha2'
+require 'digest/md5'
+
+module PusherClient
+  class Socket
+
+    # Mimick the JavaScript client
+    CLIENT_ID = 'pusher-ruby-client'
+    VERSION = '1.7.1'
+
+    attr_accessor :encrypted, :secure
+    attr_reader :path, :connected, :channels, :global_channel, :socket_id
+
+    def initialize(application_key, options={})
+      raise ArgumentError if (!application_key.is_a?(String) || application_key.size < 1)
+
+      @path = "/app/#{application_key}?client=#{CLIENT_ID}&version=#{VERSION}"
+      @key = application_key
+      @secret = options[:secret]
+      @socket_id = nil
+      @channels = Channels.new
+      @global_channel = Channel.new('pusher_global_channel')
+      @global_channel.global = true
+      @secure = false
+      @connected = false
+      @encrypted = options[:encrypted] || false
+
+      bind('pusher:connection_established') do |data|
+        socket = JSON.parse(data)
+        @connected = true
+        @socket_id = socket['socket_id']
+        subscribe_all
+      end
+
+      bind('pusher:connection_disconnected') do |data|
+        @channels.channels.each { |c| c.disconnect }
+      end
+
+      bind('pusher:error') do |data|
+        PusherClient.logger.fatal("Pusher : error : #{data.inspect}")
+      end
+    end
+
+    def connect(async = false)
+      if @encrypted || @secure
+        url = "wss://#{HOST}:#{WSS_PORT}#{@path}"
+      else
+        url = "ws://#{HOST}:#{WS_PORT}#{@path}"
+      end
+      PusherClient.logger.debug("Pusher : connecting : #{url}")
+
+      @connection_thread = Thread.new {
+        options = {:ssl => @encrypted || @secure}
+        @connection = WebSocket.new(url, options)
+        PusherClient.logger.debug "Websocket connected"
+        loop do
+          msg = @connection.receive[0]
+          params  = parser(msg)
+          next if (params['socket_id'] && params['socket_id'] == self.socket_id)
+          event_name   = params['event']
+          event_data   = params['data']
+          channel_name = params['channel']
+          send_local_event(event_name, event_data, channel_name)
+        end
+      }
+
+      @connection_thread.run
+      @connection_thread.join unless async
+      return self
+    end
+
+    def disconnect
+      if @connected
+        PusherClient.logger.debug "Pusher : disconnecting"
+        @connection.close
+        @connection_thread.kill if @connection_thread
+        @connected = false
+      else
+        PusherClient.logger.warn "Disconnect attempted... not connected"
+      end
+    end
+
+    def subscribe(channel_name, user_id = nil)
+      @user_data = {:user_id => user_id}.to_json unless user_id.nil?
+
+      channel = @channels << channel_name
+      if @connected
+        authorize(channel, method(:authorize_callback))
+      end
+      return channel
+    end
+
+    def unsubscribe(channel_name)
+      channel = @channels.remove channel_name
+      if @connected
+        send_event('pusher:unsubscribe', {
+          'channel' => channel_name
+        })
+      end
+      return channel
+    end
+
+    def bind(event_name, &callback)
+      @global_channel.bind(event_name, &callback)
+      return self
+    end
+
+    def [](channel_name)
+      if @channels[channel_name]
+        @channels[channel_name]
+      else
+        @channels << channel_name
+      end
+    end
+
+    def subscribe_all
+      @channels.channels.clone.each{ |k,v|
+        subscribe(k)
+      }
+    end
+
+    #auth for private and presence
+    def authorize(channel, callback)
+      if is_private_channel(channel.name)
+        auth_data = get_private_auth(channel)
+      elsif is_presence_channel(channel.name)
+        auth_data = get_presence_auth(channel)
+        channel_data = @user_data
+      end
+      # could both be nil if didn't require auth
+      callback.call(channel, auth_data, channel_data)
+    end
+
+    def authorize_callback(channel, auth_data, channel_data)
+      send_event('pusher:subscribe', {
+        'channel' => channel.name,
+        'auth' => auth_data,
+        'channel_data' => channel_data
+      })
+      channel.acknowledge_subscription(nil)
+    end
+
+    def is_private_channel(channel_name)
+      channel_name.match(/^private-/)
+    end
+
+    def is_presence_channel(channel_name)
+      channel_name.match(/^presence-/)
+    end
+
+    def get_private_auth(channel)
+      string_to_sign = @socket_id + ':' + channel.name
+      signature = HMAC::SHA256.hexdigest(@secret, string_to_sign)
+      return "#{@key}:#{signature}"
+    end
+
+    def get_presence_auth(channel)
+      string_to_sign = @socket_id + ':' + channel.name + ':' + @user_data
+      signature = HMAC::SHA256.hexdigest(@secret, string_to_sign)
+      return "#{@key}:#{signature}"
+    end
+
+
+    # For compatibility with JavaScript client API
+    alias :subscribeAll :subscribe_all
+
+    def send_event(event_name, data)
+      payload = {'event' => event_name, 'data' => data}.to_json
+      @connection.send(payload)
+      PusherClient.logger.debug("Pusher : sending event : #{payload}")
+    end
+
+  protected
+
+    def send_local_event(event_name, event_data, channel_name)
+      if (channel_name)
+        channel = @channels[channel_name]
+        if (channel)
+          channel.dispatch_with_all(event_name, event_data)
+        end
+      end
+
+      @global_channel.dispatch_with_all(event_name, event_data)
+      PusherClient.logger.debug("Pusher : event received : channel: #{channel_name}; event: #{event_name}")
+    end
+
+    def parser(data)
+      begin
+        return JSON.parse(data)
+      rescue => err
+        PusherClient.logger.warn(err)
+        PusherClient.logger.warn("Pusher : data attribute not valid JSON - you may wish to implement your own Pusher::Client.parser")
+        return data
+      end
+    end
+  end
+
+end

data/lib/pusher-client/websocket.rb

@@ -0,0 +1,84 @@
+require 'rubygems'
+require 'socket'
+require 'libwebsocket'
+require 'openssl'
+
+module PusherClient
+  class WebSocket
+
+    def initialize(url, params = {})
+      @hs ||= LibWebSocket::OpeningHandshake::Client.new(:url => url, :version => params[:version])
+      @frame ||= LibWebSocket::Frame.new
+
+      @socket = TCPSocket.new(@hs.url.host, @hs.url.port || 80)
+
+      if params[:ssl] == true
+
+        ctx = OpenSSL::SSL::SSLContext.new
+        ctx.verify_mode = OpenSSL::SSL::VERIFY_PEER|OpenSSL::SSL::VERIFY_FAIL_IF_NO_PEER_CERT
+        # http://curl.haxx.se/ca/cacert.pem
+        ctx.ca_file = path_to_cert()
+
+        ssl_sock = OpenSSL::SSL::SSLSocket.new(@socket, ctx)
+        ssl_sock.sync_close = true
+        ssl_sock.connect
+
+        @socket = ssl_sock
+
+      end
+
+      @socket.write(@hs.to_s)
+      @socket.flush
+
+      loop do
+        data = @socket.getc
+        next if data.nil?
+
+        result = @hs.parse(data.chr)
+
+        raise @hs.error unless result
+
+        if @hs.done?
+          @handshaked = true
+          break
+        end
+      end
+    end
+
+    def path_to_cert
+      File.join(File.dirname(File.expand_path(__FILE__)), '../../certs/cacert.pem')
+    end
+
+    def send(data)
+      raise "no handshake!" unless @handshaked
+
+      data = @frame.new(data).to_s
+      @socket.write data
+      @socket.flush
+    end
+
+    def receive
+      raise "no handshake!" unless @handshaked
+
+      data = @socket.gets("\xff")
+      @frame.append(data)
+
+      messages = []
+      while message = @frame.next
+        messages << message
+      end
+      messages
+    end
+
+    def socket
+      @socket
+    end
+
+    def close
+      @socket.close
+    end
+
+  end
+end
+
+

data/pusher-client.gemspec

@@ -0,0 +1,73 @@
+# 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 = %q{pusher-client-merman}
+  s.version = "0.2.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Logan Koester"]
+  s.date = %q{2011-01-07}
+  s.description = %q{Ruby client for consuming WebSockets from http://pusherapp.com}
+  s.email = %q{logan@logankoester.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "examples/hello_pusher.rb",
+    "examples/hello_pusher_async.rb",
+    "lib/pusher-client.rb",
+    "lib/pusher-client/channel.rb",
+    "lib/pusher-client/channels.rb",
+    "lib/pusher-client/socket.rb",
+    "lib/pusher-client/websocket.rb",
+    "pusher-client.gemspec",
+    "test/pusherclient_test.rb",
+    "test/test.watchr",
+    "test/teststrap.rb"
+  ]
+  s.homepage = %q{http://github.com/logankoester/pusher-client}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Ruby client for consuming WebSockets from http://pusherapp.com}
+  s.test_files = [
+    "examples/hello_pusher.rb",
+    "examples/hello_pusher_async.rb",
+    "test/pusherclient_test.rb",
+    "test/teststrap.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<libwebsocket>, ["0.1.0"])
+      s.add_runtime_dependency(%q<ruby-hmac>, ["~> 0.4.0"])
+      s.add_runtime_dependency(%q<addressable>, ["~> 2.3.1"])
+      s.add_development_dependency(%q<bacon>, [">= 0"])
+    else
+      s.add_dependency(%q<libwebsocket>, ["0.1.0"])
+      s.add_dependency(%q<ruby-hmac>, ["~> 0.4.0"])
+      s.add_dependency(%q<addressable>, ["~> 2.3.1"])
+      s.add_dependency(%q<bacon>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<libwebsocket>, ["0.1.0"])
+    s.add_dependency(%q<addressable>, ["~> 2.3.1"])
+    s.add_dependency(%q<ruby-hmac>, ["~> 0.4.0"])
+    s.add_dependency(%q<bacon>, [">= 0"])
+  end
+end
+

data/test/pusherclient_test.rb

@@ -0,0 +1,161 @@
+require File.dirname(File.expand_path(__FILE__)) + '/teststrap.rb'
+require 'logger'
+
+describe "A PusherClient::Channels collection" do
+  before do
+    @channels = PusherClient::Channels.new
+  end
+
+  it "should initialize empty" do
+    @channels.empty?.should.equal(true)
+    @channels.size.should.equal 0
+  end
+
+  it "should instantiate new channels added to it by name" do
+    @channels << 'TestChannel'
+    @channels.find('TestChannel').class.should.equal(PusherClient::Channel)
+  end
+
+  it "should allow removal of channels by name" do
+    @channels << 'TestChannel'
+    @channels['TestChannel'].class.should.equal(PusherClient::Channel)
+    @channels.remove('TestChannel')
+    @channels.empty?.should.equal(true)
+  end
+
+  it "should not allow two channels of the same name" do
+    @channels << 'TestChannel'
+    @channels << 'TestChannel'
+    @channels.size.should.equal 1
+  end
+
+end
+
+describe "A PusherClient::Channel" do
+  before do
+    @channels = PusherClient::Channels.new
+    @channel = @channels << "TestChannel"
+  end
+
+  it 'should not be subscribed by default' do
+    @channel.subscribed.should.equal false
+  end
+
+  it 'should not be global by default' do
+    @channel.global.should.equal false
+  end
+
+  it 'can have procs bound to an event' do
+    @channel.bind('TestEvent') {}
+    @channel.callbacks.size.should.equal 1
+  end
+
+  it 'should run callbacks when an event is dispatched' do
+
+    @channel.bind('TestEvent') do
+      PusherClient.logger.test "Local callback running"
+    end
+
+    @channel.dispatch('TestEvent', {})
+    PusherClient.logger.test_messages.should.include?("Local callback running")
+  end
+
+end
+
+describe "A PusherClient::Socket" do
+  before do
+    @socket = PusherClient::Socket.new(TEST_APP_KEY)
+  end
+
+  it 'should not connect when instantiated' do
+    @socket.connected.should.equal false
+  end
+
+  it 'should raise ArgumentError if TEST_APP_KEY is not a nonempty string' do
+    lambda { 
+      @broken_socket = PusherClient::Socket.new('')
+    }.should.raise(ArgumentError)
+    lambda { 
+      @broken_socket = PusherClient::Socket.new(555)
+    }.should.raise(ArgumentError)
+  end
+
+  describe "...when connected" do
+    before do
+      @socket.connect
+    end
+
+    it 'should know its connected' do
+      @socket.connected.should.equal true
+    end
+
+    it 'should know its socket_id' do
+      @socket.socket_id.should.equal '123abc'
+    end
+
+    it 'should not be subscribed to its global channel' do
+      @socket.global_channel.subscribed.should.equal false
+    end
+
+    it 'should subscribe to a channel' do
+      @channel = @socket.subscribe('testchannel')
+      @socket.channels['testchannel'].should.equal @channel
+      @channel.subscribed.should.equal true
+    end
+
+    it 'should unsubscribe from a channel' do
+      @channel = @socket.unsubscribe('testchannel')
+      PusherClient.logger.test_messages.last.should.include?('pusher:unsubscribe')
+      @socket.channels['testchannel'].should.equal nil
+    end
+
+    it 'should allow binding of global events' do
+      @socket.bind('testevent') { |data| PusherClient.logger.test("testchannel received #{data}") }
+      @socket.global_channel.callbacks.has_key?('testevent').should.equal true
+    end
+
+    it 'should trigger callbacks for global events' do
+      @socket.bind('globalevent') { |data| PusherClient.logger.test("Global event!") }
+      @socket.global_channel.callbacks.has_key?('globalevent').should.equal true
+
+      @socket.simulate_received('globalevent', 'some data', '')
+      PusherClient.logger.test_messages.last.should.include?('Global event!')
+    end
+
+    it 'should kill the connection thread when disconnect is called' do
+      @socket.disconnect
+      Thread.list.size.should.equal 1
+    end
+
+    it 'should not be connected after disconnecting' do
+      @socket.disconnect
+      @socket.connected.should.equal false
+    end
+
+    describe "when subscribed to a channel" do
+      before do
+        @channel = @socket.subscribe('testchannel')
+      end
+
+      it 'should allow binding of callbacks for the subscribed channel' do
+        @socket['testchannel'].bind('testevent') { |data| PusherClient.logger.test(data) }
+        @socket['testchannel'].callbacks.has_key?('testevent').should.equal true
+      end
+
+      it "should trigger channel callbacks when a message is received" do
+        # Bind 2 events for the channel
+        @socket['testchannel'].bind('coming') { |data| PusherClient.logger.test(data) }
+        @socket['testchannel'].bind('going')  { |data| PusherClient.logger.test(data) }
+
+        # Simulate the first event
+        @socket.simulate_received('coming', 'Hello!', 'testchannel')
+        PusherClient.logger.test_messages.last.should.include?('Hello!')
+
+        # Simulate the second event
+        @socket.simulate_received('going', 'Goodbye!', 'testchannel')
+        PusherClient.logger.test_messages.last.should.include?('Goodbye!')
+      end
+
+    end
+  end
+end

data/test/test.watchr

@@ -0,0 +1,63 @@
+ENV["WATCHR"] = "1"
+system 'clear'
+puts "Watchr: Ready! :-)"
+
+def notify_send(result)
+  #title = "Watchr Test Results"
+  if result.include?("FAILED") or result.include?("ERROR")
+    title = "FAIL"
+    image = "~/.autotest_images/fail.png" 
+    message = "One or more tests have failed"
+  else
+    title = "PASS"
+    image = "~/.autotest_images/pass.png"
+    message = "All tests pass"
+  end
+
+  options = "-c Watchr --icon '#{File.expand_path(image)}' '#{title}' '#{message}' --urgency=critical"
+  system %(notify-send #{options} &)
+end
+
+def run(cmd)
+  puts(cmd)
+  `#{cmd}`
+end
+
+def run_all_tests
+  system('clear')
+  result = run "bacon test/*_test.rb"
+  notify_send result
+  puts result
+end
+
+def run_suite
+  run_all_tests
+end
+
+watch('test/teststrap\.rb') { run_all_tests }
+watch('test/factories\.rb') { run_all_tests }
+watch('test/.*_test.*\.rb') { run_all_tests }
+watch('lib/*\.rb') { run_all_tests }
+watch('lib/.*/*\.rb') { run_all_tests }
+
+# Ctrl-\
+Signal.trap 'QUIT' do
+  puts " --- Running all tests ---\n\n"
+  run_all_tests
+end
+
+@interrupted = false
+
+# Ctrl-C
+Signal.trap 'INT' do
+  if @interrupted then
+    @wants_to_quit = true
+    abort("\n")
+  else
+    puts "Interrupt a second time to quit"
+    @interrupted = true
+    Kernel.sleep 1.5
+    # raise Interrupt, nil # let the run loop catch it
+    run_suite
+  end
+end

data/test/teststrap.rb

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'bacon'
+
+require File.dirname(__FILE__) + '/../lib/pusher-client.rb'
+
+TEST_APP_KEY = "TEST_APP_KEY"
+
+module PusherClient
+  class TestLogger < Logger
+    attr_reader :test_messages
+
+    def initialize(logdev, shift_age = 0, shift_size = 1048576)
+      @test_messages = []
+      super
+    end
+    def test(msg)
+      @test_messages << msg
+      debug msg
+    end
+  end
+
+  class Socket
+    # Simulate a connection being established
+    def connect(async = false)
+      @connection_thread = Thread.new do
+        @connection = TestConnection.new
+        @global_channel.dispatch('pusher:connection_established', {'socket_id' => '123abc'})
+      end
+      @connection_thread.run
+      @connection_thread.join unless async
+      return self
+    end
+
+    def simulate_received(event_name, event_data, channel_name)
+      send_local_event(event_name, event_data, channel_name)
+    end
+  end
+
+  class TestConnection
+    def send(payload)
+      PusherClient.logger.test("SEND: #{payload}")
+    end
+
+    def close
+    end
+  end
+
+  PusherClient.logger = TestLogger.new('test.log')
+
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: pusher-client-merman
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+  prerelease: 
+platform: ruby
+authors:
+- Logan Koester
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-01-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: libwebsocket
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: ruby-hmac
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.1
+- !ruby/object:Gem::Dependency
+  name: bacon
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby client for consuming WebSockets from http://pusherapp.com
+email: logan@logankoester.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- examples/hello_pusher.rb
+- examples/hello_pusher_async.rb
+- lib/pusher-client.rb
+- lib/pusher-client/channel.rb
+- lib/pusher-client/channels.rb
+- lib/pusher-client/socket.rb
+- lib/pusher-client/websocket.rb
+- pusher-client.gemspec
+- test/pusherclient_test.rb
+- test/test.watchr
+- test/teststrap.rb
+homepage: http://github.com/logankoester/pusher-client
+licenses:
+- MIT
+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 client for consuming WebSockets from http://pusherapp.com
+test_files:
+- examples/hello_pusher.rb
+- examples/hello_pusher_async.rb
+- test/pusherclient_test.rb
+- test/teststrap.rb