pusher 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 41c533b3af72b8bbc59b837e057140c199df3dde
-  data.tar.gz: 72c2170cf91722d54cee192da0afda69f3304462
+  metadata.gz: 6daeeb10cfc7c29540cc4640cda4379f08c97a0a
+  data.tar.gz: d1387f40e14a45e68c5b7c2ba457d68d0e6f04e8
 SHA512:
-  metadata.gz: 7991ee28bfe11b60a97fae9deaec6896fd538c45747ece3804d6db77f4b01aaedc4a407a3f4d77c5b1a3d12c7eac2365c9262ce3da1f2cad3f70652f0ce459ae
-  data.tar.gz: 02eb45ed9d8b1ed4a899084a2eca8912facd311214b45f6131b83c721a12681246b28733d394c25cbff730c1e5005d9a81878687557855949ed832c8d81aec2e
+  metadata.gz: 68870356440d4b596c15ad6a51d65769d89cb036e782cffaedccc9f47d4d4707020c4e02671919ccd3c519019da9bb02505a6bfa9739e7e96fe358e38adfef4c
+  data.tar.gz: 3eeaa5528655dd1fc071e93adff493a39fc21843aea95f38b9076f8f9aebbb025f5b68afcd06f82bea733f985fa29f5e07611305051d5cc7bc4b8b04b95471af

data/CHANGELOG.md

@@ -1,4 +1,9 @@
 
+1.1.0 / 2016-05-20
+==================
+
+  * Add support for batch events
+
 1.0.0 / 2016-05-19
 ==================
 

data/README.md

@@ -131,6 +131,18 @@ An optional fourth argument may be used to send additional parameters to the API
 Pusher.trigger('channel', 'event', {foo: 'bar'}, {socket_id: '123.456'})
 ```
 
+#### Batches
+
+It's also possible to send multiple events with a single API call (max 10
+events per call on multi-tenant clusters):
+
+``` ruby
+Pusher.trigger_batch([
+  {channel: 'channel_1', name: 'event_name', data: { foo: 'bar' }}
+  {channel: 'channel_1', name: 'event_name', data: { hello: 'world' }}
+])
+```
+
 #### Deprecated publisher API
 
 Most examples and documentation will refer to the following syntax for triggering an event:

data/lib/pusher/client.rb

@@ -269,6 +269,21 @@ module Pusher
       post('/events', trigger_params(channels, event_name, data, params))
     end
 
+    # Trigger multiple events at the same time
+    #
+    # POST /apps/[app_id]/batch_events
+    #
+    # @param events [Array] List of events to publish
+    #
+    # @return [Hash] See Pusher API docs
+    #
+    # @raise [Pusher::Error] Unsuccessful response - see the error message
+    # @raise [Pusher::HTTPError] Error raised inside http client. The original error is wrapped in error.original_error
+    #
+    def trigger_batch(*events)
+      post('/batch_events', trigger_batch_params(events.flatten))
+    end
+
     # Trigger an event on one or more channels asynchronously.
     # For parameters see #trigger
     #
@@ -276,6 +291,13 @@ module Pusher
       post_async('/events', trigger_params(channels, event_name, data, params))
     end
 
+    # Trigger multiple events asynchronously.
+    # For parameters see #trigger_batch
+    #
+    def trigger_batch_async(*events)
+      post_async('/batch_events', trigger_batch_params(events.flatten))
+    end
+
     # Generate the expected response for an authentication endpoint.
     # See http://pusher.com/docs/authenticating_users for details.
     #
@@ -351,23 +373,27 @@ module Pusher
       channels = Array(channels).map(&:to_s)
       raise Pusher::Error, "Too many channels (#{channels.length}), max 10" if channels.length > 10
 
-      encoded_data = case data
-      when String
-        data
-      else
-        begin
-          MultiJson.encode(data)
-        rescue MultiJson::DecodeError => e
-          Pusher.logger.error("Could not convert #{data.inspect} into JSON")
-          raise e
+      params.merge({
+        name: event_name,
+        channels: channels,
+        data: encode_data(data),
+      })
+    end
+
+    def trigger_batch_params(events)
+      {
+        batch: events.map do |event|
+          event.dup.tap do |e|
+            e[:data] = encode_data(e[:data])
+          end
         end
-      end
+      }
+    end
 
-      return params.merge({
-        :name => event_name,
-        :channels => channels,
-        :data => encoded_data,
-      })
+    # JSON-encode the data if it's not a string
+    def encode_data(data)
+      return data if data.is_a? String
+      MultiJson.encode(data)
     end
 
     def configured?

data/pusher.gemspec

@@ -1,9 +1,7 @@
 # -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-
 Gem::Specification.new do |s|
   s.name        = "pusher"
-  s.version     = "1.0.0"
+  s.version     = "1.1.0"
   s.platform    = Gem::Platform::RUBY
   s.authors     = ["Pusher"]
   s.email       = ["support@pusher.com"]

data/spec/client_spec.rb

@@ -274,6 +274,37 @@ describe Pusher do
         end
       end
 
+      describe '#trigger_batch' do
+        before :each do
+          @api_path = %r{/apps/20/batch_events}
+          stub_request(:post, @api_path).to_return({
+            :status => 200,
+            :body => MultiJson.encode({})
+          })
+        end
+
+        it "should call correct URL" do
+          expect(@client.trigger_batch(channel: 'mychannel', name: 'event', data: {'some' => 'data'})).
+            to eq({})
+        end
+
+        it "should convert non string data to JSON before posting" do
+          @client.trigger_batch(
+            {channel: 'mychannel', name: 'event', data: {'some' => 'data'}},
+            {channel: 'mychannel', name: 'event', data: 'already encoded'},
+          )
+          expect(WebMock).to have_requested(:post, @api_path).with { |req|
+            parsed = MultiJson.decode(req.body)
+            expect(parsed).to eq(
+              "batch" => [
+                { "channel" => "mychannel", "name" => "event", "data" => "{\"some\":\"data\"}"},
+                { "channel" => "mychannel", "name" => "event", "data" => "already encoded"}
+              ]
+            )
+          }
+        end
+      end
+
       describe '#trigger_async' do
         before :each do
           @api_path = %r{/apps/20/events}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pusher
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Pusher
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-19 00:00:00.000000000 Z
+date: 2016-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json