module Twilio
module REST
class ListResource
include Utils
def initialize(path, client)
custom_names = {
'Media' => 'MediaInstance',
'IpAddresses' => 'IpAddress',
'Feedback' => 'FeedbackInstance'
}
@path, @client = path, client
resource_name = self.class.name.split('::')[-1]
instance_name = custom_names.fetch(resource_name, resource_name.chop)
# The next line grabs the enclosing module. Necessary for resources
# contained in their own submodule like /SMS/Messages
parent_module = self.class.to_s.split('::')[-2]
full_module_path = if parent_module == "REST"
Twilio::REST
else
Twilio::REST.const_get parent_module
end
@instance_class = full_module_path.const_get instance_name
@list_key, @instance_id_key = detwilify(resource_name), 'sid'
end
def inspect # :nodoc:
"<#{self.class} @path=#{@path}>"
end
##
# Grab a list of this kind of resource and return it as an array. The
# array includes a special attribute named +total+ which will return the
# total number of items in the list on Twilio's server. This may differ
# from the +size+ and +length+ attributes of the returned array since
# by default Twilio will only return 50 resources, and the maximum number
# of resources you can request is 1000.
#
# The optional +params+ hash allows you to filter the list returned. The
# filters for each list resource type are defined by Twilio.
def list(params={}, full_path=false)
raise "Can't get a resource list without a REST Client" unless @client
response = @client.get @path, params, full_path
resources = response[@list_key]
path = full_path ? @path.split('.')[0] : @path
resource_list = resources.map do |resource|
@instance_class.new "#{path}/#{resource[@instance_id_key]}", @client,
resource
end
# set the +total+ and +next_page+ properties on the array
client, list_class = @client, self.class
resource_list.instance_eval do
eigenclass = class << self; self; end
eigenclass.send :define_method, :total, &lambda { response['total'] }
eigenclass.send :define_method, :next_page, &lambda {
if response['next_page_uri']
list_class.new(response['next_page_uri'], client).list({}, true)
else
[]
end
}
end
resource_list
end
##
# Ask Twilio for the total number of items in the list.
# Calling this method makes an HTTP GET request to @path with a
# page size parameter of 1 to minimize data over the wire while still
# obtaining the total. Don't use this if you are planning to
# call #list anyway, since the array returned from #list will have a
# +total+ attribute as well.
def total
raise "Can't get a resource total without a REST Client" unless @client
@client.get(@path, page_size: 1)['total']
end
##
# Return an empty instance resource object with the proper path. Note that
# this will never raise a Twilio::REST::RequestError on 404 since no HTTP
# request is made. The HTTP request is made when attempting to access an
# attribute of the returned instance resource object, such as
# its #date_created or #voice_url attributes.
def get(sid)
@instance_class.new "#{@path}/#{sid}", @client
end
alias :find :get # for the ActiveRecord lovers
##
# Return a newly created resource. Some +params+ may be required. Consult
# the Twilio REST API documentation related to the kind of resource you
# are attempting to create for details. Calling this method makes an HTTP
# POST request to @path with the given params
def create(params={})
raise "Can't create a resource without a REST Client" unless @client
response = @client.post @path, params
@instance_class.new "#{@path}/#{response[@instance_id_key]}", @client,
response
end
def resource(*resources)
custom_resource_names = {
sms: 'SMS',
sip: 'SIP'
}
resources.each do |r|
resource = twilify r
relative_path = custom_resource_names.fetch(r, resource)
path = "#{@path}/#{relative_path}"
enclosing_module = if @submodule == nil
Twilio::REST
else
Twilio::REST.const_get(@submodule)
end
resource_class = enclosing_module.const_get resource
instance_variable_set("@#{r}", resource_class.new(path, @client))
end
self.class.instance_eval { attr_reader *resources }
end
end
end
end