twitter 5.6.0 → 5.7.0

data/lib/twitter/rest/api/friends_and_followers.rb

@@ -1,284 +0,0 @@
-require 'twitter/arguments'
-require 'twitter/cursor'
-require 'twitter/error/forbidden'
-require 'twitter/relationship'
-require 'twitter/request'
-require 'twitter/rest/api/utils'
-require 'twitter/user'
-require 'twitter/utils'
-
-module Twitter
-  module REST
-    module API
-      module FriendsAndFollowers
-        include Twitter::REST::API::Utils
-        include Twitter::Utils
-
-        # @see https://dev.twitter.com/docs/api/1.1/get/friends/ids
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor]
-        # @overload friend_ids(options = {})
-        #   Returns an array of numeric IDs for every user the authenticated user is following
-        #
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. This is recommended for users who are following many users. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
-        # @overload friend_ids(user, options = {})
-        #   Returns an array of numeric IDs for every user the specified user is following
-        #
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        def friend_ids(*args)
-          cursor_from_response_with_user(:ids, nil, :get, '/1.1/friends/ids.json', args)
-        end
-
-        # @see https://dev.twitter.com/docs/api/1.1/get/followers/ids
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor]
-        # @overload follower_ids(options = {})
-        #   Returns an array of numeric IDs for every user following the authenticated user
-        #
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        # @overload follower_ids(user, options = {})
-        #   Returns an array of numeric IDs for every user following the specified user
-        #
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. This is recommended for users who are following many users. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
-        def follower_ids(*args)
-          cursor_from_response_with_user(:ids, nil, :get, '/1.1/followers/ids.json', args)
-        end
-
-        # Returns the relationship of the authenticating user to the comma separated list of up to 100 screen_names or user_ids provided. Values for connections can be: following, following_requested, followed_by, none.
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/friendships/lookup
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Array<Twitter::User>] The requested users.
-        # @overload friendships(*users)
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        # @overload friendships(*users, options)
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        #   @param options [Hash] A customizable set of options.
-        def friendships(*args)
-          arguments = Twitter::Arguments.new(args)
-          merge_users!(arguments.options, arguments)
-          perform_with_objects(:get, '/1.1/friendships/lookup.json', arguments.options, Twitter::User)
-        end
-
-        # Returns an array of numeric IDs for every user who has a pending request to follow the authenticating user
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/friendships/incoming
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor]
-        # @param options [Hash] A customizable set of options.
-        # @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        def friendships_incoming(options = {})
-          perform_with_cursor(:get, '/1.1/friendships/incoming.json', options, :ids)
-        end
-
-        # Returns an array of numeric IDs for every protected user for whom the authenticating user has a pending follow request
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/friendships/outgoing
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor]
-        # @param options [Hash] A customizable set of options.
-        # @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        def friendships_outgoing(options = {})
-          perform_with_cursor(:get, '/1.1/friendships/outgoing.json', options, :ids)
-        end
-
-        # Allows the authenticating user to follow the specified users, unless they are already followed
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/friendships/create
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Array<Twitter::User>] The followed users.
-        # @overload follow(*users)
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        # @overload follow(*users, options)
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Boolean] :follow (false) Enable notifications for the target user.
-        def follow(*args)
-          arguments = Twitter::Arguments.new(args)
-          existing_friends = Thread.new do
-            friend_ids.to_a
-          end
-          new_friends = Thread.new do
-            users(args).collect(&:id)
-          end
-          follow!(new_friends.value - existing_friends.value, arguments.options)
-        end
-        alias_method :create_friendship, :follow
-        deprecate_alias :friendship_create, :follow
-
-        # Allows the authenticating user to follow the specified users
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/friendships/create
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Array<Twitter::User>] The followed users.
-        # @overload follow!(*users)
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        # @overload follow!(*users, options)
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Boolean] :follow (false) Enable notifications for the target user.
-        def follow!(*args)
-          arguments = Twitter::Arguments.new(args)
-          parallel_map(arguments) do |user|
-            perform_with_object(:post, '/1.1/friendships/create.json', merge_user(arguments.options, user), Twitter::User)
-          end.compact
-        end
-        alias_method :create_friendship!, :follow!
-        deprecate_alias :friendship_create!, :follow!
-
-        # Allows the authenticating user to unfollow the specified users
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/friendships/destroy
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Array<Twitter::User>] The unfollowed users.
-        # @overload unfollow(*users)
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        # @overload unfollow(*users, options)
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        #   @param options [Hash] A customizable set of options.
-        def unfollow(*args)
-          parallel_user_objects_from_response(:post, '/1.1/friendships/destroy.json', args)
-        end
-        alias_method :destroy_friendship, :unfollow
-        deprecate_alias :friendship_destroy, :unfollow
-
-        # Allows one to enable or disable retweets and device notifications from the specified user.
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/friendships/update
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Relationship]
-        # @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        # @param options [Hash] A customizable set of options.
-        # @option options [Boolean] :device Enable/disable device notifications from the target user.
-        # @option options [Boolean] :retweets Enable/disable retweets from the target user.
-        def friendship_update(user, options = {})
-          merge_user!(options, user)
-          perform_with_object(:post, '/1.1/friendships/update.json', options, Twitter::Relationship)
-        end
-
-        # Returns detailed information about the relationship between two users
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/friendships/show
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Relationship]
-        # @param source [Integer, String, Twitter::User] The Twitter user ID, screen name, or object of the source user.
-        # @param target [Integer, String, Twitter::User] The Twitter user ID, screen name, or object of the target user.
-        # @param options [Hash] A customizable set of options.
-        def friendship(source, target, options = {})
-          merge_user!(options, source, 'source')
-          options[:source_id] = options.delete(:source_user_id) unless options[:source_user_id].nil?
-          merge_user!(options, target, 'target')
-          options[:target_id] = options.delete(:target_user_id) unless options[:target_user_id].nil?
-          perform_with_object(:get, '/1.1/friendships/show.json', options, Twitter::Relationship)
-        end
-        alias_method :friendship_show, :friendship
-        alias_method :relationship, :friendship
-
-        # Test for the existence of friendship between two users
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/friendships/show
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Boolean] true if user_a follows user_b, otherwise false.
-        # @param source [Integer, String, Twitter::User] The Twitter user ID, screen name, or object of the source user.
-        # @param target [Integer, String, Twitter::User] The Twitter user ID, screen name, or object of the target user.
-        # @param options [Hash] A customizable set of options.
-        def friendship?(source, target, options = {})
-          friendship(source, target, options).source.following?
-        end
-
-        # Returns a cursored collection of user objects for users following the specified user.
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/followers/list
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor]
-        # @overload followers(options = {})
-        #   Returns a cursored collection of user objects for users following the authenticated user.
-        #
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. This is recommended for users who are following many users. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
-        #   @option options [Boolean, String, Integer] :skip_status Do not include contributee's Tweets when set to true, 't' or 1.
-        #   @option options [Boolean, String, Integer] :include_user_entities The user entities node will be disincluded when set to false.
-        # @overload followers(user, options = {})
-        #   Returns a cursored collection of user objects for users following the specified user.
-        #
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        #   @option options [Boolean, String, Integer] :skip_status Do not include contributee's Tweets when set to true, 't' or 1.
-        #   @option options [Boolean, String, Integer] :include_user_entities The user entities node will be disincluded when set to false.
-        def followers(*args)
-          cursor_from_response_with_user(:users, Twitter::User, :get, '/1.1/followers/list.json', args)
-        end
-
-        # Returns a cursored collection of user objects for every user the specified user is following (otherwise known as their "friends").
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/friendships/show
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor]
-        # @overload friends(options = {})
-        #   Returns a cursored collection of user objects for every user the authenticated user is following (otherwise known as their "friends").
-        #
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. This is recommended for users who are following many users. Provide a value of -1 to begin paging. Provide values as returned in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.
-        #   @option options [Boolean, String, Integer] :skip_status Do not include contributee's Tweets when set to true, 't' or 1.
-        #   @option options [Boolean, String, Integer] :include_user_entities The user entities node will be disincluded when set to false.
-        # @overload friends(user, options = {})
-        #   Returns a cursored collection of user objects for every user the specified user is following (otherwise known as their "friends").
-        #
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        #   @option options [Boolean, String, Integer] :skip_status Do not include contributee's Tweets when set to true, 't' or 1.
-        #   @option options [Boolean, String, Integer] :include_user_entities The user entities node will be disincluded when set to false.
-        def friends(*args)
-          cursor_from_response_with_user(:users, Twitter::User, :get, '/1.1/friends/list.json', args)
-        end
-        alias_method :following, :friends
-
-        # Returns a collection of user IDs that the currently authenticated user does not want to receive retweets from.
-        # @see https://dev.twitter.com/docs/api/1.1/get/friendships/no_retweets/ids
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Array<Integer>]
-        # @param options [Hash] A customizable set of options.
-        def no_retweet_ids(options = {})
-          get('/1.1/friendships/no_retweets/ids.json', options)[:body].collect(&:to_i)
-        end
-        alias_method :no_retweets_ids, :no_retweet_ids
-      end
-    end
-  end
-end

data/lib/twitter/rest/api/help.rb

@@ -1,58 +0,0 @@
-require 'twitter/configuration'
-require 'twitter/language'
-require 'twitter/request'
-require 'twitter/rest/api/utils'
-
-module Twitter
-  module REST
-    module API
-      module Help
-        include Twitter::REST::API::Utils
-
-        # Returns the current configuration used by Twitter
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/help/configuration
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Configuration] Twitter's configuration.
-        def configuration(options = {})
-          perform_with_object(:get, '/1.1/help/configuration.json', options, Twitter::Configuration)
-        end
-
-        # Returns the list of languages supported by Twitter
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/help/languages
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Array<Twitter::Language>]
-        def languages(options = {})
-          perform_with_objects(:get, '/1.1/help/languages.json', options, Twitter::Language)
-        end
-
-        # Returns {https://twitter.com/privacy Twitter's Privacy Policy}
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/help/privacy
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [String]
-        def privacy(options = {})
-          get('/1.1/help/privacy.json', options)[:body][:privacy]
-        end
-
-        # Returns {https://twitter.com/tos Twitter's Terms of Service}
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/help/tos
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [String]
-        def tos(options = {})
-          get('/1.1/help/tos.json', options)[:body][:tos]
-        end
-      end
-    end
-  end
-end

data/lib/twitter/rest/api/lists.rb

@@ -1,500 +0,0 @@
-require 'twitter/arguments'
-require 'twitter/cursor'
-require 'twitter/error/forbidden'
-require 'twitter/error/not_found'
-require 'twitter/list'
-require 'twitter/request'
-require 'twitter/rest/api/utils'
-require 'twitter/tweet'
-require 'twitter/user'
-require 'twitter/utils'
-
-module Twitter
-  module REST
-    module API
-      module Lists
-        include Twitter::REST::API::Utils
-        include Twitter::Utils
-        MAX_USERS_PER_REQUEST = 100
-        URI_SUBSTRING = '://'
-
-        # Returns all lists the authenticating or specified user subscribes to, including their own
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/list
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Array<Twitter::List>]
-        # @overload lists(options = {})
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Boolean] :reverse Set this to true if you would like owned lists to be returned first.
-        # @overload lists(user, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Boolean] :reverse Set this to true if you would like owned lists to be returned first.
-        def lists(*args)
-          objects_from_response_with_user(Twitter::List, :get, '/1.1/lists/list.json', args)
-        end
-        alias_method :lists_subscribed_to, :lists
-
-        # Show tweet timeline for members of the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/statuses
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Array<Twitter::Tweet>]
-        # @overload list_timeline(list, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
-        #   @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
-        #   @option options [Integer] :count The number of results to retrieve.
-        # @overload list_timeline(user, list, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
-        #   @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
-        #   @option options [Integer] :count The number of results to retrieve.
-        def list_timeline(*args)
-          arguments = Twitter::Arguments.new(args)
-          merge_list!(arguments.options, arguments.pop)
-          merge_owner!(arguments.options, arguments.pop)
-          perform_with_objects(:get, '/1.1/lists/statuses.json', arguments.options, Twitter::Tweet)
-        end
-
-        # Removes the specified member from the list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/destroy
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The list.
-        # @overload remove_list_member(list, user_to_remove, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param user_to_remove [Integer, String] The user id or screen name of the list member to remove.
-        #   @param options [Hash] A customizable set of options.
-        # @overload remove_list_member(user, list, user_to_remove, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param user_to_remove [Integer, String] The user id or screen name of the list member to remove.
-        #   @param options [Hash] A customizable set of options.
-        def remove_list_member(*args)
-          list_from_response_with_user(:post, '/1.1/lists/members/destroy.json', args)
-        end
-        deprecate_alias :list_remove_member, :remove_list_member
-
-        # List the lists the specified user has been added to
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/memberships
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor]
-        # @overload memberships(options = {})
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        #   @option options [Boolean, String, Integer] :filter_to_owned_lists When set to true, t or 1, will return just lists the authenticating user owns, and the user represented by user_id or screen_name is a member of.
-        # @overload memberships(user, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        #   @option options [Boolean, String, Integer] :filter_to_owned_lists When set to true, t or 1, will return just lists the authenticating user owns, and the user represented by user_id or screen_name is a member of.
-        def memberships(*args)
-          cursor_from_response_with_user(:lists, Twitter::List, :get, '/1.1/lists/memberships.json', args)
-        end
-
-        # Returns the subscribers of the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/subscribers
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor] The subscribers of the specified list.
-        # @overload list_subscribers(list, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        # @overload list_subscribers(user, list, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        def list_subscribers(*args)
-          cursor_from_response_with_list(:get, '/1.1/lists/subscribers.json', args)
-        end
-
-        # Make the authenticated user follow the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/lists/subscribers/create
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The specified list.
-        # @overload list_subscribe(list, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        # @overload list_subscribe(user, list, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        def list_subscribe(*args)
-          list_from_response(:post, '/1.1/lists/subscribers/create.json', args)
-        end
-
-        # Check if a user is a subscriber of the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/subscribers/show
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Boolean] true if user is a subscriber of the specified list, otherwise false.
-        # @overload list_subscriber?(list, user_to_check, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param user_to_check [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        # @overload list_subscriber?(user, list, user_to_check, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param user_to_check [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        # @return [Boolean] true if user is a subscriber of the specified list, otherwise false.
-        def list_subscriber?(*args)
-          list_user?(:get, '/1.1/lists/subscribers/show.json', args)
-        end
-
-        # Unsubscribes the authenticated user form the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/lists/subscribers/destroy
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The specified list.
-        # @overload list_unsubscribe(list, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        # @overload list_unsubscribe(user, list, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        def list_unsubscribe(*args)
-          list_from_response(:post, '/1.1/lists/subscribers/destroy.json', args)
-        end
-
-        # Adds specified members to a list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/create_all
-        # @note Lists are limited to having 500 members, and you are limited to adding up to 100 members to a list at a time with this method.
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The list.
-        # @overload add_list_members(list, users, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        #   @param options [Hash] A customizable set of options.
-        # @overload add_list_members(user, list, users, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        #   @param options [Hash] A customizable set of options.
-        def add_list_members(*args)
-          list_from_response_with_users(:post, '/1.1/lists/members/create_all.json', args)
-        end
-        deprecate_alias :list_add_members, :add_list_members
-
-        # Check if a user is a member of the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/members/show
-        # @authentication Requires user context
-        # @rate_limited Yes
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Boolean] true if user is a member of the specified list, otherwise false.
-        # @overload list_member?(list, user_to_check, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param user_to_check [Integer, String] The user ID or screen name of the list member.
-        #   @param options [Hash] A customizable set of options.
-        # @overload list_member?(user, list, user_to_check, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param user_to_check [Integer, String] The user ID or screen name of the list member.
-        #   @param options [Hash] A customizable set of options.
-        def list_member?(*args)
-          list_user?(:get, '/1.1/lists/members/show.json', args)
-        end
-
-        # Returns the members of the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/members
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor]
-        # @overload list_members(list, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        # @overload list_members(user, list, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        def list_members(*args)
-          cursor_from_response_with_list(:get, '/1.1/lists/members.json', args)
-        end
-
-        # Add a member to a list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/create
-        # @note Lists are limited to having 500 members.
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The list.
-        # @overload add_list_member(list, user_to_add, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param user_to_add [Integer, String] The user id or screen name to add to the list.
-        #   @param options [Hash] A customizable set of options.
-        # @overload add_list_member(user, list, user_to_add, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param user_to_add [Integer, String] The user id or screen name to add to the list.
-        #   @param options [Hash] A customizable set of options.
-        def add_list_member(*args)
-          list_from_response_with_user(:post, '/1.1/lists/members/create.json', args)
-        end
-        deprecate_alias :list_add_member, :add_list_member
-
-        # Deletes the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/lists/destroy
-        # @note Must be owned by the authenticated user.
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The deleted list.
-        # @overload destroy_list(list, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        # @overload destroy_list(user, list, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        def destroy_list(*args)
-          list_from_response(:post, '/1.1/lists/destroy.json', args)
-        end
-        deprecate_alias :list_destroy, :destroy_list
-
-        # Updates the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/lists/update
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The created list.
-        # @overload list_update(list, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [String] :mode ('public') Whether your list is public or private. Values can be 'public' or 'private'.
-        #   @option options [String] :description The description to give the list.
-        # @overload list_update(user, list, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [String] :mode ('public') Whether your list is public or private. Values can be 'public' or 'private'.
-        #   @option options [String] :description The description to give the list.
-        def list_update(*args)
-          list_from_response(:post, '/1.1/lists/update.json', args)
-        end
-
-        # Creates a new list for the authenticated user
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/lists/create
-        # @note Accounts are limited to 20 lists.
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The created list.
-        # @param name [String] The name for the list.
-        # @param options [Hash] A customizable set of options.
-        # @option options [String] :mode ('public') Whether your list is public or private. Values can be 'public' or 'private'.
-        # @option options [String] :description The description to give the list.
-        def create_list(name, options = {})
-          perform_with_object(:post, '/1.1/lists/create.json', options.merge(:name => name), Twitter::List)
-        end
-        deprecate_alias :list_create, :create_list
-
-        # Show the specified list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/show
-        # @note Private lists will only be shown if the authenticated user owns the specified list.
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The specified list.
-        # @overload list(list, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        # @overload list(user, list, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        def list(*args)
-          list_from_response(:get, '/1.1/lists/show.json', args)
-        end
-
-        # List the lists the specified user follows
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/subscriptions
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::Cursor]
-        # @overload subscriptions(options = {})
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        # @overload subscriptions(user, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :cursor (-1) Breaks the results into pages. Provide values as returned in the response objects's next_cursor and previous_cursor attributes to page back and forth in the list.
-        def subscriptions(*args)
-          cursor_from_response_with_user(:lists, Twitter::List, :get, '/1.1/lists/subscriptions.json', args)
-        end
-
-        # Removes specified members from the list
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/destroy_all
-        # @rate_limited No
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Twitter::List] The list.
-        # @overload remove_list_members(list, users, options = {})
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        #   @param options [Hash] A customizable set of options.
-        # @overload remove_list_members(user, list, users, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, URI, or object.
-        #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
-        #   @param options [Hash] A customizable set of options.
-        def remove_list_members(*args)
-          list_from_response_with_users(:post, '/1.1/lists/members/destroy_all.json', args)
-        end
-        deprecate_alias :list_remove_members, :remove_list_members
-
-        # Returns the lists owned by the specified Twitter user
-        #
-        # @see https://dev.twitter.com/docs/api/1.1/get/lists/ownerships
-        # @rate_limited Yes
-        # @authentication Requires user context
-        # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-        # @return [Array<Twitter::List>]
-        # @overload owned_lists(options = {})
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :count The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
-        # @overload owned_lists(user, options = {})
-        #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
-        #   @param options [Hash] A customizable set of options.
-        #   @option options [Integer] :count The amount of results to return per page. Defaults to 20. No more than 1000 results will ever be returned in a single page.
-        def owned_lists(*args)
-          cursor_from_response_with_user(:lists, Twitter::List, :get, '/1.1/lists/ownerships.json', args)
-        end
-        deprecate_alias :lists_ownerships, :owned_lists
-        deprecate_alias :lists_owned, :owned_lists
-
-      private
-
-        # @param request_method [Symbol]
-        # @param path [String]
-        # @param args [Array]
-        # @return [Array<Twitter::User>]
-        def list_from_response(request_method, path, args)
-          arguments = Twitter::Arguments.new(args)
-          merge_list!(arguments.options, arguments.pop)
-          merge_owner!(arguments.options, arguments.pop)
-          perform_with_object(request_method, path, arguments.options, Twitter::List)
-        end
-
-        def cursor_from_response_with_list(request_method, path, args)
-          arguments = Twitter::Arguments.new(args)
-          merge_list!(arguments.options, arguments.pop)
-          merge_owner!(arguments.options, arguments.pop)
-          perform_with_cursor(request_method, path, arguments.options, :users, Twitter::User)
-        end
-
-        def list_user?(request_method, path, args)
-          arguments = Twitter::Arguments.new(args)
-          merge_user!(arguments.options, arguments.pop)
-          merge_list!(arguments.options, arguments.pop)
-          merge_owner!(arguments.options, arguments.pop)
-          send(request_method.to_sym, path, arguments.options)
-          true
-        rescue Twitter::Error::NotFound, Twitter::Error::Forbidden
-          false
-        end
-
-        def list_from_response_with_user(request_method, path, args)
-          arguments = Twitter::Arguments.new(args)
-          merge_user!(arguments.options, arguments.pop)
-          merge_list!(arguments.options, arguments.pop)
-          merge_owner!(arguments.options, arguments.pop)
-          perform_with_object(request_method, path, arguments.options, Twitter::List)
-        end
-
-        def list_from_response_with_users(request_method, path, args)
-          arguments = args.dup
-          options = arguments.last.is_a?(::Hash) ? arguments.pop : {}
-          members = arguments.pop
-          merge_list!(options, arguments.pop)
-          merge_owner!(options, arguments.pop)
-          parallel_map(members.flatten.each_slice(MAX_USERS_PER_REQUEST)) do |users|
-            perform_with_object(request_method, path, merge_users(options, users), Twitter::List)
-          end.last
-        end
-
-        # Take a list and merge it into the hash with the correct key
-        #
-        # @param hash [Hash]
-        # @param list [Integer, String, URI, Twitter::List] A Twitter list ID, slug, URI, or object.
-        # @return [Hash]
-        def merge_list!(hash, list) # rubocop:disable MethodLength
-          case list
-          when Integer
-            hash[:list_id] = list
-          when String
-            if list[URI_SUBSTRING]
-              list = list.split('/')
-              hash[:slug] = list.pop
-              hash[:owner_screen_name] = list.pop
-            else
-              hash[:slug] = list
-            end
-          when URI
-            list = list.path.split('/')
-            hash[:slug] = list.pop
-            hash[:owner_screen_name] = list.pop
-          when Twitter::List
-            hash[:list_id] = list.id
-            merge_owner!(hash, list.user)
-          end
-          hash
-        end
-
-        # Take an owner 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, or object.
-        # @return [Hash]
-        def merge_owner!(hash, user)
-          unless hash[:owner_id] || hash[:owner_screen_name]
-            user ||= screen_name
-            merge_user!(hash, user, 'owner')
-            hash[:owner_id] = hash.delete(:owner_user_id) unless hash[:owner_user_id].nil?
-          end
-          hash
-        end
-      end
-    end
-  end
-end