module Twitter::REST::Utils

Constants

DEFAULT_CURSOR
URI_SUBSTRING

Private Instance Methods

collect_user_ids_and_screen_names(users) click to toggle source
# File lib/twitter/rest/utils.rb, line 235
def collect_user_ids_and_screen_names(users)
  user_ids = []
  screen_names = []
  users.flatten.each do |user|
    case user
    when Integer
      user_ids << user
    when String
      screen_names << (user[URI_SUBSTRING] ? user.split('/').last : user)
    when URI
      screen_names << user.path.split('/').last
    when Twitter::User
      user_ids << user.id
    end
  end
  [user_ids, screen_names]
end
cursor_from_response_with_user(collection_name, klass, path, args) click to toggle source

@param collection_name [Symbol] @param klass [Class] @param path [String] @param args [Array] @return [Twitter::Cursor]

# File lib/twitter/rest/utils.rb, line 159
def cursor_from_response_with_user(collection_name, klass, path, args)
  arguments = Twitter::Arguments.new(args)
  merge_user!(arguments.options, arguments.pop || user_id) unless arguments.options[:user_id] || arguments.options[:screen_name]
  perform_get_with_cursor(path, arguments.options, collection_name, klass)
end
extract_id(object) click to toggle source

Take a URI string or Twitter::Identity object and return its ID

@param object [Integer, String, URI, Twitter::Identity] An ID, URI, or object. @return [Integer]

# File lib/twitter/rest/utils.rb, line 21
def extract_id(object)
  case object
  when ::Integer
    object
  when ::String
    object.split('/').last.to_i
  when URI
    object.path.split('/').last.to_i
  when Twitter::Identity
    object.id
  end
end
merge_default_cursor!(options) click to toggle source
# File lib/twitter/rest/utils.rb, line 173
def merge_default_cursor!(options)
  options[:cursor] = DEFAULT_CURSOR unless options[:cursor]
end
merge_user(hash, user, prefix = nil) click to toggle source

Take a user and merge it into the hash with the correct key

@param hash [Hash] @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object. @return [Hash]

# File lib/twitter/rest/utils.rb, line 182
def merge_user(hash, user, prefix = nil)
  merge_user!(hash.dup, user, prefix)
end
merge_user!(hash, user, prefix = nil) click to toggle source

Take a user and merge it into the hash with the correct key

@param hash [Hash] @param user [Integer, String, URI, Twitter::User] A Twitter user ID, screen name, URI, or object. @return [Hash]

# File lib/twitter/rest/utils.rb, line 191
def merge_user!(hash, user, prefix = nil)
  case user
  when Integer
    set_compound_key('user_id', user, hash, prefix)
  when String
    if user[URI_SUBSTRING]
      set_compound_key('screen_name', user.split('/').last, hash, prefix)
    else
      set_compound_key('screen_name', user, hash, prefix)
    end
  when URI, Addressable::URI
    set_compound_key('screen_name', user.path.split('/').last, hash, prefix)
  when Twitter::User
    set_compound_key('user_id', user.id, hash, prefix)
  end
end
merge_users(hash, users) click to toggle source

Take a multiple users and merge them into the hash with the correct keys

@param hash [Hash] @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen_names, or objects. @return [Hash]

# File lib/twitter/rest/utils.rb, line 219
def merge_users(hash, users)
  merge_users!(hash.dup, users)
end
merge_users!(hash, users) click to toggle source

Take a multiple users and merge them into the hash with the correct keys

@param hash [Hash] @param users [Enumerable<Integer, String, URI, Twitter::User>] A collection of Twitter user IDs, screen_names, URIs, or objects. @return [Hash]

# File lib/twitter/rest/utils.rb, line 228
def merge_users!(hash, users)
  user_ids, screen_names = collect_user_ids_and_screen_names(users)
  hash[:user_id] = user_ids.join(',') unless user_ids.empty?
  hash[:screen_name] = screen_names.join(',') unless screen_names.empty?
  hash
end
objects_from_response_with_user(klass, request_method, path, args) click to toggle source

@param klass [Class] @param request_method [Symbol] @param path [String] @param args [Array] @return [Array]

# File lib/twitter/rest/utils.rb, line 136
def objects_from_response_with_user(klass, request_method, path, args)
  arguments = Twitter::Arguments.new(args)
  merge_user!(arguments.options, arguments.pop)
  perform_request_with_objects(request_method, path, arguments.options, klass)
end
parallel_objects_from_response(klass, request_method, path, args) click to toggle source

@param klass [Class] @param request_method [Symbol] @param path [String] @param args [Array] @return [Array]

# File lib/twitter/rest/utils.rb, line 147
def parallel_objects_from_response(klass, request_method, path, args)
  arguments = Twitter::Arguments.new(args)
  pmap(arguments) do |object|
    perform_request_with_object(request_method, path, arguments.options.merge(:id => extract_id(object)), klass)
  end
end
parallel_users_from_response(request_method, path, args) click to toggle source

@param request_method [Symbol] @param path [String] @param args [Array] @return [Array<Twitter::User>]

# File lib/twitter/rest/utils.rb, line 114
def parallel_users_from_response(request_method, path, args)
  arguments = Twitter::Arguments.new(args)
  pmap(arguments) do |user|
    perform_request_with_object(request_method, path, merge_user(arguments.options, user), Twitter::User)
  end
end
perform_get(path, options = {}) click to toggle source

@param path [String] @param options [Hash]

# File lib/twitter/rest/utils.rb, line 36
def perform_get(path, options = {})
  perform_request(:get, path, options)
end
perform_get_with_cursor(path, options, collection_name, klass = nil) click to toggle source

@param path [String] @param options [Hash] @param collection_name [Symbol] @param klass [Class]

# File lib/twitter/rest/utils.rb, line 104
def perform_get_with_cursor(path, options, collection_name, klass = nil)
  merge_default_cursor!(options)
  request = Twitter::REST::Request.new(self, :get, path, options)
  Twitter::Cursor.new(collection_name.to_sym, klass, request)
end
perform_get_with_object(path, options, klass) click to toggle source

@param path [String] @param options [Hash] @param klass [Class]

# File lib/twitter/rest/utils.rb, line 56
def perform_get_with_object(path, options, klass)
  perform_request_with_object(:get, path, options, klass)
end
perform_get_with_objects(path, options, klass) click to toggle source

@param path [String] @param options [Hash] @param klass [Class]

# File lib/twitter/rest/utils.rb, line 79
def perform_get_with_objects(path, options, klass)
  perform_request_with_objects(:get, path, options, klass)
end
perform_post(path, options = {}) click to toggle source

@param path [String] @param options [Hash]

# File lib/twitter/rest/utils.rb, line 42
def perform_post(path, options = {})
  perform_request(:post, path, options)
end
perform_post_with_object(path, options, klass) click to toggle source

@param path [String] @param options [Hash] @param klass [Class]

# File lib/twitter/rest/utils.rb, line 63
def perform_post_with_object(path, options, klass)
  perform_request_with_object(:post, path, options, klass)
end
perform_post_with_objects(path, options, klass) click to toggle source

@param path [String] @param options [Hash] @param klass [Class]

# File lib/twitter/rest/utils.rb, line 86
def perform_post_with_objects(path, options, klass)
  perform_request_with_objects(:post, path, options, klass)
end
perform_request(request_method, path, options = {}) click to toggle source

@param request_method [Symbol] @param path [String] @param options [Hash]

# File lib/twitter/rest/utils.rb, line 49
def perform_request(request_method, path, options = {})
  Twitter::REST::Request.new(self, request_method, path, options).perform
end
perform_request_with_object(request_method, path, options, klass) click to toggle source

@param request_method [Symbol] @param path [String] @param options [Hash] @param klass [Class]

# File lib/twitter/rest/utils.rb, line 71
def perform_request_with_object(request_method, path, options, klass)
  response = perform_request(request_method, path, options)
  klass.new(response)
end
perform_request_with_objects(request_method, path, options, klass) click to toggle source

@param request_method [Symbol] @param path [String] @param options [Hash] @param klass [Class]

# File lib/twitter/rest/utils.rb, line 94
def perform_request_with_objects(request_method, path, options, klass)
  perform_request(request_method, path, options).collect do |element|
    klass.new(element)
  end
end
set_compound_key(key, value, hash, prefix = nil) click to toggle source
# File lib/twitter/rest/utils.rb, line 208
def set_compound_key(key, value, hash, prefix = nil)
  compound_key = [prefix, key].compact.join('_').to_sym
  hash[compound_key] = value
  hash
end
user_id() click to toggle source
# File lib/twitter/rest/utils.rb, line 165
def user_id
  @user_id ||= verify_credentials(:skip_status => true).id
end
user_id?() click to toggle source
# File lib/twitter/rest/utils.rb, line 169
def user_id?
  instance_variable_defined?(:@user_id)
end
users_from_response(request_method, path, args) click to toggle source

@param request_method [Symbol] @param path [String] @param args [Array] @return [Array<Twitter::User>]

# File lib/twitter/rest/utils.rb, line 125
def users_from_response(request_method, path, args)
  arguments = Twitter::Arguments.new(args)
  merge_user!(arguments.options, arguments.pop || user_id) unless arguments.options[:user_id] || arguments.options[:screen_name]
  perform_request_with_objects(request_method, path, arguments.options, Twitter::User)
end