twitter 4.8.1 → 5.0.0.rc.1

data/lib/twitter/api/friends_and_followers.rb

@@ -1,334 +0,0 @@
-require 'twitter/api/arguments'
-require 'twitter/api/utils'
-require 'twitter/cursor'
-require 'twitter/error/forbidden'
-require 'twitter/relationship'
-require 'twitter/user'
-
-module Twitter
-  module API
-    module FriendsAndFollowers
-      include Twitter::API::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.
-      #   @example Return the authenticated user's friends' IDs
-      #     Twitter.friend_ids
-      # @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, 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.
-      #   @example Return @sferik's friends' IDs
-      #     Twitter.friend_ids('sferik')
-      #     Twitter.friend_ids(7505382)  # Same as above
-      def friend_ids(*args)
-        cursor_from_response_with_user(:ids, nil, :get, "/1.1/friends/ids.json", args, :friend_ids)
-      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.
-      #   @example Return the authenticated user's followers' IDs
-      #     Twitter.follower_ids
-      # @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, 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.
-      #   @example Return @sferik's followers' IDs
-      #     Twitter.follower_ids('sferik')
-      #     Twitter.follower_ids(7505382)  # Same as above
-      def follower_ids(*args)
-        cursor_from_response_with_user(:ids, nil, :get, "/1.1/followers/ids.json", args, :follower_ids)
-      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 [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @example Return extended information for @sferik and @pengwynn
-      #     Twitter.friendships('sferik', 'pengwynn')
-      #     Twitter.friendships('sferik', 14100886)   # Same as above
-      #     Twitter.friendships(7505382, 14100886)    # Same as above
-      # @overload friendships(*users, options)
-      #   @param users [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @param options [Hash] A customizable set of options.
-      def friendships(*args)
-        arguments = Twitter::API::Arguments.new(args)
-        merge_users!(arguments.options, arguments)
-        objects_from_response(Twitter::User, :get, "/1.1/friendships/lookup.json", arguments.options)
-      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.
-      # @example Return an array of numeric IDs for every user who has a pending request to follow the authenticating user
-      #   Twitter.friendships_incoming
-      def friendships_incoming(options={})
-        cursor_from_response(:ids, nil, :get, "/1.1/friendships/incoming.json", options, :friendships_incoming)
-      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.
-      # @example Return an array of numeric IDs for every protected user for whom the authenticating user has a pending follow request
-      #   Twitter.friendships_outgoing
-      def friendships_outgoing(options={})
-        cursor_from_response(:ids, nil, :get, "/1.1/friendships/outgoing.json", options, :friendships_outgoing)
-      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 [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @example Follow @sferik
-      #     Twitter.follow('sferik')
-      # @overload follow(*users, options)
-      #   @param users [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array 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::API::Arguments.new(args)
-        # Twitter always turns on notifications if the "follow" option is present, even if it's set to false
-        # so only send follow if it's true
-        arguments.options[:follow] = true if !!arguments.options.delete(:follow)
-        existing_friends = Thread.new do
-          friend_ids.ids
-        end
-        new_friends = Thread.new do
-          users(args).map(&:id)
-        end
-        follow!(new_friends.value - existing_friends.value, arguments.options)
-      end
-      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 [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @example Follow @sferik
-      #     Twitter.follow!('sferik')
-      # @overload follow!(*users, options)
-      #   @param users [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array 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::API::Arguments.new(args)
-        # Twitter always turns on notifications if the "follow" option is present, even if it's set to false
-        # so only send follow if it's true
-        arguments.options[:follow] = true if !!arguments.options.delete(:follow)
-        arguments.flatten.threaded_map do |user|
-          begin
-            object_from_response(Twitter::User, :post, "/1.1/friendships/create.json", merge_user(arguments.options, user))
-          rescue Twitter::Error::Forbidden
-            # This error will be raised if the user doesn't have permission to
-            # follow list_member, for whatever reason.
-          end
-        end.compact
-      end
-      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 [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @example Unfollow @sferik
-      #     Twitter.unfollow('sferik')
-      # @overload unfollow(*users, options)
-      #   @param users [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @param options [Hash] A customizable set of options.
-      def unfollow(*args)
-        threaded_user_objects_from_response(:post, "/1.1/friendships/destroy.json", args)
-      end
-      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, 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.
-      # @example Enable rewteets and devise notifications for @sferik
-      #   Twitter.friendship_update('sferik', :device => true, :retweets => true)
-      def friendship_update(user, options={})
-        merge_user!(options, user)
-        object_from_response(Twitter::Relationship, :post, "/1.1/friendships/update.json", options)
-      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.
-      # @example Return the relationship between @sferik and @pengwynn
-      #   Twitter.friendship('sferik', 'pengwynn')
-      #   Twitter.friendship('sferik', 14100886)   # Same as above
-      #   Twitter.friendship(7505382, 14100886)    # Same as above
-      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?
-        object_from_response(Twitter::Relationship, :get, "/1.1/friendships/show.json", options)
-      end
-      alias friendship_show friendship
-      alias 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.
-      # @example Return true if @sferik follows @pengwynn
-      #   Twitter.friendship?('sferik', 'pengwynn')
-      #   Twitter.friendship?('sferik', 14100886)   # Same as above
-      #   Twitter.friendship?(7505382, 14100886)    # Same as above
-      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.
-      #   @example Return the authenticated user's friends' IDs
-      #     Twitter.followers
-      # @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, 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.
-      # @example Return the cursored collection of users following @sferik
-      #   Twitter.followers('sferik')
-      #   Twitter.followers(7505382)    # Same as above
-      def followers(*args)
-        cursor_from_response_with_user(:users, Twitter::User, :get, "/1.1/followers/list.json", args, :followers)
-      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.
-      #   @example Return the authenticated user's friends' IDs
-      #     Twitter.friends
-      # @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, 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.
-      # @example Return the cursored collection of users @sferik is following
-      #   Twitter.friends('sferik')
-      #   Twitter.friends(7505382)    # Same as above
-      def friends(*args)
-        cursor_from_response_with_user(:users, Twitter::User, :get, "/1.1/friends/list.json", args, :friends)
-      end
-      alias 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.
-      # @example Return a collection of user IDs that the currently authenticated user does not want to receive retweets from
-      #   Twitter.no_retweet_ids
-      def no_retweet_ids(options={})
-        get("/1.1/friendships/no_retweets/ids.json", options)[:body].map(&:to_i)
-      end
-      alias no_retweets_ids no_retweet_ids
-
-    end
-  end
-end

data/lib/twitter/api/help.rb

@@ -1,64 +0,0 @@
-require 'twitter/api/utils'
-require 'twitter/configuration'
-require 'twitter/language'
-
-module Twitter
-  module API
-    module Help
-      include Twitter::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.
-      # @example Return the current configuration used by Twitter
-      #   Twitter.configuration
-      def configuration(options={})
-        object_from_response(Twitter::Configuration, :get, "/1.1/help/configuration.json", options)
-      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>]
-      # @example Return the list of languages Twitter supports
-      #   Twitter.languages
-      def languages(options={})
-        objects_from_response(Twitter::Language, :get, "/1.1/help/languages.json", options)
-      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]
-      # @example Return {https://twitter.com/privacy Twitter's Privacy Policy}
-      #   Twitter.privacy
-      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]
-      # @example Return {https://twitter.com/tos Twitter's Terms of Service}
-      #   Twitter.tos
-      def tos(options={})
-        get("/1.1/help/tos.json", options)[:body][:tos]
-      end
-
-    end
-  end
-end

data/lib/twitter/api/lists.rb

@@ -1,618 +0,0 @@
-require 'twitter/api/arguments'
-require 'twitter/api/utils'
-require 'twitter/core_ext/enumerable'
-require 'twitter/cursor'
-require 'twitter/error/forbidden'
-require 'twitter/error/not_found'
-require 'twitter/list'
-require 'twitter/tweet'
-require 'twitter/user'
-
-module Twitter
-  module API
-    module Lists
-      include Twitter::API::Utils
-      MAX_USERS_PER_REQUEST = 100
-
-      # 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.
-      #   @example Return all lists the authenticating user subscribes to
-      #     Twitter.lists
-      # @overload lists(user, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, 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.
-      #   @example Return all lists that @sferik subscribes to
-      #     Twitter.lists('sferik')
-      #     Twitter.lists(7505382)
-      def lists(*args)
-        objects_from_response_with_user(Twitter::List, :get, "/1.1/lists/list.json", args)
-      end
-      alias 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, 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.
-      #   @example Show tweet timeline for members of the authenticated user's "presidents" list
-      #     Twitter.list_timeline('presidents')
-      #     Twitter.list_timeline(8863586)
-      # @overload list_timeline(user, list, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, 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.
-      #   @example Show tweet timeline for members of @sferik's "presidents" list
-      #     Twitter.list_timeline('sferik', 'presidents')
-      #     Twitter.list_timeline('sferik', 8863586)
-      #     Twitter.list_timeline(7505382, 'presidents')
-      #     Twitter.list_timeline(7505382, 8863586)
-      def list_timeline(*args)
-        arguments = Twitter::API::Arguments.new(args)
-        merge_list!(arguments.options, arguments.pop)
-        merge_owner!(arguments.options, arguments.pop)
-        objects_from_response(Twitter::Tweet, :get, "/1.1/lists/statuses.json", arguments.options)
-      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 list_remove_member(list, user_to_remove, options={})
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, 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.
-      #   @example Remove @BarackObama from the authenticated user's "presidents" list
-      #     Twitter.list_remove_member('presidents', 813286)
-      #     Twitter.list_remove_member('presidents', 'BarackObama')
-      #     Twitter.list_remove_member(8863586, 'BarackObama')
-      # @overload list_remove_member(user, list, user_to_remove, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, 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.
-      #   @example Remove @BarackObama from @sferik's "presidents" list
-      #     Twitter.list_remove_member('sferik', 'presidents', 813286)
-      #     Twitter.list_remove_member('sferik', 'presidents', 'BarackObama')
-      #     Twitter.list_remove_member('sferik', 8863586, 'BarackObama')
-      #     Twitter.list_remove_member(7505382, 'presidents', 813286)
-      def list_remove_member(*args)
-        list_from_response_with_user(:post, "/1.1/lists/members/destroy.json", args)
-      end
-
-      # 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.
-      #   @example List the lists the authenticated user has been added to
-      #     Twitter.memberships
-      # @overload memberships(user, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, 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.
-      #   @example List the lists that @sferik has been added to
-      #     Twitter.memberships('sferik')
-      #     Twitter.memberships(7505382)
-      def memberships(*args)
-        cursor_from_response_with_user(:lists, Twitter::List, :get, "/1.1/lists/memberships.json", args, :memberships)
-      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, 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.
-      #   @example Return the subscribers of the authenticated user's "presidents" list
-      #     Twitter.list_subscribers('presidents')
-      #     Twitter.list_subscribers(8863586)
-      # @overload list_subscribers(user, list, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, 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.
-      #   @example Return the subscribers of @sferik's "presidents" list
-      #     Twitter.list_subscribers('sferik', 'presidents')
-      #     Twitter.list_subscribers('sferik', 8863586)
-      #     Twitter.list_subscribers(7505382, 'presidents')
-      def list_subscribers(*args)
-        cursor_from_response_with_list(:get, "/1.1/lists/subscribers.json", args, :list_subscribers)
-      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, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Subscribe to the authenticated user's "presidents" list
-      #     Twitter.list_subscribe('presidents')
-      #     Twitter.list_subscribe(8863586)
-      # @overload list_subscribe(user, list, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Subscribe to @sferik's "presidents" list
-      #     Twitter.list_subscribe('sferik', 'presidents')
-      #     Twitter.list_subscribe('sferik', 8863586)
-      #     Twitter.list_subscribe(7505382, 'presidents')
-      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, or object.
-      #   @param user_to_check [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Check if @BarackObama is a subscriber of the authenticated user's "presidents" list
-      #     Twitter.list_subscriber?('presidents', 813286)
-      #     Twitter.list_subscriber?(8863586, 813286)
-      #     Twitter.list_subscriber?('presidents', 'BarackObama')
-      # @overload list_subscriber?(user, list, user_to_check, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param user_to_check [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Check if @BarackObama is a subscriber of @sferik's "presidents" list
-      #     Twitter.list_subscriber?('sferik', 'presidents', 813286)
-      #     Twitter.list_subscriber?('sferik', 8863586, 813286)
-      #     Twitter.list_subscriber?(7505382, 'presidents', 813286)
-      #     Twitter.list_subscriber?('sferik', 'presidents', 'BarackObama')
-      # @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, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Unsubscribe from the authenticated user's "presidents" list
-      #     Twitter.list_unsubscribe('presidents')
-      #     Twitter.list_unsubscribe(8863586)
-      # @overload list_unsubscribe(user, list, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Unsubscribe from @sferik's "presidents" list
-      #     Twitter.list_unsubscribe('sferik', 'presidents')
-      #     Twitter.list_unsubscribe('sferik', 8863586)
-      #     Twitter.list_unsubscribe(7505382, 'presidents')
-      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 list_add_members(list, users, options={})
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param users [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Add @BarackObama and @pengwynn to the authenticated user's "presidents" list
-      #     Twitter.list_add_members('presidents', ['BarackObama', 'pengwynn'])
-      #     Twitter.list_add_members('presidents', [813286, 18755393])
-      #     Twitter.list_add_members(8863586, ['BarackObama', 'pengwynn'])
-      #     Twitter.list_add_members(8863586, [813286, 18755393])
-      # @overload list_add_members(user, list, users, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param users [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Add @BarackObama and @pengwynn to @sferik's "presidents" list
-      #     Twitter.list_add_members('sferik', 'presidents', ['BarackObama', 'pengwynn'])
-      #     Twitter.list_add_members('sferik', 'presidents', [813286, 18755393])
-      #     Twitter.list_add_members(7505382, 'presidents', ['BarackObama', 'pengwynn'])
-      #     Twitter.list_add_members(7505382, 'presidents', [813286, 18755393])
-      #     Twitter.list_add_members(7505382, 8863586, ['BarackObama', 'pengwynn'])
-      #     Twitter.list_add_members(7505382, 8863586, [813286, 18755393])
-      def list_add_members(*args)
-        list_from_response_with_users(:post, "/1.1/lists/members/create_all.json", args)
-      end
-
-      # 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, 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.
-      #   @example Check if @BarackObama is a member of the authenticated user's "presidents" list
-      #     Twitter.list_member?('presidents', 813286)
-      #     Twitter.list_member?(8863586, 'BarackObama')
-      # @overload list_member?(user, list, user_to_check, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, 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.
-      #   @example Check if @BarackObama is a member of @sferik's "presidents" list
-      #     Twitter.list_member?('sferik', 'presidents', 813286)
-      #     Twitter.list_member?('sferik', 8863586, 'BarackObama')
-      #     Twitter.list_member?(7505382, 'presidents', 813286)
-      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, 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.
-      #   @example Return the members of the authenticated user's "presidents" list
-      #     Twitter.list_members('presidents')
-      #     Twitter.list_members(8863586)
-      # @overload list_members(user, list, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, 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.
-      #   @example Return the members of @sferik's "presidents" list
-      #     Twitter.list_members('sferik', 'presidents')
-      #     Twitter.list_members('sferik', 8863586)
-      #     Twitter.list_members(7505382, 'presidents')
-      #     Twitter.list_members(7505382, 8863586)
-      def list_members(*args)
-        cursor_from_response_with_list(:get, "/1.1/lists/members.json", args, :list_members)
-      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 list_add_member(list, user_to_add, options={})
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, 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.
-      #   @example Add @BarackObama to the authenticated user's "presidents" list
-      #     Twitter.list_add_member('presidents', 813286)
-      #     Twitter.list_add_member(8863586, 813286)
-      # @overload list_add_member(user, list, user_to_add, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, 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.
-      #   @example Add @BarackObama to @sferik's "presidents" list
-      #     Twitter.list_add_member('sferik', 'presidents', 813286)
-      #     Twitter.list_add_member('sferik', 8863586, 813286)
-      #     Twitter.list_add_member(7505382, 'presidents', 813286)
-      #     Twitter.list_add_member(7505382, 8863586, 813286)
-      def list_add_member(*args)
-        list_from_response_with_user(:post, "/1.1/lists/members/create.json", args)
-      end
-
-      # 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 list_destroy(list, options={})
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Delete the authenticated user's "presidents" list
-      #     Twitter.list_destroy('presidents')
-      #     Twitter.list_destroy(8863586)
-      # @overload list_destroy(user, list, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Delete @sferik's "presidents" list
-      #     Twitter.list_destroy('sferik', 'presidents')
-      #     Twitter.list_destroy('sferik', 8863586)
-      #     Twitter.list_destroy(7505382, 'presidents')
-      #     Twitter.list_destroy(7505382, 8863586)
-      def list_destroy(*args)
-        list_from_response(:post, "/1.1/lists/destroy.json", args)
-      end
-
-      # 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, 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.
-      #   @example Update the authenticated user's "presidents" list to have the description "Presidents of the United States of America"
-      #     Twitter.list_update('presidents', :description => "Presidents of the United States of America")
-      #     Twitter.list_update(8863586, :description => "Presidents of the United States of America")
-      # @overload list_update(user, list, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, 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.
-      #   @example Update the @sferik's "presidents" list to have the description "Presidents of the United States of America"
-      #     Twitter.list_update('sferik', 'presidents', :description => "Presidents of the United States of America")
-      #     Twitter.list_update(7505382, 'presidents', :description => "Presidents of the United States of America")
-      #     Twitter.list_update('sferik', 8863586, :description => "Presidents of the United States of America")
-      #     Twitter.list_update(7505382, 8863586, :description => "Presidents of the United States of America")
-      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.
-      # @example Create a list named 'presidents'
-      #   Twitter.list_create('presidents')
-      def list_create(name, options={})
-        object_from_response(Twitter::List, :post, "/1.1/lists/create.json", options.merge(:name => name))
-      end
-
-      # 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, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Show the authenticated user's "presidents" list
-      #     Twitter.list('presidents')
-      #     Twitter.list(8863586)
-      # @overload list(user, list, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Show @sferik's "presidents" list
-      #     Twitter.list('sferik', 'presidents')
-      #     Twitter.list('sferik', 8863586)
-      #     Twitter.list(7505382, 'presidents')
-      #     Twitter.list(7505382, 8863586)
-      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.
-      #   @example List the lists the authenticated user follows
-      #     Twitter.subscriptions
-      # @overload subscriptions(user, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, 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.
-      #   @example List the lists that @sferik follows
-      #     Twitter.subscriptions('sferik')
-      #     Twitter.subscriptions(7505382)
-      def subscriptions(*args)
-        cursor_from_response_with_user(:lists, Twitter::List, :get, "/1.1/lists/subscriptions.json", args, :subscriptions)
-      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 list_remove_members(list, users, options={})
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param users [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Remove @BarackObama and @pengwynn from the authenticated user's "presidents" list
-      #     Twitter.list_remove_members('presidents', ['BarackObama', 'pengwynn'])
-      #     Twitter.list_remove_members('presidents', [813286, 18755393])
-      #     Twitter.list_remove_members(8863586, ['BarackObama', 'pengwynn'])
-      #     Twitter.list_remove_members(8863586, [813286, 18755393])
-      # @overload list_remove_members(user, list, users, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      #   @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      #   @param users [Array<Integer, String, Twitter::User>, Set<Integer, String, Twitter::User>] An array of Twitter user IDs, screen names, or objects.
-      #   @param options [Hash] A customizable set of options.
-      #   @example Remove @BarackObama and @pengwynn from @sferik's "presidents" list
-      #     Twitter.list_remove_members('sferik', 'presidents', ['BarackObama', 'pengwynn'])
-      #     Twitter.list_remove_members('sferik', 'presidents', [813286, 18755393])
-      #     Twitter.list_remove_members(7505382, 'presidents', ['BarackObama', 'pengwynn'])
-      #     Twitter.list_remove_members(7505382, 'presidents', [813286, 18755393])
-      #     Twitter.list_remove_members(7505382, 8863586, ['BarackObama', 'pengwynn'])
-      #     Twitter.list_remove_members(7505382, 8863586, [813286, 18755393])
-      def list_remove_members(*args)
-        list_from_response_with_users(:post, "/1.1/lists/members/destroy_all.json", args)
-      end
-
-      # 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 lists_owned(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.
-      #   @example Return all lists the authenticating user owns
-      #     Twitter.lists_owend
-      # @overload lists_owned(user, options={})
-      #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, 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.
-      #   @example Return all lists that @sferik owns
-      #     Twitter.lists_owned('sferik')
-      #     Twitter.lists_owned(7505382)
-      def lists_owned(*args)
-        cursor_from_response_with_user(:lists, Twitter::List, :get, "/1.1/lists/ownerships.json", args, :lists_owned)
-      end
-      alias lists_ownerships lists_owned
-
-    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::API::Arguments.new(args)
-        merge_list!(arguments.options, arguments.pop)
-        merge_owner!(arguments.options, arguments.pop)
-        object_from_response(Twitter::List, request_method, path, arguments.options)
-      end
-
-      def cursor_from_response_with_list(request_method, path, args, calling_method)
-        arguments = Twitter::API::Arguments.new(args)
-        merge_list!(arguments.options, arguments.pop)
-        merge_owner!(arguments.options, arguments.pop)
-        cursor_from_response(:users, Twitter::User, request_method, path, arguments.options, calling_method)
-      end
-
-      def list_user?(request_method, path, args)
-        arguments = Twitter::API::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::API::Arguments.new(args)
-        merge_user!(arguments.options, arguments.pop)
-        merge_list!(arguments.options, arguments.pop)
-        merge_owner!(arguments.options, arguments.pop)
-        object_from_response(Twitter::List, request_method, path, arguments.options)
-      end
-
-      def list_from_response_with_users(request_method, path, args)
-        arguments = Twitter::API::Arguments.new(args)
-        members = arguments.pop
-        merge_list!(arguments.options, arguments.pop)
-        merge_owner!(arguments.options, arguments.pop)
-        members.flatten.each_slice(MAX_USERS_PER_REQUEST).threaded_map do |users|
-          object_from_response(Twitter::List, request_method, path, merge_users(arguments.options, users))
-        end.last
-      end
-
-      # Take a list and merge it into the hash with the correct key
-      #
-      # @param hash [Hash]
-      # @param list [Integer, String, Twitter::List] A Twitter list ID, slug, or object.
-      # @return [Hash]
-      def merge_list!(hash, list)
-        case list
-        when Integer
-          hash[:list_id] = list
-        when String
-          hash[:slug] = list
-        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