opentok 4.1.0 → 4.5.1

data/spec/cassettes/OpenTok_Sip/_play_dtmf_to_session/returns_a_200_response_code_when_passed_a_valid_dtmf_digit_string.yml

@@ -0,0 +1,39 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.opentok.com/v2/project/123456/session/SESSIONID/play-dtmf
+    body:
+      encoding: UTF-8
+      string: '{"digits":"0123456789*#p"}'
+    headers:
+      User-Agent:
+      - OpenTok-Ruby-SDK/<%= version %>
+      X-Opentok-Auth:
+      - eyJpc3QiOiJwcm9qZWN0IiwiYWxnIjoiSFMyNTYifQ.eyJpc3MiOiIxMjM0NTYiLCJpYXQiOjE0OTI1MTA2NjAsImV4cCI6MTQ5MjUxMDk2MH0.BplMVhJWx4ld7KLKXqEmow6MjNPPFw9W8IHCMfeb120
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Mon, 01 Nov 2021 12:35:08 GMT
+      Content-Type:
+      - application/xml
+      Content-Length:
+      - '177'
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: ""
+  recorded_at: Tue, 18 Apr 2017 10:17:40 GMT
+recorded_with: VCR 6.0.0

data/spec/cassettes/OpenTok_Sip/receives_a_valid_response.yml

@@ -5,7 +5,7 @@ http_interactions:
     uri: https://api.opentok.com/v2/project/123456/dial
     body:
       encoding: UTF-8
-      string: '{"sessionId":"SESSIONID","token":"TOKENID","sip":{"uri":"sip:+15128675309@acme.pstn.example.com;transport=tls","auth":{"username":"bob","password":"abc123"},"secure":"true"}}'
+      string: '{"sessionId":"SESSIONID","token":"TOKENID","sip":{"uri":"sip:+15128675309@acme.pstn.example.com;transport=tls","auth":{"username":"bob","password":"abc123"},"secure":"true","video":"true","observeForceMute":"true"}}'
     headers:
       User-Agent:
       - OpenTok-Ruby-SDK/<%= version %>
@@ -35,6 +35,6 @@ http_interactions:
     body:
       encoding: UTF-8
       string: '{"id":"2299ba24-a6de-417c-88f7-28da54a441cf","projectId":"123456","sessionId":"SESSIONID","connectionId":"833a7182-61a5-49d4-baae-c324b09953af","streamId":"b1963d15-537f-459a-be89-e00fc310b82b","createdAt":1492468803946,"updatedAt":1492468803946}'
-    http_version: 
+    http_version:
   recorded_at: Mon, 17 Apr 2017 22:40:01 GMT
 recorded_with: VCR 2.8.0

data/spec/cassettes/OpenTok_Streams/disables_the_mute_state_of_a_session.yml

@@ -0,0 +1,37 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.opentok.com/v2/project/123456/session/SESSIONID/mute
+    body:
+      encoding: UTF-8
+      string: '{"active":"false"}'
+    headers:
+      User-Agent:
+      - OpenTok-Ruby-SDK/<%= version %>
+      X-Opentok-Auth:
+      - eyJpc3QiOiJwcm9qZWN0IiwiYWxnIjoiSFMyNTYifQ.eyJpc3MiOiIxMjM0NTYiLCJpYXQiOjE0OTI1MTA2NjAsImV4cCI6MTQ5MjUxMDk2MH0.BplMVhJWx4ld7KLKXqEmow6MjNPPFw9W8IHCMfeb120
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Thu, 13 Jan 2022 15:37:24 GMT
+      Content-Length:
+      - '0'
+      Connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: ''
+  recorded_at: Tue, 18 Apr 2017 10:17:40 GMT
+recorded_with: VCR 6.0.0

data/spec/cassettes/OpenTok_Streams/forces_all_current_and_future_streams_in_a_session_to_be_muted.yml

@@ -0,0 +1,39 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.opentok.com/v2/project/123456/session/SESSIONID/mute
+    body:
+      encoding: UTF-8
+      string: '{"active":"true"}'
+    headers:
+      User-Agent:
+      - OpenTok-Ruby-SDK/<%= version %>
+      X-Opentok-Auth:
+      - eyJpc3QiOiJwcm9qZWN0IiwiYWxnIjoiSFMyNTYifQ.eyJpc3MiOiIxMjM0NTYiLCJpYXQiOjE0OTI1MTA2NjAsImV4cCI6MTQ5MjUxMDk2MH0.BplMVhJWx4ld7KLKXqEmow6MjNPPFw9W8IHCMfeb120
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Fri, 29 Oct 2021 11:48:19 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '0'
+      Connection:
+      - close
+    body:
+      encoding: UTF-8
+      string: ''
+  recorded_at: Tue, 18 Apr 2017 10:17:40 GMT
+recorded_with: VCR 6.0.0

data/spec/cassettes/OpenTok_Streams/forces_all_current_and_future_streams_in_a_session_to_be_muted_except_specified_excluded_streams.yml

@@ -0,0 +1,39 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.opentok.com/v2/project/123456/session/SESSIONID/mute
+    body:
+      encoding: UTF-8
+      string: '{"excludedStreams":["b1963d15-537f-459a-be89-e00fc310b82b"],"active":"true"}'
+    headers:
+      User-Agent:
+      - OpenTok-Ruby-SDK/<%= version %>
+      X-Opentok-Auth:
+      - eyJpc3QiOiJwcm9qZWN0IiwiYWxnIjoiSFMyNTYifQ.eyJpc3MiOiIxMjM0NTYiLCJpYXQiOjE0OTI1MTA2NjAsImV4cCI6MTQ5MjUxMDk2MH0.BplMVhJWx4ld7KLKXqEmow6MjNPPFw9W8IHCMfeb120
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Fri, 29 Oct 2021 12:01:42 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '0'
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: ''
+  recorded_at: Tue, 18 Apr 2017 10:17:40 GMT
+recorded_with: VCR 6.0.0

data/spec/cassettes/OpenTok_Streams/forces_the_specified_stream_to_be_muted.yml

@@ -0,0 +1,39 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://api.opentok.com/v2/project/123456/session/SESSIONID/stream/STREAMID/mute
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      User-Agent:
+      - OpenTok-Ruby-SDK/<%= version %>
+      X-Opentok-Auth:
+      - eyJpc3QiOiJwcm9qZWN0IiwiYWxnIjoiSFMyNTYifQ.eyJpc3MiOiIxMjM0NTYiLCJpYXQiOjE0OTI1MTA2NjAsImV4cCI6MTQ5MjUxMDk2MH0.BplMVhJWx4ld7KLKXqEmow6MjNPPFw9W8IHCMfeb120
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Fri, 29 Oct 2021 11:01:54 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '0'
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: ''
+  recorded_at: Tue, 18 Apr 2017 10:17:40 GMT
+recorded_with: VCR 6.0.0

data/spec/opentok/archives_spec.rb

@@ -42,6 +42,27 @@ describe OpenTok::Archives do
     expect(archive.name).to eq archive_name
   end
 
+  it "should create an archives with a specified multiArchiveTag", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    archive_tag = 'archive-1'
+    archive = archives.create session_id, :multiArchiveTag => archive_tag
+    expect(archive).to be_an_instance_of OpenTok::Archive
+    expect(archive.session_id).to eq session_id
+    expect(archive.multiArchiveTag).to eq archive_tag
+  end
+
+  it "should create an archive with matching multi_archive_tag when multiArchiveTag is specified", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    archive_tag = 'archive-1'
+    archive = archives.create session_id, :multiArchiveTag => archive_tag
+    expect(archive).to be_an_instance_of OpenTok::Archive
+    expect(archive.multi_archive_tag).to eq archive_tag
+  end
+
+  it "should create an archive with multi_archive_tag value of nil when multiArchiveTag not specified", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    archive = archives.create session_id
+    expect(archive).to be_an_instance_of OpenTok::Archive
+    expect(archive.multi_archive_tag).to be_nil
+  end
+
   it "should create audio only archives", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
     archive = archives.create session_id, :has_video => false
     expect(archive).to be_an_instance_of OpenTok::Archive
@@ -67,6 +88,16 @@ describe OpenTok::Archives do
     expect(archive.session_id).to eq session_id
   end
 
+  it "should create layout archives with screenshare layout types", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
+    screenshare_layout = {
+      :type => "bestFit",
+      :screenshare_type => "verticalPresentation"
+    }
+    archive = archives.create session_id, :layout => screenshare_layout
+    expect(archive).to be_an_instance_of OpenTok::Archive
+    expect(archive.session_id).to eq session_id
+  end
+
   it "should stop archives", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
     archive = archives.stop_by_id started_archive_id
     expect(archive).to be_an_instance_of OpenTok::Archive
@@ -159,6 +190,25 @@ describe OpenTok::Archives do
       })
     }.to raise_error(ArgumentError)
   end
+
+  it "raise an error if invalid layout type with screenshare_type" do
+    expect {
+      archives.layout(started_archive_id, {
+          type: "pip",
+          screenshare_type: "bestFit"
+      })
+    }.to raise_error(ArgumentError)
+  end
+
+  it "raise an error if invalid layout screenshare_type" do
+    expect {
+      archives.layout(started_archive_id, {
+          type: "bestFit",
+          screenshare_type: "pip1"
+      })
+    }.to raise_error(ArgumentError)
+  end
+
   it "calls layout on archive object", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
     archive = archives.find findable_archive_id
     expect(archive).to be_an_instance_of OpenTok::Archive
@@ -230,4 +280,15 @@ describe OpenTok::Archives do
     it { should raise_error(OpenTok::OpenTokError) }
   end
 
+  it "adds a stream to an archive", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
+    opts = {}
+    response = archives.add_stream(started_archive_id, '12312312-3811-4726-b508-e41a0f96c68f', opts)
+    expect(response.code).to eq(204)
+  end
+
+  it "removes a stream from an archive", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
+    response = archives.remove_stream(started_archive_id, '12312312-3811-4726-b508-e41a0f96c68f')
+    expect(response.code).to eq(204)
+  end
+
 end

data/spec/opentok/broadcasts_spec.rb

@@ -45,6 +45,22 @@ describe OpenTok::Broadcasts do
       broadcast.create(nil, {})
     }.to raise_error(ArgumentError)
   end
+  it 'raises an error if outputs is not set in options' do
+    opts = { maxDuration: 5400 }
+    expect { broadcast.create(nil, opts) }.to raise_error(ArgumentError)
+  end
+  it 'raises an error if outputs is set in options but is not a Hash' do
+    opts = { outputs: [] }
+    expect { broadcast.create(nil, opts) }.to raise_error(ArgumentError)
+  end
+  it 'raises an error if an HLS Broadcast object has both dvr and low_latency options set to true' do
+    opts = {
+      outputs: {
+        hls: { dvr: true, low_latency: true}
+      }
+    }
+    expect { broadcast.create(nil, opts) }.to raise_error(ArgumentError)
+  end
   it 'fetches a hls broadcast url', :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
     opts = {
         :outputs => {
@@ -77,6 +93,44 @@ describe OpenTok::Broadcasts do
     expect(b_rtmp.broadcastUrls["rtmp"].count).to eq 1
   end
 
+  it 'starts a broadcast with a specified multiBroadcastTag', :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    broadcast_tag = 'broadcast-1'
+    opts = {
+        :outputs => {
+            :hls => {}
+        },
+        :multiBroadcastTag => broadcast_tag
+    }
+    broadcast_1 = broadcast.create(session_id, opts)
+    expect(broadcast_1).to be_an_instance_of OpenTok::Broadcast
+    expect(broadcast_1.id).to eq broadcast_id
+    expect(broadcast_1.multiBroadcastTag).to eq broadcast_tag
+  end
+
+  it 'starts a broadcast with a matching multi_broadcast_tag value when multiBroadcastTag is specified', :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    broadcast_tag = 'broadcast-1'
+    opts = {
+        :outputs => {
+            :hls => {}
+        },
+        :multiBroadcastTag => broadcast_tag
+    }
+    broadcast_1 = broadcast.create(session_id, opts)
+    expect(broadcast_1).to be_an_instance_of OpenTok::Broadcast
+    expect(broadcast_1.multi_broadcast_tag).to eq broadcast_tag
+  end
+
+  it 'starts a broadcast with a multi_broadcast_tag value of nil when multiBroadcastTag not specified', :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    opts = {
+        :outputs => {
+            :hls => {}
+        }
+    }
+    broadcast_1 = broadcast.create(session_id, opts)
+    expect(broadcast_1).to be_an_instance_of OpenTok::Broadcast
+    expect(broadcast_1.multi_broadcast_tag).to be_nil
+  end
+
   it 'finds a broadcast', :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
     b = broadcast.find started_broadcast_id
     expect(b).to be_an_instance_of OpenTok::Broadcast
@@ -144,6 +198,27 @@ describe OpenTok::Broadcasts do
     }.to raise_error(ArgumentError)
   end
 
+  it "raise an error for non valid type" do
+    expect {
+      broadcast.layout(started_broadcast_id, {
+          type: "not-valid",
+          stylesheet: "stream {}"
+      })
+    }.to raise_error(ArgumentError)
+  end
+
+  it "change the layout to custom type with custom stylesheet" do
+    stub_request(:put, "https://api.opentok.com/v2/project/#{api_key}/broadcast/#{started_broadcast_id}/layout").
+      with(body: {type: 'custom', stylesheet: 'stream {float: left; height: 100%; width: 33.33%;}'}).
+      to_return(status: 200)
+
+    response  = broadcast.layout(started_broadcast_id, {
+        type: "custom",
+        stylesheet: "stream {float: left; height: 100%; width: 33.33%;}"
+    })
+    expect(response).not_to be_nil
+  end
+
   it "raise an error if invalid layout type" do
     expect {
       broadcast.layout(started_broadcast_id, {
@@ -151,6 +226,25 @@ describe OpenTok::Broadcasts do
       })
     }.to raise_error(ArgumentError)
   end
+
+  it "raise an error if invalid layout type with screenshare_type" do
+    expect {
+      broadcast.layout(started_broadcast_id, {
+          type: "pip",
+          screenshare_type: "bestFit"
+      })
+    }.to raise_error(ArgumentError)
+  end
+
+  it "raise an error if invalid layout screenshare_type" do
+    expect {
+      broadcast.layout(started_broadcast_id, {
+          type: "bestFit",
+          screenshare_type: "pip1"
+      })
+    }.to raise_error(ArgumentError)
+  end
+
   it "calls layout on broadcast object", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
     b = broadcast.find started_broadcast_id
     expect(b).to be_an_instance_of OpenTok::Broadcast
@@ -161,11 +255,73 @@ describe OpenTok::Broadcasts do
           )
     }.to raise_error(ArgumentError)
   end
+
   it "changes the layout of a broadcast", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
+    stub_request(:put, "https://api.opentok.com/v2/project/#{api_key}/broadcast/#{started_broadcast_id}/layout").
+      to_return(status: 200)
+
     response = broadcast.layout(started_broadcast_id, {
         :type => "verticalPresentation"
     })
     expect(response).not_to be_nil
   end
 
-end
+  it "changes the screenshare option in the layout of a broadcast", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
+    stub_request(:put, "https://api.opentok.com/v2/project/#{api_key}/broadcast/#{started_broadcast_id}/layout").
+      to_return(status: 200)
+
+    response = broadcast.layout(started_broadcast_id, {
+        :type => "bestFit",
+        :screenshare_type => "bestFit"
+    })
+    expect(response).not_to be_nil
+  end
+
+  it "adds a stream to a broadcast", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
+    opts = {}
+    response = broadcast.add_stream(started_broadcast_id, '12312312-3811-4726-b508-e41a0f96c68f', opts)
+    expect(response.code).to eq(204)
+  end
+
+  it "removes a stream from a broadcast", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}" } } do
+    response = broadcast.remove_stream(started_broadcast_id, '12312312-3811-4726-b508-e41a0f96c68f')
+    expect(response.code).to eq(204)
+  end
+
+  context "for many broadcasts" do
+    it "should return all broadcasts", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+      broadcast_list = broadcast.all
+      expect(broadcast_list).to be_an_instance_of OpenTok::BroadcastList
+      expect(broadcast_list.total).to eq 6
+      expect(broadcast_list.count).to eq 6
+    end
+
+    it "should return broadcasts with an offset", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+      broadcast_list = broadcast.all :offset => 3
+      expect(broadcast_list).to be_an_instance_of OpenTok::BroadcastList
+      expect(broadcast_list.total).to eq 3
+      expect(broadcast_list.count).to eq 3
+    end
+
+    it "should return count number of broadcasts", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+      broadcast_list = broadcast.all :count => 2
+      expect(broadcast_list).to be_an_instance_of OpenTok::BroadcastList
+      expect(broadcast_list.count).to eq 2
+      expect(broadcast_list.count).to eq 2
+    end
+
+    it "should return part of the broadcasts when using offset and count", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+      broadcast_list = broadcast.all :count => 4, :offset => 2
+      expect(broadcast_list).to be_an_instance_of OpenTok::BroadcastList
+      expect(broadcast_list.count).to eq 4
+      expect(broadcast_list.count).to eq 4
+    end
+
+    it "should return session broadcasts", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+      broadcast_list = broadcast.all :sessionId => session_id
+      expect(broadcast_list).to be_an_instance_of OpenTok::BroadcastList
+      expect(broadcast_list.total).to eq 3
+      expect(broadcast_list.count).to eq 3
+    end
+  end
+end

data/spec/opentok/connection_spec.rb

@@ -35,4 +35,4 @@ describe OpenTok::Connections do
     response = connection.forceDisconnect(session_id, connection_id)
     expect(response).not_to be_nil
   end
-end
+end

data/spec/opentok/opentok_spec.rb

@@ -152,6 +152,12 @@ describe OpenTok::OpenTok do
       it "should have an timeout_length property" do
         expect(opentok.timeout_length).to eq timeout_length
       end
+
+      it "should send the custom timeout_length to new instances of OpenTok::Client" do
+        streams = opentok.streams
+
+        expect(streams.instance_variable_get(:@client).timeout_length).to eq timeout_length
+      end
     end
 
     context "with an addendum to the user agent string" do

data/spec/opentok/renders_spec.rb

@@ -0,0 +1,142 @@
+require "opentok/render"
+require "opentok/renders"
+require "opentok/opentok"
+require "opentok/version"
+require "spec_helper"
+
+describe OpenTok::Renders do
+  before(:each) do
+    now = Time.parse("2017-04-18 20:17:40 +1000")
+    allow(Time).to receive(:now) { now }
+  end
+
+  let(:api_key) { "123456" }
+  let(:api_secret) { "1234567890abcdef1234567890abcdef1234567890" }
+  let(:session_id) { "SESSIONID" }
+  let(:render_id) { "80abaf0d-25a3-4efc-968f-6268d620668d" }
+  let(:opentok) { OpenTok::OpenTok.new api_key, api_secret }
+  let(:token) { "TOKEN" }
+  let(:render) { opentok.renders }
+  let(:render_url) { 'https://example.com/my-render'}
+
+  subject { render }
+
+  it 'raises an error on empty sessionId' do
+    opts = {
+        :token => token,
+        :url => render_url
+    }
+    expect {
+      render.start('', opts)
+    }.to raise_error(ArgumentError)
+  end
+
+  it 'raises an error on nil sessionId' do
+    opts = {
+      :token => token,
+      :url => render_url
+    }
+    expect {
+      render.start(nil, opts)
+    }.to raise_error(ArgumentError)
+  end
+
+  it 'raises an error on empty options' do
+    expect {
+      render.start(session_id, {})
+    }.to raise_error(ArgumentError)
+  end
+
+  it 'raises an error if token is not set in options' do
+    opts = { :url => render_url }
+    expect { render.start(session_id, opts) }.to raise_error(ArgumentError)
+  end
+  
+  it 'raises an error if url is not set in options' do
+    opts = { :token => token }
+    expect { render.start(session_id, opts) }.to raise_error(ArgumentError)
+  end
+
+  it 'starts an Experience Composer render', :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    opts = {
+      :token => token,
+      :url => render_url
+    }
+    r = render.start(session_id, opts)
+    expect(r).to be_an_instance_of OpenTok::Render
+    expect(r.sessionId).to eq session_id
+    expect(r.url).to eq render_url
+    expect(r.status).to eq "starting"
+  end
+
+  it 'raises an error on empty renderId in find' do
+    expect {
+      render.find("")
+    }.to raise_error(ArgumentError)
+  end
+
+  it 'raises an error on nil renderId in find' do
+    expect {
+      render.find(nil)
+    }.to raise_error(ArgumentError)
+  end
+
+  it 'finds an Experience Composer render', :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    r = render.find render_id
+    expect(r).to be_an_instance_of OpenTok::Render
+    expect(r.id).to eq render_id
+  end
+
+  it 'raises an error on empty renderId in stop' do
+    expect {
+      render.stop("")
+    }.to raise_error(ArgumentError)
+  end
+
+  it 'raises an error on nil renderId in stop' do
+    expect {
+      render.stop(nil)
+    }.to raise_error(ArgumentError)
+  end
+
+  it 'stops an Experience Composer render', :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+    r = render.stop(render_id)
+    expect(r).to be_an_instance_of OpenTok::Render
+  end
+
+  context "for many renders" do
+    it 'raises an error for an invalid limit in list' do
+      expect {
+        render.list(count: 1001)
+      }.to raise_error(ArgumentError)
+    end
+
+    it "should return all renders", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+      render_list = render.list
+      expect(render_list).to be_an_instance_of OpenTok::RenderList
+      expect(render_list.count).to eq 6
+      expect(render_list.total).to eq 6
+    end
+
+    it "should return renders with an offset", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+      render_list = render.list :offset => 3
+      expect(render_list).to be_an_instance_of OpenTok::RenderList
+      expect(render_list.count).to eq 3
+      expect(render_list.total).to eq 3
+    end
+
+    it "should return count number of renders", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+      render_list = render.list :count => 2
+      expect(render_list).to be_an_instance_of OpenTok::RenderList
+      expect(render_list.count).to eq 2
+      expect(render_list.total).to eq 2
+    end
+
+    it "should return part of the renders when using offset and count", :vcr => { :erb => { :version => OpenTok::VERSION + "-Ruby-Version-#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"} } do
+      render_list = render.list :count => 2, :offset => 2
+      expect(render_list).to be_an_instance_of OpenTok::RenderList
+      expect(render_list.count).to eq 2
+      expect(render_list.total).to eq 2
+    end
+  end
+end