require 'addressable/uri' require 'twitter/arguments' require 'twitter/request' require 'twitter/user' require 'twitter/utils' module Twitter module REST module API module Utils include Twitter::Utils URI_SUBSTRING = '://' DEFAULT_CURSOR = -1 private # 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] 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 # @param request_method [Symbol] # @param path [String] # @param options [Hash] # @param klass [Class] def perform_with_object(request_method, path, options, klass) request = Twitter::Request.new(self, request_method, path, options) request.perform_with_object(klass) end # @param request_method [Symbol] # @param path [String] # @param options [Hash] # @param klass [Class] def perform_with_objects(request_method, path, options, klass) request = Twitter::Request.new(self, request_method, path, options) request.perform_with_objects(klass) end # @param request_method [Symbol] # @param path [String] # @param options [Hash] # @param klass [Class] def perform_with_cursor(request_method, path, options, collection_name, klass = nil) # rubocop:disable ParameterLists merge_default_cursor!(options) request = Twitter::Request.new(self, request_method, path, options) request.perform_with_cursor(collection_name.to_sym, klass) end # @param request_method [Symbol] # @param path [String] # @param args [Array] # @return [Array] def parallel_user_objects_from_response(request_method, path, args) arguments = Twitter::Arguments.new(args) parallel_map(arguments) do |user| perform_with_object(request_method, path, merge_user(arguments.options, user), Twitter::User) end end # @param request_method [Symbol] # @param path [String] # @param args [Array] # @return [Array] def user_objects_from_response(request_method, path, args) arguments = Twitter::Arguments.new(args) merge_user!(arguments.options, arguments.pop || screen_name) unless arguments.options[:user_id] || arguments.options[:screen_name] perform_with_objects(request_method, path, arguments.options, Twitter::User) end # @param klass [Class] # @param request_method [Symbol] # @param path [String] # @param args [Array] # @return [Array] def objects_from_response_with_user(klass, request_method, path, args) arguments = Twitter::Arguments.new(args) merge_user!(arguments.options, arguments.pop) perform_with_objects(request_method, path, arguments.options, klass) end # @param klass [Class] # @param request_method [Symbol] # @param path [String] # @param args [Array] # @return [Array] def parallel_objects_from_response(klass, request_method, path, args) arguments = Twitter::Arguments.new(args) parallel_map(arguments) do |object| perform_with_object(request_method, path, arguments.options.merge(:id => extract_id(object)), klass) end end # @param collection_name [Symbol] # @param klass [Class] # @param request_method [Symbol] # @param path [String] # @param args [Array] # @return [Twitter::Cursor] def cursor_from_response_with_user(collection_name, klass, request_method, path, args) # rubocop:disable ParameterLists arguments = Twitter::Arguments.new(args) merge_user!(arguments.options, arguments.pop || screen_name) unless arguments.options[:user_id] || arguments.options[:screen_name] perform_with_cursor(request_method, path, arguments.options, collection_name, klass) end def handle_forbidden_error(klass, error) error = klass.new(error) if error.message == klass::MESSAGE fail(error) end def screen_name @screen_name ||= verify_credentials.screen_name end def merge_default_cursor!(options) options[:cursor] = DEFAULT_CURSOR unless options[:cursor] end # 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] def merge_user(hash, user, prefix = nil) merge_user!(hash.dup, user, prefix) end # 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] 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 def set_compound_key(key, value, hash, prefix = nil) compound_key = [prefix, key].compact.join('_').to_sym hash[compound_key] = value hash end # Take a multiple users and merge them into the hash with the correct keys # # @param hash [Hash] # @param users [Enumerable] A collection of Twitter user IDs, screen_names, or objects. # @return [Hash] def merge_users(hash, users) merge_users!(hash.dup, users) end # Take a multiple users and merge them into the hash with the correct keys # # @param hash [Hash] # @param users [Enumerable] A collection of Twitter user IDs, screen_names, URIs, or objects. # @return [Hash] 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 def collect_user_ids_and_screen_names(users) # rubocop:disable MethodLength user_ids, screen_names = [], [] users.flatten.each do |user| case user when Integer user_ids << user when String if user[URI_SUBSTRING] screen_names << user.split('/').last else screen_names << user end when URI screen_names << user.path.split('/').last when Twitter::User user_ids << user.id end end [user_ids, screen_names] end end end end end