twilio-ruby 5.5.1 → 5.58.3

data/lib/twilio-ruby/rest/preview/proxy/service/session.rb

@@ -1,495 +0,0 @@
-##
-# This code was generated by
-# \ / _    _  _|   _  _
-#  | (_)\/(_)(_|\/| |(/_  v1.0.0
-#       /       /
-
-module Twilio
-  module REST
-    class Preview < Domain
-      class Proxy < Version
-        class ServiceContext < InstanceContext
-          ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
-          class SessionList < ListResource
-            ##
-            # Initialize the SessionList
-            # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The unique SID identifier of the Service.
-            # @return [SessionList] SessionList
-            def initialize(version, service_sid: nil)
-              super(version)
-
-              # Path Solution
-              @solution = {service_sid: service_sid}
-              @uri = "/Services/#{@solution[:service_sid]}/Sessions"
-            end
-
-            ##
-            # Lists SessionInstance records from the API as a list.
-            # Unlike stream(), this operation is eager and will load `limit` records into
-            # memory before returning.
-            # @param [String] unique_name Provides a unique and addressable name to be
-            #   assigned to this Session, assigned by the developer, to be optionally used in
-            #   addition to SID.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`
-            #   or `completed`.
-            # @param [Integer] limit Upper limit for the number of records to return. stream()
-            #    guarantees to never return more than limit.  Default is no limit
-            # @param [Integer] page_size Number of records to fetch per request, when
-            #    not set will use the default value of 50 records.  If no page_size is defined
-            #    but a limit is defined, stream() will attempt to read the limit with the most
-            #    efficient page size, i.e. min(limit, 1000)
-            # @return [Array] Array of up to limit results
-            def list(unique_name: :unset, status: :unset, limit: nil, page_size: nil)
-              self.stream(unique_name: unique_name, status: status, limit: limit, page_size: page_size).entries
-            end
-
-            ##
-            # Streams SessionInstance records from the API as an Enumerable.
-            # This operation lazily loads records as efficiently as possible until the limit
-            # is reached.
-            # @param [String] unique_name Provides a unique and addressable name to be
-            #   assigned to this Session, assigned by the developer, to be optionally used in
-            #   addition to SID.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`
-            #   or `completed`.
-            # @param [Integer] limit Upper limit for the number of records to return. stream()
-            #    guarantees to never return more than limit. Default is no limit.
-            # @param [Integer] page_size Number of records to fetch per request, when
-            #    not set will use the default value of 50 records. If no page_size is defined
-            #    but a limit is defined, stream() will attempt to read the limit with the most
-            #    efficient page size, i.e. min(limit, 1000)
-            # @return [Enumerable] Enumerable that will yield up to limit results
-            def stream(unique_name: :unset, status: :unset, limit: nil, page_size: nil)
-              limits = @version.read_limits(limit, page_size)
-
-              page = self.page(unique_name: unique_name, status: status, page_size: limits[:page_size])
-
-              @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
-            end
-
-            ##
-            # When passed a block, yields SessionInstance records from the API.
-            # This operation lazily loads records as efficiently as possible until the limit
-            # is reached.
-            def each
-              limits = @version.read_limits
-
-              page = self.page(page_size: limits[:page_size])
-
-              @version.stream(page,
-                              limit: limits[:limit],
-                              page_limit: limits[:page_limit]).each {|x| yield x}
-            end
-
-            ##
-            # Retrieve a single page of SessionInstance records from the API.
-            # Request is executed immediately.
-            # @param [String] unique_name Provides a unique and addressable name to be
-            #   assigned to this Session, assigned by the developer, to be optionally used in
-            #   addition to SID.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`
-            #   or `completed`.
-            # @param [String] page_token PageToken provided by the API
-            # @param [Integer] page_number Page Number, this value is simply for client state
-            # @param [Integer] page_size Number of records to return, defaults to 50
-            # @return [Page] Page of SessionInstance
-            def page(unique_name: :unset, status: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
-              params = Twilio::Values.of({
-                  'UniqueName' => unique_name,
-                  'Status' => status,
-                  'PageToken' => page_token,
-                  'Page' => page_number,
-                  'PageSize' => page_size,
-              })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
-              SessionPage.new(@version, response, @solution)
-            end
-
-            ##
-            # Retrieve a single page of SessionInstance records from the API.
-            # Request is executed immediately.
-            # @param [String] target_url API-generated URL for the requested results page
-            # @return [Page] Page of SessionInstance
-            def get_page(target_url)
-              response = @version.domain.request(
-                  'GET',
-                  target_url
-              )
-              SessionPage.new(@version, response, @solution)
-            end
-
-            ##
-            # Retrieve a single page of SessionInstance records from the API.
-            # Request is executed immediately.
-            # @param [String] unique_name Provides a unique and addressable name to be
-            #   assigned to this Session, assigned by the developer, to be optionally used in
-            #   addition to SID.
-            # @param [String] ttl How long will this session stay open, in seconds. Each new
-            #   interaction resets this timer.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`
-            #   or `completed`.
-            # @param [String] participants The participants
-            # @return [SessionInstance] Newly created SessionInstance
-            def create(unique_name: :unset, ttl: :unset, status: :unset, participants: :unset)
-              data = Twilio::Values.of({
-                  'UniqueName' => unique_name,
-                  'Ttl' => ttl,
-                  'Status' => status,
-                  'Participants' => Twilio.serialize_list(participants) { |e| e },
-              })
-
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
-
-              SessionInstance.new(@version, payload, service_sid: @solution[:service_sid])
-            end
-
-            ##
-            # Provide a user friendly representation
-            def to_s
-              '#<Twilio.Preview.Proxy.SessionList>'
-            end
-          end
-
-          ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
-          class SessionPage < Page
-            ##
-            # Initialize the SessionPage
-            # @param [Version] version Version that contains the resource
-            # @param [Response] response Response from the API
-            # @param [Hash] solution Path solution for the resource
-            # @return [SessionPage] SessionPage
-            def initialize(version, response, solution)
-              super(version, response)
-
-              # Path Solution
-              @solution = solution
-            end
-
-            ##
-            # Build an instance of SessionInstance
-            # @param [Hash] payload Payload response from the API
-            # @return [SessionInstance] SessionInstance
-            def get_instance(payload)
-              SessionInstance.new(@version, payload, service_sid: @solution[:service_sid])
-            end
-
-            ##
-            # Provide a user friendly representation
-            def to_s
-              '<Twilio.Preview.Proxy.SessionPage>'
-            end
-          end
-
-          ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
-          class SessionContext < InstanceContext
-            ##
-            # Initialize the SessionContext
-            # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The unique SID identifier of the Service.
-            # @param [String] sid A 34 character string that uniquely identifies this Session.
-            # @return [SessionContext] SessionContext
-            def initialize(version, service_sid, sid)
-              super(version)
-
-              # Path Solution
-              @solution = {service_sid: service_sid, sid: sid}
-              @uri = "/Services/#{@solution[:service_sid]}/Sessions/#{@solution[:sid]}"
-
-              # Dependents
-              @interactions = nil
-              @participants = nil
-            end
-
-            ##
-            # Fetch a SessionInstance
-            # @return [SessionInstance] Fetched SessionInstance
-            def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
-
-              SessionInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid])
-            end
-
-            ##
-            # Deletes the SessionInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
-            def delete
-              @version.delete('delete', @uri)
-            end
-
-            ##
-            # Update the SessionInstance
-            # @param [String] unique_name Provides a unique and addressable name to be
-            #   assigned to this Session, assigned by the developer, to be optionally used in
-            #   addition to SID.
-            # @param [String] ttl How long will this session stay open, in seconds. Each new
-            #   interaction resets this timer.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`
-            #   or `completed`.
-            # @param [String] participants The participants
-            # @return [SessionInstance] Updated SessionInstance
-            def update(unique_name: :unset, ttl: :unset, status: :unset, participants: :unset)
-              data = Twilio::Values.of({
-                  'UniqueName' => unique_name,
-                  'Ttl' => ttl,
-                  'Status' => status,
-                  'Participants' => Twilio.serialize_list(participants) { |e| e },
-              })
-
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
-
-              SessionInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid])
-            end
-
-            ##
-            # Access the interactions
-            # @return [InteractionList]
-            # @return [InteractionContext] if sid was passed.
-            def interactions(sid=:unset)
-              raise ArgumentError, 'sid cannot be nil' if sid.nil?
-
-              if sid != :unset
-                return InteractionContext.new(@version, @solution[:service_sid], @solution[:sid], sid)
-              end
-
-              unless @interactions
-                @interactions = InteractionList.new(
-                    @version,
-                    service_sid: @solution[:service_sid],
-                    session_sid: @solution[:sid],
-                )
-              end
-
-              @interactions
-            end
-
-            ##
-            # Access the participants
-            # @return [ParticipantList]
-            # @return [ParticipantContext] if sid was passed.
-            def participants(sid=:unset)
-              raise ArgumentError, 'sid cannot be nil' if sid.nil?
-
-              if sid != :unset
-                return ParticipantContext.new(@version, @solution[:service_sid], @solution[:sid], sid)
-              end
-
-              unless @participants
-                @participants = ParticipantList.new(
-                    @version,
-                    service_sid: @solution[:service_sid],
-                    session_sid: @solution[:sid],
-                )
-              end
-
-              @participants
-            end
-
-            ##
-            # Provide a user friendly representation
-            def to_s
-              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
-              "#<Twilio.Preview.Proxy.SessionContext #{context}>"
-            end
-          end
-
-          ##
-          # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
-          class SessionInstance < InstanceResource
-            ##
-            # Initialize the SessionInstance
-            # @param [Version] version Version that contains the resource
-            # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] service_sid The unique SID identifier of the Service.
-            # @param [String] sid A 34 character string that uniquely identifies this Session.
-            # @return [SessionInstance] SessionInstance
-            def initialize(version, payload, service_sid: nil, sid: nil)
-              super(version)
-
-              # Marshaled Properties
-              @properties = {
-                  'sid' => payload['sid'],
-                  'service_sid' => payload['service_sid'],
-                  'account_sid' => payload['account_sid'],
-                  'unique_name' => payload['unique_name'],
-                  'ttl' => payload['ttl'].to_i,
-                  'status' => payload['status'],
-                  'start_time' => Twilio.deserialize_iso8601_datetime(payload['start_time']),
-                  'end_time' => Twilio.deserialize_iso8601_datetime(payload['end_time']),
-                  'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
-                  'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
-                  'url' => payload['url'],
-                  'links' => payload['links'],
-              }
-
-              # Context
-              @instance_context = nil
-              @params = {'service_sid' => service_sid, 'sid' => sid || @properties['sid']}
-            end
-
-            ##
-            # Generate an instance context for the instance, the context is capable of
-            # performing various actions.  All instance actions are proxied to the context
-            # @return [SessionContext] SessionContext for this SessionInstance
-            def context
-              unless @instance_context
-                @instance_context = SessionContext.new(@version, @params['service_sid'], @params['sid'])
-              end
-              @instance_context
-            end
-
-            ##
-            # @return [String] A string that uniquely identifies this Session.
-            def sid
-              @properties['sid']
-            end
-
-            ##
-            # @return [String] Service Sid.
-            def service_sid
-              @properties['service_sid']
-            end
-
-            ##
-            # @return [String] Account Sid.
-            def account_sid
-              @properties['account_sid']
-            end
-
-            ##
-            # @return [String] A unique, developer assigned name of this Session.
-            def unique_name
-              @properties['unique_name']
-            end
-
-            ##
-            # @return [String] How long will this session stay open, in seconds.
-            def ttl
-              @properties['ttl']
-            end
-
-            ##
-            # @return [session.Status] The Status of this Session
-            def status
-              @properties['status']
-            end
-
-            ##
-            # @return [Time] The date this Session was started
-            def start_time
-              @properties['start_time']
-            end
-
-            ##
-            # @return [Time] The date this Session was ended
-            def end_time
-              @properties['end_time']
-            end
-
-            ##
-            # @return [Time] The date this Session was created
-            def date_created
-              @properties['date_created']
-            end
-
-            ##
-            # @return [Time] The date this Session was updated
-            def date_updated
-              @properties['date_updated']
-            end
-
-            ##
-            # @return [String] The URL of this Session.
-            def url
-              @properties['url']
-            end
-
-            ##
-            # @return [String] Nested resource URLs.
-            def links
-              @properties['links']
-            end
-
-            ##
-            # Fetch a SessionInstance
-            # @return [SessionInstance] Fetched SessionInstance
-            def fetch
-              context.fetch
-            end
-
-            ##
-            # Deletes the SessionInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
-            def delete
-              context.delete
-            end
-
-            ##
-            # Update the SessionInstance
-            # @param [String] unique_name Provides a unique and addressable name to be
-            #   assigned to this Session, assigned by the developer, to be optionally used in
-            #   addition to SID.
-            # @param [String] ttl How long will this session stay open, in seconds. Each new
-            #   interaction resets this timer.
-            # @param [session.Status] status The Status of this Session. One of `in-progess`
-            #   or `completed`.
-            # @param [String] participants The participants
-            # @return [SessionInstance] Updated SessionInstance
-            def update(unique_name: :unset, ttl: :unset, status: :unset, participants: :unset)
-              context.update(unique_name: unique_name, ttl: ttl, status: status, participants: participants)
-            end
-
-            ##
-            # Access the interactions
-            # @return [interactions] interactions
-            def interactions
-              context.interactions
-            end
-
-            ##
-            # Access the participants
-            # @return [participants] participants
-            def participants
-              context.participants
-            end
-
-            ##
-            # Provide a user friendly representation
-            def to_s
-              values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
-              "<Twilio.Preview.Proxy.SessionInstance #{values}>"
-            end
-
-            ##
-            # Provide a detailed, user friendly representation
-            def inspect
-              values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
-              "<Twilio.Preview.Proxy.SessionInstance #{values}>"
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/preview/proxy.rb

@@ -1,41 +0,0 @@
-##
-# This code was generated by
-# \ / _    _  _|   _  _
-#  | (_)\/(_)(_|\/| |(/_  v1.0.0
-#       /       /
-
-module Twilio
-  module REST
-    class Preview
-      class Proxy < Version
-        ##
-        # Initialize the Proxy version of Preview
-        def initialize(domain)
-          super
-          @version = 'Proxy'
-          @services = nil
-        end
-
-        ##
-        # @param [String] sid A 34 character string that uniquely identifies this Service.
-        # @return [Twilio::REST::Preview::Proxy::ServiceContext] if sid was passed.
-        # @return [Twilio::REST::Preview::Proxy::ServiceList]
-        def services(sid=:unset)
-          if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @services ||= ServiceList.new self
-          else
-            ServiceContext.new(self, sid)
-          end
-        end
-
-        ##
-        # Provide a user friendly representation
-        def to_s
-          '<Twilio::REST::Preview::Proxy>'
-        end
-      end
-    end
-  end
-end

data/lib/twilio-ruby/rest/preview/studio.rb

@@ -1,41 +0,0 @@
-##
-# This code was generated by
-# \ / _    _  _|   _  _
-#  | (_)\/(_)(_|\/| |(/_  v1.0.0
-#       /       /
-
-module Twilio
-  module REST
-    class Preview
-      class Studio < Version
-        ##
-        # Initialize the Studio version of Preview
-        def initialize(domain)
-          super
-          @version = 'Studio'
-          @flows = nil
-        end
-
-        ##
-        # @param [String] sid The sid
-        # @return [Twilio::REST::Preview::Studio::FlowContext] if sid was passed.
-        # @return [Twilio::REST::Preview::Studio::FlowList]
-        def flows(sid=:unset)
-          if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @flows ||= FlowList.new self
-          else
-            FlowContext.new(self, sid)
-          end
-        end
-
-        ##
-        # Provide a user friendly representation
-        def to_s
-          '<Twilio::REST::Preview::Studio>'
-        end
-      end
-    end
-  end
-end

data/spec/framework/request_spec.rb

@@ -1,36 +0,0 @@
-require 'spec_helper'
-
-describe Twilio::Request do
-  before do
-    @request = Twilio::Request.new('host',
-                                   'port',
-                                   'POST',
-                                   'url',
-                                   { 'param-key' => 'param-value', 'param-keytwo' => 'param-valuetwo' },
-                                   { 'data-key' => 'data-value', 'data-keytwo' => 'data-valuetwo' },
-                                   { 'header-key' => 'header-value', 'header-keytwo' => 'header-valuetwo' },
-                                   ['a', 'b'],
-                                   'timeout')
-  end
-
-  it 'should initialize readers correctly' do
-    expect(@request.host).to eq('host')
-    expect(@request.port).to eq('port')
-    expect(@request.method).to eq('POST')
-    expect(@request.url).to eq('url')
-    expect(@request.params).to eq('param-key' => 'param-value', 'param-keytwo' => 'param-valuetwo')
-    expect(@request.data).to eq('data-key' => 'data-value', 'data-keytwo' => 'data-valuetwo')
-    expect(@request.headers).to eq('header-key' => 'header-value', 'header-keytwo' => 'header-valuetwo')
-    expect(@request.auth).to eq(['a', 'b'])
-    expect(@request.timeout).to eq('timeout')
-  end
-
-  it 'should be represented correctly' do
-    expected_string = %((a,b) POST url?param-key=param-value&param-keytwo=param-valuetwo) +
-                      %(\n-d "data-key"="data-value") +
-                      %(\n-d "data-keytwo"="data-valuetwo") +
-                      %(\n-H "header-key": "header-value") +
-                      %(\n-H "header-keytwo": "header-valuetwo")
-    expect(@request.to_s).to eq(expected_string)
-  end
-end

data/spec/framework/serialize_spec.rb

@@ -1,80 +0,0 @@
-require 'spec_helper'
-
-describe Twilio do
-  describe 'prefixed_collapsible_map' do
-    it 'should serialize nil' do
-      actual = Twilio.prefixed_collapsible_map(nil, 'Prefix')
-      expect(actual).to eq({})
-    end
-
-    it 'should serialize a single key' do
-      actual = Twilio.prefixed_collapsible_map({ 'foo' => 'bar' }, 'Prefix')
-      expect(actual).to eq('Prefix.foo' => 'bar')
-    end
-
-    it 'should serialize nested key' do
-      actual = Twilio.prefixed_collapsible_map({
-                                                 'foo' => {
-                                                   'bar' => 'baz'
-                                                 }
-                                               }, 'Prefix')
-      expect(actual).to eq('Prefix.foo.bar' => 'baz')
-    end
-
-    it 'should serialize multiple keys' do
-      actual = Twilio.prefixed_collapsible_map({
-                                                 'watson' => {
-                                                   'language' => 'en',
-                                                   'alice' => 'bob'
-                                                 },
-                                                 'foo' => 'bar'
-                                               }, 'Prefix')
-      expect(actual).to eq('Prefix.watson.language' => 'en',
-                           'Prefix.watson.alice' => 'bob',
-                           'Prefix.foo' => 'bar')
-    end
-
-    it 'should serialize list' do
-      actual = Twilio.prefixed_collapsible_map(['foo', 'bar'], 'Prefix')
-      expect(actual).to eq({})
-    end
-  end
-
-  describe 'serialize_object' do
-    it 'should jsonify hashes' do
-      actual = Twilio.serialize_object({ twilio: "rocks" })
-      expect(actual).to eq('{"twilio":"rocks"}')
-    end
-
-    it 'should jsonify arrays' do
-      actual = Twilio.serialize_object(["twilio", "rocks"])
-      expect(actual).to eq('["twilio","rocks"]')
-    end
-
-    it 'should not modify other types' do
-      actual = Twilio.serialize_object(123)
-      expect(actual).to eq(123)
-    end
-  end
-
-  describe 'serialize_list' do
-    it 'should only operate on things with .each method' do
-      actual = Twilio.serialize_list(nil)
-      expect(actual).to eq(nil)
-
-      actual = Twilio.serialize_list("something")
-      expect(actual).to eq("something")
-
-      actual = Twilio.serialize_list(1)
-      expect(actual).to eq(1)
-
-      actual = Twilio.serialize_list({ some_obj: 'some_val' })
-      expect(actual).to eq({ some_obj: 'some_val' })
-    end
-
-    it 'should apply block to every element in list' do
-      actual = Twilio.serialize_list([1, 2, 3, 4]) { |e| e * 2 }
-      expect(actual).to eq([2, 4, 6, 8])
-    end
-  end
-end