RubyGems - ably - Versions diffs - 0.7.0 → 0.7.1 - Mend

ably 0.7.0 → 0.7.1

Files changed (49) hide show

data/.travis.yml +2 -2
data/Rakefile +2 -0
data/SPEC.md +230 -194
data/ably.gemspec +2 -0
data/lib/ably/auth.rb +7 -5
data/lib/ably/models/idiomatic_ruby_wrapper.rb +5 -7
data/lib/ably/models/paginated_resource.rb +14 -21
data/lib/ably/models/protocol_message.rb +1 -1
data/lib/ably/modules/ably.rb +4 -0
data/lib/ably/modules/async_wrapper.rb +2 -2
data/lib/ably/modules/channels_collection.rb +31 -8
data/lib/ably/modules/conversions.rb +10 -0
data/lib/ably/modules/enum.rb +2 -3
data/lib/ably/modules/state_emitter.rb +8 -8
data/lib/ably/modules/state_machine.rb +7 -3
data/lib/ably/realtime/channel.rb +6 -5
data/lib/ably/realtime/channel/channel_manager.rb +11 -10
data/lib/ably/realtime/channel/channel_state_machine.rb +10 -9
data/lib/ably/realtime/channels.rb +3 -0
data/lib/ably/realtime/client/incoming_message_dispatcher.rb +11 -1
data/lib/ably/realtime/connection.rb +55 -16
data/lib/ably/realtime/connection/connection_manager.rb +25 -8
data/lib/ably/realtime/connection/connection_state_machine.rb +9 -9
data/lib/ably/realtime/connection/websocket_transport.rb +2 -2
data/lib/ably/realtime/presence.rb +16 -17
data/lib/ably/util/crypto.rb +1 -1
data/lib/ably/version.rb +1 -1
data/spec/acceptance/realtime/channel_history_spec.rb +6 -5
data/spec/acceptance/realtime/connection_failures_spec.rb +103 -27
data/spec/acceptance/realtime/connection_spec.rb +81 -17
data/spec/acceptance/realtime/presence_spec.rb +82 -30
data/spec/acceptance/rest/auth_spec.rb +22 -19
data/spec/acceptance/rest/client_spec.rb +4 -4
data/spec/acceptance/rest/presence_spec.rb +12 -6
data/spec/rspec_config.rb +9 -0
data/spec/shared/model_behaviour.rb +1 -1
data/spec/spec_helper.rb +4 -1
data/spec/support/event_machine_helper.rb +26 -37
data/spec/support/markdown_spec_formatter.rb +96 -68
data/spec/support/rest_testapp_before_retry.rb +15 -0
data/spec/support/test_app.rb +4 -0
data/spec/unit/models/idiomatic_ruby_wrapper_spec.rb +20 -2
data/spec/unit/models/message_spec.rb +1 -1
data/spec/unit/models/paginated_resource_spec.rb +15 -1
data/spec/unit/modules/enum_spec.rb +10 -0
data/spec/unit/realtime/channels_spec.rb +30 -0
data/spec/unit/rest/channels_spec.rb +30 -0
metadata +101 -35
checksums.yaml +0 -7

data/.travis.yml CHANGED Viewed

@@ -1,7 +1,7 @@
+env: RSPEC_RETRY=true
 language: ruby
 rvm:
   - 1.9.3
   - 2.0.0
-  - 2.1.1
-  - rbx-2.4.1
+  - 2.2.0

data/Rakefile CHANGED Viewed

@@ -1,3 +1,5 @@
+require 'rubygems'
+require 'bundler/setup'
 require 'bundler/gem_tasks'
 require 'json'

data/SPEC.md CHANGED Viewed

@@ -1,4 +1,4 @@
-# Ably Client Library 0.7.0 Specification
+# Ably Real-time & REST Client Library 0.7.1 Specification
 ### Ably::Realtime::Channel#history
 _(see [spec/acceptance/realtime/channel_history_spec.rb](./spec/acceptance/realtime/channel_history_spec.rb))_
@@ -10,13 +10,13 @@ _(see [spec/acceptance/realtime/channel_history_spec.rb](./spec/acceptance/realt
       * [retrieves real-time history on both channels](./spec/acceptance/realtime/channel_history_spec.rb#L45)
     * with lots of messages published with a single client and channel
       * as one ProtocolMessage
-        * [retrieves history forwards with pagination through :limit option](./spec/acceptance/realtime/channel_history_spec.rb#L86)
-        * [retrieves history backwards with pagination through :limit option](./spec/acceptance/realtime/channel_history_spec.rb#L95)
+        * [retrieves history forwards with pagination through :limit option](./spec/acceptance/realtime/channel_history_spec.rb#L87)
+        * [retrieves history backwards with pagination through :limit option](./spec/acceptance/realtime/channel_history_spec.rb#L96)
       * in multiple ProtocolMessages
-        * [retrieves limited history forwards with pagination](./spec/acceptance/realtime/channel_history_spec.rb#L106)
-        * [retrieves limited history backwards with pagination](./spec/acceptance/realtime/channel_history_spec.rb#L117)
+        * [retrieves limited history forwards with pagination](./spec/acceptance/realtime/channel_history_spec.rb#L107)
+        * [retrieves limited history backwards with pagination](./spec/acceptance/realtime/channel_history_spec.rb#L118)
       * and REST history
-        * [return the same results with unique matching message IDs](./spec/acceptance/realtime/channel_history_spec.rb#L133)
+        * [return the same results with unique matching message IDs](./spec/acceptance/realtime/channel_history_spec.rb#L134)
 ### Ably::Realtime::Channel
 _(see [spec/acceptance/realtime/channel_spec.rb](./spec/acceptance/realtime/channel_spec.rb))_
@@ -169,14 +169,21 @@ _(see [spec/acceptance/realtime/connection_failures_spec.rb](./spec/acceptance/r
         * [retains channel subscription state](./spec/acceptance/realtime/connection_failures_spec.rb#L343)
         * when messages were published whilst the client was disconnected
           * [receives the messages published whilst offline](./spec/acceptance/realtime/connection_failures_spec.rb#L363)
+      * when failing to resume because the connection_key is not or no longer valid
+        * [updates the connection_id and connection_key](./spec/acceptance/realtime/connection_failures_spec.rb#L403)
+        * [detaches all channels](./spec/acceptance/realtime/connection_failures_spec.rb#L418)
+        * [emits an error on the channel and sets the error reason](./spec/acceptance/realtime/connection_failures_spec.rb#L436)
     * fallback host feature
       * with custom realtime websocket host option
-        * [never uses a fallback host](./spec/acceptance/realtime/connection_failures_spec.rb#L419)
+        * [never uses a fallback host](./spec/acceptance/realtime/connection_failures_spec.rb#L472)
       * with non-production environment
-        * [never uses a fallback host](./spec/acceptance/realtime/connection_failures_spec.rb#L436)
+        * [never uses a fallback host](./spec/acceptance/realtime/connection_failures_spec.rb#L489)
       * with production environment
-        * [uses a fallback host on every subsequent disconnected attempt until suspended](./spec/acceptance/realtime/connection_failures_spec.rb#L459)
-        * [uses the primary host when suspended, and a fallback host on every subsequent suspended attempt](./spec/acceptance/realtime/connection_failures_spec.rb#L478)
+        * when the Internet is down
+          * [never uses a fallback host](./spec/acceptance/realtime/connection_failures_spec.rb#L517)
+        * when the Internet is up
+          * [uses a fallback host on every subsequent disconnected attempt until suspended](./spec/acceptance/realtime/connection_failures_spec.rb#L534)
+          * [uses the primary host when suspended, and a fallback host on every subsequent suspended attempt](./spec/acceptance/realtime/connection_failures_spec.rb#L553)
 ### Ably::Realtime::Connection
 _(see [spec/acceptance/realtime/connection_spec.rb](./spec/acceptance/realtime/connection_spec.rb))_
@@ -202,73 +209,84 @@ _(see [spec/acceptance/realtime/connection_spec.rb](./spec/acceptance/realtime/c
                 * [uses the primary host for subsequent connection and auth requests](./spec/acceptance/realtime/connection_spec.rb#L117)
             * when connected with a valid non-expired token
               * that then expires following the connection being opened
-                * PENDING: *[retains connection state](./spec/acceptance/realtime/connection_spec.rb#L162)*
-                * PENDING: *[changes state to failed if a new token cannot be issued](./spec/acceptance/realtime/connection_spec.rb#L163)*
+                * PENDING: *[retains connection state](./spec/acceptance/realtime/connection_spec.rb#L164)*
+                * PENDING: *[changes state to failed if a new token cannot be issued](./spec/acceptance/realtime/connection_spec.rb#L165)*
                 * the server
                   * [disconnects the client, and the client automatically renews the token and then reconnects](./spec/acceptance/realtime/connection_spec.rb#L141)
         * for non-renewable tokens
           * that are expired
             * opening a new connection
-              * [transitions state to failed](./spec/acceptance/realtime/connection_spec.rb#L178)
+              * [transitions state to failed](./spec/acceptance/realtime/connection_spec.rb#L180)
             * when connected
-              * PENDING: *[transitions state to failed](./spec/acceptance/realtime/connection_spec.rb#L191)*
+              * PENDING: *[transitions state to failed](./spec/acceptance/realtime/connection_spec.rb#L193)*
     * initialization state changes
       * with implicit #connect
-        * [are triggered in order](./spec/acceptance/realtime/connection_spec.rb#L219)
+        * [are triggered in order](./spec/acceptance/realtime/connection_spec.rb#L221)
       * with explicit #connect
-        * [are triggered in order](./spec/acceptance/realtime/connection_spec.rb#L225)
+        * [are triggered in order](./spec/acceptance/realtime/connection_spec.rb#L227)
     * #connect
-      * [returns a Deferrable](./spec/acceptance/realtime/connection_spec.rb#L233)
-      * [calls the Deferrable callback on success](./spec/acceptance/realtime/connection_spec.rb#L238)
+      * [returns a Deferrable](./spec/acceptance/realtime/connection_spec.rb#L235)
+      * [calls the Deferrable callback on success](./spec/acceptance/realtime/connection_spec.rb#L240)
       * when already connected
-        * [does nothing and no further state changes are emitted](./spec/acceptance/realtime/connection_spec.rb#L247)
+        * [does nothing and no further state changes are emitted](./spec/acceptance/realtime/connection_spec.rb#L249)
       * once connected
         * connection#id
-          * [is a string](./spec/acceptance/realtime/connection_spec.rb#L264)
-          * [is unique from the connection#key](./spec/acceptance/realtime/connection_spec.rb#L271)
-          * [is unique for every connection](./spec/acceptance/realtime/connection_spec.rb#L278)
+          * [is a string](./spec/acceptance/realtime/connection_spec.rb#L266)
+          * [is unique from the connection#key](./spec/acceptance/realtime/connection_spec.rb#L273)
+          * [is unique for every connection](./spec/acceptance/realtime/connection_spec.rb#L280)
         * connection#key
-          * [is a string](./spec/acceptance/realtime/connection_spec.rb#L287)
-          * [is unique from the connection#id](./spec/acceptance/realtime/connection_spec.rb#L294)
-          * [is unique for every connection](./spec/acceptance/realtime/connection_spec.rb#L301)
+          * [is a string](./spec/acceptance/realtime/connection_spec.rb#L289)
+          * [is unique from the connection#id](./spec/acceptance/realtime/connection_spec.rb#L296)
+          * [is unique for every connection](./spec/acceptance/realtime/connection_spec.rb#L303)
       * following a previous connection being opened and closed
-        * [reconnects and is provided with a new connection ID and connection key from the server](./spec/acceptance/realtime/connection_spec.rb#L311)
+        * [reconnects and is provided with a new connection ID and connection key from the server](./spec/acceptance/realtime/connection_spec.rb#L313)
     * #close
-      * [returns a Deferrable](./spec/acceptance/realtime/connection_spec.rb#L329)
-      * [calls the Deferrable callback on success](./spec/acceptance/realtime/connection_spec.rb#L336)
+      * [returns a Deferrable](./spec/acceptance/realtime/connection_spec.rb#L331)
+      * [calls the Deferrable callback on success](./spec/acceptance/realtime/connection_spec.rb#L338)
       * when already closed
-        * [does nothing and no further state changes are emitted](./spec/acceptance/realtime/connection_spec.rb#L347)
+        * [does nothing and no further state changes are emitted](./spec/acceptance/realtime/connection_spec.rb#L349)
       * when connection state is
         * :initialized
-          * [changes the connection state to :closing and then immediately :closed without sending a ProtocolMessage CLOSE](./spec/acceptance/realtime/connection_spec.rb#L375)
+          * [changes the connection state to :closing and then immediately :closed without sending a ProtocolMessage CLOSE](./spec/acceptance/realtime/connection_spec.rb#L377)
         * :connected
-          * [changes the connection state to :closing and waits for the server to confirm connection is :closed with a ProtocolMessage](./spec/acceptance/realtime/connection_spec.rb#L393)
+          * [changes the connection state to :closing and waits for the server to confirm connection is :closed with a ProtocolMessage](./spec/acceptance/realtime/connection_spec.rb#L395)
           * with an unresponsive connection
-            * [force closes the connection when a :closed ProtocolMessage response is not received](./spec/acceptance/realtime/connection_spec.rb#L423)
+            * [force closes the connection when a :closed ProtocolMessage response is not received](./spec/acceptance/realtime/connection_spec.rb#L425)
     * #ping
-      * [echoes a heart beat](./spec/acceptance/realtime/connection_spec.rb#L446)
+      * [echoes a heart beat](./spec/acceptance/realtime/connection_spec.rb#L448)
       * when not connected
-        * [raises an exception](./spec/acceptance/realtime/connection_spec.rb#L456)
+        * [raises an exception](./spec/acceptance/realtime/connection_spec.rb#L458)
     * recovery
       * #recovery_key
-        * [is composed of connection id and serial that is kept up to date with each message sent](./spec/acceptance/realtime/connection_spec.rb#L489)
-        * [is available when connection is in one of the states: connecting, connected, disconnected, suspended, failed](./spec/acceptance/realtime/connection_spec.rb#L510)
-        * [is nil when connection is explicitly CLOSED](./spec/acceptance/realtime/connection_spec.rb#L534)
+        * [is composed of connection id and serial that is kept up to date with each message sent](./spec/acceptance/realtime/connection_spec.rb#L491)
+        * [is available when connection is in one of the states: connecting, connected, disconnected, suspended, failed](./spec/acceptance/realtime/connection_spec.rb#L512)
+        * [is nil when connection is explicitly CLOSED](./spec/acceptance/realtime/connection_spec.rb#L536)
       * opening a new connection using a recently disconnected connection's #recovery_key
         * connection#id and connection#key after recovery
-          * [remain the same](./spec/acceptance/realtime/connection_spec.rb#L548)
+          * [remain the same](./spec/acceptance/realtime/connection_spec.rb#L550)
         * when messages have been sent whilst the old connection is disconnected
           * the new connection
-            * [recovers server-side queued messages](./spec/acceptance/realtime/connection_spec.rb#L573)
+            * [recovers server-side queued messages](./spec/acceptance/realtime/connection_spec.rb#L575)
       * with :recover option
         * with invalid syntax
-          * [raises an exception](./spec/acceptance/realtime/connection_spec.rb#L598)
-        * with invalid value
-          * PENDING: *[triggers an error on the connection object, sets the #error_reason and connects anyway](./spec/acceptance/realtime/connection_spec.rb#L607)*
+          * [raises an exception](./spec/acceptance/realtime/connection_spec.rb#L600)
+        * with invalid formatted value sent to server
+          * [triggers a fatal error on the connection object, sets the #error_reason and disconnects](./spec/acceptance/realtime/connection_spec.rb#L609)
+        * with expired (missing) value sent to server
+          * [triggers an error on the connection object, sets the #error_reason, yet will connect anyway](./spec/acceptance/realtime/connection_spec.rb#L623)
     * with many connections simultaneously
-      * [opens each with a unique connection#id and connection#key](./spec/acceptance/realtime/connection_spec.rb#L624)
+      * [opens each with a unique connection#id and connection#key](./spec/acceptance/realtime/connection_spec.rb#L641)
     * when a state transition is unsupported
-      * [emits a StateChangeError](./spec/acceptance/realtime/connection_spec.rb#L644)
+      * [emits a StateChangeError](./spec/acceptance/realtime/connection_spec.rb#L661)
+    * undocumented method
+      * #internet_up?
+        * [returns a Deferrable](./spec/acceptance/realtime/connection_spec.rb#L676)
+        * when the Internet is up
+          * [calls the block with true](./spec/acceptance/realtime/connection_spec.rb#L682)
+          * [calls the success callback of the Deferrable](./spec/acceptance/realtime/connection_spec.rb#L689)
+        * when the Internet is down
+          * [calls the block with false](./spec/acceptance/realtime/connection_spec.rb#L701)
+          * [calls the failure callback of the Deferrable](./spec/acceptance/realtime/connection_spec.rb#L708)
 ### Ably::Realtime::Channel Message
 _(see [spec/acceptance/realtime/message_spec.rb](./spec/acceptance/realtime/message_spec.rb))_
@@ -361,11 +379,11 @@ _(see [spec/acceptance/realtime/presence_history_spec.rb](./spec/acceptance/real
 ### Ably::Realtime::Presence
 _(see [spec/acceptance/realtime/presence_spec.rb](./spec/acceptance/realtime/presence_spec.rb))_
   * using JSON and MsgPack protocol
-    * PENDING: *[ensure connection_id is unique and updated on ENTER](./spec/acceptance/realtime/presence_spec.rb#L943)*
-    * PENDING: *[ensure connection_id for presence member matches the messages they publish on the channel](./spec/acceptance/realtime/presence_spec.rb#L944)*
-    * PENDING: *[stop a call to get when the channel has not been entered](./spec/acceptance/realtime/presence_spec.rb#L945)*
-    * PENDING: *[stop a call to get when the channel has been entered but the list is not up to date](./spec/acceptance/realtime/presence_spec.rb#L946)*
-    * PENDING: *[presence will resume sync if connection is dropped mid-way](./spec/acceptance/realtime/presence_spec.rb#L947)*
+    * PENDING: *[ensure connection_id is unique and updated on ENTER](./spec/acceptance/realtime/presence_spec.rb#L995)*
+    * PENDING: *[ensure connection_id for presence member matches the messages they publish on the channel](./spec/acceptance/realtime/presence_spec.rb#L996)*
+    * PENDING: *[stop a call to get when the channel has not been entered](./spec/acceptance/realtime/presence_spec.rb#L997)*
+    * PENDING: *[stop a call to get when the channel has been entered but the list is not up to date](./spec/acceptance/realtime/presence_spec.rb#L998)*
+    * PENDING: *[presence will resume sync if connection is dropped mid-way](./spec/acceptance/realtime/presence_spec.rb#L999)*
     * when attached (but not present) on a presence channel with an anonymous client (no client ID)
       * [maintains state as other clients enter and leave the channel](./spec/acceptance/realtime/presence_spec.rb#L24)
     * #sync_complete?
@@ -396,90 +414,93 @@ _(see [spec/acceptance/realtime/presence_spec.rb](./spec/acceptance/realtime/pre
     * #update
       * [without previous #enter automatically enters](./spec/acceptance/realtime/presence_spec.rb#L224)
       * [updates the data if :data argument provided](./spec/acceptance/realtime/presence_spec.rb#L249)
-      * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L259)
-      * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L266)
+      * [updates the data to nil if :data argument is not provided (assumes nil value)](./spec/acceptance/realtime/presence_spec.rb#L259)
+      * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L269)
+      * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L276)
       * when ENTERED
         * [has no effect on the state](./spec/acceptance/realtime/presence_spec.rb#L234)
     * #leave
-      * [raises an exception if not entered](./spec/acceptance/realtime/presence_spec.rb#L321)
-      * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L326)
-      * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L333)
+      * [raises an exception if not entered](./spec/acceptance/realtime/presence_spec.rb#L332)
+      * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L337)
+      * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L344)
       * :data option
         * when set to a string
-          * [emits the new data for the leave event](./spec/acceptance/realtime/presence_spec.rb#L282)
+          * [emits the new data for the leave event](./spec/acceptance/realtime/presence_spec.rb#L293)
         * when set to nil
-          * FAILED: ~~[emits nil data for the leave event](./spec/acceptance/realtime/presence_spec.rb#L295)~~
+          * [emits the previously defined value as a convenience](./spec/acceptance/realtime/presence_spec.rb#L306)
         * when not passed as an argument
-          * [emits the original data for the leave event](./spec/acceptance/realtime/presence_spec.rb#L308)
+          * [emits the previously defined value as a convenience](./spec/acceptance/realtime/presence_spec.rb#L319)
     * :left event
-      * [emits the data defined in enter](./spec/acceptance/realtime/presence_spec.rb#L345)
-      * [emits the data defined in update](./spec/acceptance/realtime/presence_spec.rb#L356)
+      * [emits the data defined in enter](./spec/acceptance/realtime/presence_spec.rb#L356)
+      * [emits the data defined in update](./spec/acceptance/realtime/presence_spec.rb#L367)
     * entering/updating/leaving presence state on behalf of another client_id
       * #enter_client
-        * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L407)
-        * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L412)
+        * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L418)
+        * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L423)
         * multiple times on the same channel with different client_ids
-          * [has no affect on the client's presence state and only enters on behalf of the provided client_id](./spec/acceptance/realtime/presence_spec.rb#L377)
-          * [enters a channel and sets the data based on the provided :data option](./spec/acceptance/realtime/presence_spec.rb#L391)
+          * [has no affect on the client's presence state and only enters on behalf of the provided client_id](./spec/acceptance/realtime/presence_spec.rb#L388)
+          * [enters a channel and sets the data based on the provided :data option](./spec/acceptance/realtime/presence_spec.rb#L402)
       * #update_client
-        * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L469)
-        * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L474)
+        * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L492)
+        * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L497)
         * multiple times on the same channel with different client_ids
-          * [updates the data attribute for the member when :data option provided](./spec/acceptance/realtime/presence_spec.rb#L422)
-          * [enters if not already entered](./spec/acceptance/realtime/presence_spec.rb#L446)
+          * [updates the data attribute for the member when :data option provided](./spec/acceptance/realtime/presence_spec.rb#L433)
+          * [updates the data attribute to null for the member when :data option is not provided (assumed null)](./spec/acceptance/realtime/presence_spec.rb#L457)
+          * [enters if not already entered](./spec/acceptance/realtime/presence_spec.rb#L469)
       * #leave_client
-        * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L572)
-        * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L577)
+        * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L595)
+        * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L600)
         * leaves a channel
           * multiple times on the same channel with different client_ids
-            * [emits the :leave event for each client_id](./spec/acceptance/realtime/presence_spec.rb#L485)
-            * [succeeds if that client_id has not previously entered the channel](./spec/acceptance/realtime/presence_spec.rb#L509)
+            * [emits the :leave event for each client_id](./spec/acceptance/realtime/presence_spec.rb#L508)
+            * [succeeds if that client_id has not previously entered the channel](./spec/acceptance/realtime/presence_spec.rb#L532)
           * with a new value in :data option
-            * [emits the leave event with the new data value](./spec/acceptance/realtime/presence_spec.rb#L533)
+            * [emits the leave event with the new data value](./spec/acceptance/realtime/presence_spec.rb#L556)
           * with a nil value in :data option
-            * FAILED: ~~[emits the leave event with a nil value](./spec/acceptance/realtime/presence_spec.rb#L546)~~
+            * [emits the leave event with the previous value as a convenience](./spec/acceptance/realtime/presence_spec.rb#L569)
           * with no :data option
-            * [emits the leave event with the previous data value](./spec/acceptance/realtime/presence_spec.rb#L559)
+            * [emits the leave event with the previous value as a convenience](./spec/acceptance/realtime/presence_spec.rb#L582)
     * #get
-      * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L587)
-      * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L592)
-      * [returns the current members on the channel](./spec/acceptance/realtime/presence_spec.rb#L599)
-      * [filters by connection_id option if provided](./spec/acceptance/realtime/presence_spec.rb#L614)
-      * [filters by client_id option if provided](./spec/acceptance/realtime/presence_spec.rb#L629)
-      * [does not wait for SYNC to complete if :wait_for_sync option is false](./spec/acceptance/realtime/presence_spec.rb#L646)
-      * [returns both members on both simultaneously connected clients](./spec/acceptance/realtime/presence_spec.rb#L668)
+      * [returns a Deferrable](./spec/acceptance/realtime/presence_spec.rb#L610)
+      * [calls the Deferrable callback on success](./spec/acceptance/realtime/presence_spec.rb#L615)
+      * [returns the current members on the channel](./spec/acceptance/realtime/presence_spec.rb#L622)
+      * [filters by connection_id option if provided](./spec/acceptance/realtime/presence_spec.rb#L637)
+      * [filters by client_id option if provided](./spec/acceptance/realtime/presence_spec.rb#L659)
+      * [does not wait for SYNC to complete if :wait_for_sync option is false](./spec/acceptance/realtime/presence_spec.rb#L683)
       * when a member enters and then leaves
-        * [has no members](./spec/acceptance/realtime/presence_spec.rb#L656)
+        * [has no members](./spec/acceptance/realtime/presence_spec.rb#L693)
+      * with lots of members on different clients
+        * [returns a complete list of members on all clients](./spec/acceptance/realtime/presence_spec.rb#L710)
     * #subscribe
       * with no arguments
-        * [calls the callback for all presence events](./spec/acceptance/realtime/presence_spec.rb#L694)
+        * [calls the callback for all presence events](./spec/acceptance/realtime/presence_spec.rb#L746)
     * #unsubscribe
       * with no arguments
-        * [removes the callback for all presence events](./spec/acceptance/realtime/presence_spec.rb#L714)
+        * [removes the callback for all presence events](./spec/acceptance/realtime/presence_spec.rb#L766)
     * REST #get
-      * [returns current members](./spec/acceptance/realtime/presence_spec.rb#L733)
-      * [returns no members once left](./spec/acceptance/realtime/presence_spec.rb#L746)
+      * [returns current members](./spec/acceptance/realtime/presence_spec.rb#L785)
+      * [returns no members once left](./spec/acceptance/realtime/presence_spec.rb#L798)
     * client_id with ASCII_8BIT
       * in connection set up
-        * [is converted into UTF_8](./spec/acceptance/realtime/presence_spec.rb#L763)
+        * [is converted into UTF_8](./spec/acceptance/realtime/presence_spec.rb#L815)
       * in channel options
-        * [is converted into UTF_8](./spec/acceptance/realtime/presence_spec.rb#L776)
+        * [is converted into UTF_8](./spec/acceptance/realtime/presence_spec.rb#L828)
     * encoding and decoding of presence message data
-      * [encrypts presence message data](./spec/acceptance/realtime/presence_spec.rb#L800)
+      * [encrypts presence message data](./spec/acceptance/realtime/presence_spec.rb#L852)
       * #subscribe
-        * [emits decrypted enter events](./spec/acceptance/realtime/presence_spec.rb#L819)
-        * [emits decrypted update events](./spec/acceptance/realtime/presence_spec.rb#L831)
-        * [emits previously set data for leave events](./spec/acceptance/realtime/presence_spec.rb#L845)
+        * [emits decrypted enter events](./spec/acceptance/realtime/presence_spec.rb#L871)
+        * [emits decrypted update events](./spec/acceptance/realtime/presence_spec.rb#L883)
+        * [emits previously set data for leave events](./spec/acceptance/realtime/presence_spec.rb#L897)
       * #get
-        * [returns a list of members with decrypted data](./spec/acceptance/realtime/presence_spec.rb#L861)
+        * [returns a list of members with decrypted data](./spec/acceptance/realtime/presence_spec.rb#L913)
       * REST #get
-        * [returns a list of members with decrypted data](./spec/acceptance/realtime/presence_spec.rb#L874)
+        * [returns a list of members with decrypted data](./spec/acceptance/realtime/presence_spec.rb#L926)
       * when cipher settings do not match publisher
-        * [delivers an unencoded presence message left with encoding value](./spec/acceptance/realtime/presence_spec.rb#L889)
-        * [emits an error when cipher does not match and presence data cannot be decoded](./spec/acceptance/realtime/presence_spec.rb#L902)
+        * [delivers an unencoded presence message left with encoding value](./spec/acceptance/realtime/presence_spec.rb#L941)
+        * [emits an error when cipher does not match and presence data cannot be decoded](./spec/acceptance/realtime/presence_spec.rb#L954)
     * leaving
-      * [expect :left event once underlying connection is closed](./spec/acceptance/realtime/presence_spec.rb#L919)
-      * [expect :left event with client data from enter event](./spec/acceptance/realtime/presence_spec.rb#L929)
+      * [expect :left event once underlying connection is closed](./spec/acceptance/realtime/presence_spec.rb#L971)
+      * [expect :left event with client data from enter event](./spec/acceptance/realtime/presence_spec.rb#L981)
 ### Ably::Realtime::Client#stats
 _(see [spec/acceptance/realtime/stats_spec.rb](./spec/acceptance/realtime/stats_spec.rb))_
@@ -498,106 +519,106 @@ _(see [spec/acceptance/realtime/time_spec.rb](./spec/acceptance/realtime/time_sp
 ### Ably::Auth
 _(see [spec/acceptance/rest/auth_spec.rb](./spec/acceptance/rest/auth_spec.rb))_
   * using JSON and MsgPack protocol
-    * [has immutable options](./spec/acceptance/rest/auth_spec.rb#L52)
+    * [has immutable options](./spec/acceptance/rest/auth_spec.rb#L54)
     * #request_token
-      * [returns the requested token](./spec/acceptance/rest/auth_spec.rb#L60)
-      * option :client_id
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L91)
-      * option :capability
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L91)
-      * option :nonce
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L91)
-      * option :timestamp
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L91)
-      * option :ttl
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L91)
+      * [returns the requested token](./spec/acceptance/rest/auth_spec.rb#L62)
+      * with option :client_id
+        * [overrides default and uses camelCase notation for all attributes](./spec/acceptance/rest/auth_spec.rb#L93)
+      * with option :capability
+        * [overrides default and uses camelCase notation for all attributes](./spec/acceptance/rest/auth_spec.rb#L93)
+      * with option :nonce
+        * [overrides default and uses camelCase notation for all attributes](./spec/acceptance/rest/auth_spec.rb#L93)
+      * with option :timestamp
+        * [overrides default and uses camelCase notation for all attributes](./spec/acceptance/rest/auth_spec.rb#L93)
+      * with option :ttl
+        * [overrides default and uses camelCase notation for all attributes](./spec/acceptance/rest/auth_spec.rb#L93)
       * with :key_id & :key_secret options
-        * [key_id is used in request and signing uses key_secret](./spec/acceptance/rest/auth_spec.rb#L120)
+        * [key_id is used in request and signing uses key_secret](./spec/acceptance/rest/auth_spec.rb#L122)
       * with :query_time option
-        * [queries the server for the time](./spec/acceptance/rest/auth_spec.rb#L128)
+        * [queries the server for the time](./spec/acceptance/rest/auth_spec.rb#L130)
       * without :query_time option
-        * [queries the server for the time](./spec/acceptance/rest/auth_spec.rb#L137)
+        * [does not query the server for the time](./spec/acceptance/rest/auth_spec.rb#L139)
       * with :auth_url option
         * when response is valid
-          * [requests a token from :auth_url using an HTTP GET request](./spec/acceptance/rest/auth_spec.rb#L184)
+          * [requests a token from :auth_url using an HTTP GET request](./spec/acceptance/rest/auth_spec.rb#L186)
           * with :query_params
-            * [requests a token from :auth_url with the :query_params](./spec/acceptance/rest/auth_spec.rb#L192)
+            * [requests a token from :auth_url with the :query_params](./spec/acceptance/rest/auth_spec.rb#L194)
           * with :headers
-            * [requests a token from :auth_url with the HTTP headers set](./spec/acceptance/rest/auth_spec.rb#L200)
+            * [requests a token from :auth_url with the HTTP headers set](./spec/acceptance/rest/auth_spec.rb#L202)
           * with POST
-            * [requests a token from :auth_url using an HTTP POST instead of the default GET](./spec/acceptance/rest/auth_spec.rb#L208)
+            * [requests a token from :auth_url using an HTTP POST instead of the default GET](./spec/acceptance/rest/auth_spec.rb#L210)
         * when response is invalid
           * 500
-            * [raises ServerError](./spec/acceptance/rest/auth_spec.rb#L221)
+            * [raises ServerError](./spec/acceptance/rest/auth_spec.rb#L223)
           * XML
-            * [raises InvalidResponseBody](./spec/acceptance/rest/auth_spec.rb#L232)
+            * [raises InvalidResponseBody](./spec/acceptance/rest/auth_spec.rb#L234)
       * with token_request_block
-        * [calls the block when authenticating to obtain the request token](./spec/acceptance/rest/auth_spec.rb#L250)
-        * [uses the token request from the block when requesting a new token](./spec/acceptance/rest/auth_spec.rb#L255)
+        * [calls the block when authenticating to obtain the request token](./spec/acceptance/rest/auth_spec.rb#L252)
+        * [uses the token request from the block when requesting a new token](./spec/acceptance/rest/auth_spec.rb#L257)
     * before #authorise has been called
-      * [has no current_token](./spec/acceptance/rest/auth_spec.rb#L262)
+      * [has no current_token](./spec/acceptance/rest/auth_spec.rb#L264)
     * #authorise
-      * [updates the persisted auth options thare are then used for subsequent authorise requests](./spec/acceptance/rest/auth_spec.rb#L309)
+      * [updates the persisted auth options thare are then used for subsequent authorise requests](./spec/acceptance/rest/auth_spec.rb#L311)
       * when called for the first time since the client has been instantiated
-        * [passes all options to #request_token](./spec/acceptance/rest/auth_spec.rb#L273)
-        * [returns a valid token](./spec/acceptance/rest/auth_spec.rb#L278)
-        * [issues a new token if option :force => true](./spec/acceptance/rest/auth_spec.rb#L282)
+        * [passes all options to #request_token](./spec/acceptance/rest/auth_spec.rb#L275)
+        * [returns a valid token](./spec/acceptance/rest/auth_spec.rb#L280)
+        * [issues a new token if option :force => true](./spec/acceptance/rest/auth_spec.rb#L284)
       * with previous authorisation
-        * [does not request a token if current_token has not expired](./spec/acceptance/rest/auth_spec.rb#L293)
-        * [requests a new token if token is expired](./spec/acceptance/rest/auth_spec.rb#L298)
-        * [issues a new token if option :force => true](./spec/acceptance/rest/auth_spec.rb#L304)
+        * [does not request a token if current_token has not expired](./spec/acceptance/rest/auth_spec.rb#L295)
+        * [requests a new token if token is expired](./spec/acceptance/rest/auth_spec.rb#L300)
+        * [issues a new token if option :force => true](./spec/acceptance/rest/auth_spec.rb#L306)
       * with token_request_block
-        * [calls the block](./spec/acceptance/rest/auth_spec.rb#L325)
-        * [uses the token request returned from the block when requesting a new token](./spec/acceptance/rest/auth_spec.rb#L329)
+        * [calls the block](./spec/acceptance/rest/auth_spec.rb#L327)
+        * [uses the token request returned from the block when requesting a new token](./spec/acceptance/rest/auth_spec.rb#L331)
         * for every subsequent #request_token
           * without a provided block
-            * [calls the originally provided block](./spec/acceptance/rest/auth_spec.rb#L335)
+            * [calls the originally provided block](./spec/acceptance/rest/auth_spec.rb#L337)
           * with a provided block
-            * [does not call the originally provided block and calls the new #request_token block](./spec/acceptance/rest/auth_spec.rb#L342)
+            * [does not call the originally provided block and calls the new #request_token block](./spec/acceptance/rest/auth_spec.rb#L344)
     * #create_token_request
-      * [uses the key ID from the client](./spec/acceptance/rest/auth_spec.rb#L358)
-      * [uses the default TTL](./spec/acceptance/rest/auth_spec.rb#L362)
-      * [uses the default capability](./spec/acceptance/rest/auth_spec.rb#L366)
+      * [uses the key ID from the client](./spec/acceptance/rest/auth_spec.rb#L360)
+      * [uses the default TTL](./spec/acceptance/rest/auth_spec.rb#L364)
+      * [uses the default capability](./spec/acceptance/rest/auth_spec.rb#L368)
       * the nonce
-        * [is unique for every request](./spec/acceptance/rest/auth_spec.rb#L371)
-        * [is at least 16 characters](./spec/acceptance/rest/auth_spec.rb#L376)
+        * [is unique for every request](./spec/acceptance/rest/auth_spec.rb#L373)
+        * [is at least 16 characters](./spec/acceptance/rest/auth_spec.rb#L378)
       * with option :ttl
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L387)
+        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L389)
       * with option :capability
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L387)
+        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L389)
       * with option :nonce
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L387)
+        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L389)
       * with option :timestamp
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L387)
+        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L389)
       * with option :client_id
-        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L387)
+        * [overrides default](./spec/acceptance/rest/auth_spec.rb#L389)
       * with additional invalid attributes
-        * [are ignored](./spec/acceptance/rest/auth_spec.rb#L395)
+        * [are ignored](./spec/acceptance/rest/auth_spec.rb#L397)
       * when required fields are missing
-        * [should raise an exception if key secret is missing](./spec/acceptance/rest/auth_spec.rb#L405)
-        * [should raise an exception if key id is missing](./spec/acceptance/rest/auth_spec.rb#L409)
+        * [should raise an exception if key secret is missing](./spec/acceptance/rest/auth_spec.rb#L408)
+        * [should raise an exception if key id is missing](./spec/acceptance/rest/auth_spec.rb#L412)
       * with :query_time option
-        * [queries the server for the timestamp](./spec/acceptance/rest/auth_spec.rb#L418)
+        * [queries the server for the timestamp](./spec/acceptance/rest/auth_spec.rb#L421)
       * with :timestamp option
-        * [uses the provided timestamp in the token request](./spec/acceptance/rest/auth_spec.rb#L428)
+        * [uses the provided timestamp in the token request](./spec/acceptance/rest/auth_spec.rb#L431)
       * signing
-        * [generates a valid HMAC](./spec/acceptance/rest/auth_spec.rb#L445)
+        * [generates a valid HMAC](./spec/acceptance/rest/auth_spec.rb#L448)
     * using token authentication
       * with :token_id option
-        * [authenticates successfully using the provided :token_id](./spec/acceptance/rest/auth_spec.rb#L468)
-        * [disallows publishing on unspecified capability channels](./spec/acceptance/rest/auth_spec.rb#L472)
-        * [fails if timestamp is invalid](./spec/acceptance/rest/auth_spec.rb#L480)
-        * [cannot be renewed automatically](./spec/acceptance/rest/auth_spec.rb#L488)
+        * [authenticates successfully using the provided :token_id](./spec/acceptance/rest/auth_spec.rb#L471)
+        * [disallows publishing on unspecified capability channels](./spec/acceptance/rest/auth_spec.rb#L475)
+        * [fails if timestamp is invalid](./spec/acceptance/rest/auth_spec.rb#L483)
+        * [cannot be renewed automatically](./spec/acceptance/rest/auth_spec.rb#L491)
       * when implicit as a result of using :client id
         * and requests to the Ably server are mocked
-          * [will send a token request to the server](./spec/acceptance/rest/auth_spec.rb#L518)
+          * [will send a token request to the server](./spec/acceptance/rest/auth_spec.rb#L521)
         * a token is created
-          * [before a request is made](./spec/acceptance/rest/auth_spec.rb#L527)
-          * [when a message is published](./spec/acceptance/rest/auth_spec.rb#L531)
-          * [with capability and TTL defaults](./spec/acceptance/rest/auth_spec.rb#L535)
+          * [before a request is made](./spec/acceptance/rest/auth_spec.rb#L530)
+          * [when a message is published](./spec/acceptance/rest/auth_spec.rb#L534)
+          * [with capability and TTL defaults](./spec/acceptance/rest/auth_spec.rb#L538)
     * when using an :api_key and basic auth
-      * [#using_token_auth? is false](./spec/acceptance/rest/auth_spec.rb#L550)
-      * [#using_basic_auth? is true](./spec/acceptance/rest/auth_spec.rb#L554)
+      * [#using_token_auth? is false](./spec/acceptance/rest/auth_spec.rb#L553)
+      * [#using_basic_auth? is true](./spec/acceptance/rest/auth_spec.rb#L557)
 ### Ably::Rest
 _(see [spec/acceptance/rest/base_spec.rb](./spec/acceptance/rest/base_spec.rb))_
@@ -809,37 +830,37 @@ _(see [spec/acceptance/rest/presence_spec.rb](./spec/acceptance/rest/presence_sp
         * with :limit option
           * [returns a paged response limiting number of members per page](./spec/acceptance/rest/presence_spec.rb#L45)
       * #history
-        * [returns recent presence activity](./spec/acceptance/rest/presence_spec.rb#L58)
+        * [returns recent presence activity](./spec/acceptance/rest/presence_spec.rb#L64)
         * with options
           * direction: :forwards
-            * [returns recent presence activity forwards with most recent history last](./spec/acceptance/rest/presence_spec.rb#L74)
+            * [returns recent presence activity forwards with most recent history last](./spec/acceptance/rest/presence_spec.rb#L80)
           * direction: :backwards
-            * [returns recent presence activity backwards with most recent history first](./spec/acceptance/rest/presence_spec.rb#L89)
+            * [returns recent presence activity backwards with most recent history first](./spec/acceptance/rest/presence_spec.rb#L95)
     * #history
       * with time range options
         * :start
           * with milliseconds since epoch value
-            * [uses this value in the history request](./spec/acceptance/rest/presence_spec.rb#L134)
+            * [uses this value in the history request](./spec/acceptance/rest/presence_spec.rb#L140)
           * with Time object value
-            * [converts the value to milliseconds since epoch in the hisotry request](./spec/acceptance/rest/presence_spec.rb#L144)
+            * [converts the value to milliseconds since epoch in the hisotry request](./spec/acceptance/rest/presence_spec.rb#L150)
         * :end
           * with milliseconds since epoch value
-            * [uses this value in the history request](./spec/acceptance/rest/presence_spec.rb#L134)
+            * [uses this value in the history request](./spec/acceptance/rest/presence_spec.rb#L140)
           * with Time object value
-            * [converts the value to milliseconds since epoch in the hisotry request](./spec/acceptance/rest/presence_spec.rb#L144)
+            * [converts the value to milliseconds since epoch in the hisotry request](./spec/acceptance/rest/presence_spec.rb#L150)
     * decoding
       * valid decodeable content
         * #get
-          * [automaticaly decodes presence messages](./spec/acceptance/rest/presence_spec.rb#L202)
+          * [automaticaly decodes presence messages](./spec/acceptance/rest/presence_spec.rb#L208)
         * #history
-          * [automaticaly decodes presence messages](./spec/acceptance/rest/presence_spec.rb#L219)
+          * [automaticaly decodes presence messages](./spec/acceptance/rest/presence_spec.rb#L225)
       * invalid data
         * #get
-          * [returns the messages still encoded](./spec/acceptance/rest/presence_spec.rb#L250)
-          * [logs a cipher error](./spec/acceptance/rest/presence_spec.rb#L254)
+          * [returns the messages still encoded](./spec/acceptance/rest/presence_spec.rb#L256)
+          * [logs a cipher error](./spec/acceptance/rest/presence_spec.rb#L260)
         * #history
-          * [returns the messages still encoded](./spec/acceptance/rest/presence_spec.rb#L274)
-          * [logs a cipher error](./spec/acceptance/rest/presence_spec.rb#L278)
+          * [returns the messages still encoded](./spec/acceptance/rest/presence_spec.rb#L280)
+          * [logs a cipher error](./spec/acceptance/rest/presence_spec.rb#L284)
 ### Ably::Rest::Client#stats
 _(see [spec/acceptance/rest/stats_spec.rb](./spec/acceptance/rest/stats_spec.rb))_
@@ -1135,29 +1156,32 @@ _(see [spec/unit/models/paginated_resource_spec.rb](./spec/unit/models/paginated
   * [supports alias methods for length](./spec/unit/models/paginated_resource_spec.rb#L34)
   * [is Enumerable](./spec/unit/models/paginated_resource_spec.rb#L39)
   * [is iterable](./spec/unit/models/paginated_resource_spec.rb#L43)
-  * [provides [] accessor method](./spec/unit/models/paginated_resource_spec.rb#L47)
-  * [#first gets the first item in page](./spec/unit/models/paginated_resource_spec.rb#L53)
-  * [#last gets the last item in page](./spec/unit/models/paginated_resource_spec.rb#L57)
+  * [provides [] accessor method](./spec/unit/models/paginated_resource_spec.rb#L61)
+  * [#first gets the first item in page](./spec/unit/models/paginated_resource_spec.rb#L67)
+  * [#last gets the last item in page](./spec/unit/models/paginated_resource_spec.rb#L71)
+  * #each
+    * [returns an enumerator](./spec/unit/models/paginated_resource_spec.rb#L48)
+    * [yields each item](./spec/unit/models/paginated_resource_spec.rb#L52)
   * with non paged http response
-    * [is the first page](./spec/unit/models/paginated_resource_spec.rb#L161)
-    * [is the last page](./spec/unit/models/paginated_resource_spec.rb#L165)
-    * [does not support pagination](./spec/unit/models/paginated_resource_spec.rb#L169)
-    * [raises an exception when accessing next page](./spec/unit/models/paginated_resource_spec.rb#L173)
-    * [raises an exception when accessing first page](./spec/unit/models/paginated_resource_spec.rb#L177)
+    * [is the first page](./spec/unit/models/paginated_resource_spec.rb#L175)
+    * [is the last page](./spec/unit/models/paginated_resource_spec.rb#L179)
+    * [does not support pagination](./spec/unit/models/paginated_resource_spec.rb#L183)
+    * [raises an exception when accessing next page](./spec/unit/models/paginated_resource_spec.rb#L187)
+    * [raises an exception when accessing first page](./spec/unit/models/paginated_resource_spec.rb#L191)
   * with paged http response
-    * [is the first page](./spec/unit/models/paginated_resource_spec.rb#L195)
-    * [is not the last page](./spec/unit/models/paginated_resource_spec.rb#L199)
-    * [supports pagination](./spec/unit/models/paginated_resource_spec.rb#L203)
+    * [is the first page](./spec/unit/models/paginated_resource_spec.rb#L209)
+    * [is not the last page](./spec/unit/models/paginated_resource_spec.rb#L213)
+    * [supports pagination](./spec/unit/models/paginated_resource_spec.rb#L217)
     * accessing next page
-      * [returns another PaginatedResource](./spec/unit/models/paginated_resource_spec.rb#L231)
-      * [retrieves the next page of results](./spec/unit/models/paginated_resource_spec.rb#L235)
-      * [is not the first page](./spec/unit/models/paginated_resource_spec.rb#L240)
-      * [is the last page](./spec/unit/models/paginated_resource_spec.rb#L244)
-      * [raises an exception if trying to access the last page when it is the last page](./spec/unit/models/paginated_resource_spec.rb#L248)
+      * [returns another PaginatedResource](./spec/unit/models/paginated_resource_spec.rb#L245)
+      * [retrieves the next page of results](./spec/unit/models/paginated_resource_spec.rb#L249)
+      * [is not the first page](./spec/unit/models/paginated_resource_spec.rb#L254)
+      * [is the last page](./spec/unit/models/paginated_resource_spec.rb#L258)
+      * [raises an exception if trying to access the last page when it is the last page](./spec/unit/models/paginated_resource_spec.rb#L262)
       * and then first page
-        * [returns a PaginatedResource](./spec/unit/models/paginated_resource_spec.rb#L259)
-        * [retrieves the first page of results](./spec/unit/models/paginated_resource_spec.rb#L263)
-        * [is the first page](./spec/unit/models/paginated_resource_spec.rb#L267)
+        * [returns a PaginatedResource](./spec/unit/models/paginated_resource_spec.rb#L273)
+        * [retrieves the first page of results](./spec/unit/models/paginated_resource_spec.rb#L277)
+        * [is the first page](./spec/unit/models/paginated_resource_spec.rb#L281)
 ### Ably::Models::PresenceMessage
 _(see [spec/unit/models/presence_message_spec.rb](./spec/unit/models/presence_message_spec.rb))_
@@ -1444,6 +1468,12 @@ _(see [spec/unit/realtime/channels_spec.rb](./spec/unit/realtime/channels_spec.r
     * [calls the block if channel is missing](./spec/unit/realtime/channels_spec.rb#L36)
   * destroying channels
     * [#release detatches and then releases the channel resoures](./spec/unit/realtime/channels_spec.rb#L44)
+  * is Enumerable
+    * [allows enumeration](./spec/unit/realtime/channels_spec.rb#L61)
+    * [provides #length](./spec/unit/realtime/channels_spec.rb#L77)
+    * #each
+      * [returns an enumerator](./spec/unit/realtime/channels_spec.rb#L66)
+      * [yields each channel](./spec/unit/realtime/channels_spec.rb#L70)
 ### Ably::Realtime::Client
 _(see [spec/unit/realtime/client_spec.rb](./spec/unit/realtime/client_spec.rb))_
@@ -1567,6 +1597,12 @@ _(see [spec/unit/rest/channels_spec.rb](./spec/unit/rest/channels_spec.rb))_
     * [calls the block if channel is missing](./spec/unit/rest/channels_spec.rb#L35)
   * destroying channels
     * [#release releases the channel resoures](./spec/unit/rest/channels_spec.rb#L43)
+  * is Enumerable
+    * [allows enumeration](./spec/unit/rest/channels_spec.rb#L59)
+    * [provides #length](./spec/unit/rest/channels_spec.rb#L75)
+    * #each
+      * [returns an enumerator](./spec/unit/rest/channels_spec.rb#L64)
+      * [yields each channel](./spec/unit/rest/channels_spec.rb#L68)
 ### Ably::Rest::Client
 _(see [spec/unit/rest/client_spec.rb](./spec/unit/rest/client_spec.rb))_
@@ -1671,6 +1707,6 @@ _(see [spec/unit/util/pub_sub_spec.rb](./spec/unit/util/pub_sub_spec.rb))_
 ## Test summary
-* Passing tests: 786
-* Pending tests: 12
-* Failing tests: 2
+* Passing tests: 811
+* Pending tests: 11
+* Failing tests: 0