twitter 4.8.1 → 5.0.0.rc.1

data/lib/twitter/action/favorite.rb

@@ -1,19 +0,0 @@
-require 'twitter/action/tweet'
-
-module Twitter
-  module Action
-    class Favorite < Twitter::Action::Tweet
-      attr_reader :target_objects
-
-      # A collection containing the favorited tweet
-      #
-      # @return [Array<Twitter::Tweet>]
-      def targets
-        @targets = Array(@attrs[:targets]).map do |tweet|
-          Twitter::Tweet.fetch_or_new(tweet)
-        end
-      end
-
-    end
-  end
-end

data/lib/twitter/action/follow.rb

@@ -1,30 +0,0 @@
-require 'twitter/base'
-require 'twitter/creatable'
-
-module Twitter
-  module Action
-    class Follow < Twitter::Base
-      include Twitter::Creatable
-      attr_reader :max_position, :min_position, :target_objects
-
-      # A collection of users who followed a user
-      #
-      # @return [Array<Twitter::User>]
-      def sources
-        @sources = Array(@attrs[:sources]).map do |user|
-          Twitter::User.fetch_or_new(user)
-        end
-      end
-
-      # A collection containing the followed user
-      #
-      # @return [Array<Twitter::User>]
-      def targets
-        @targets = Array(@attrs[:targets]).map do |user|
-          Twitter::User.fetch_or_new(user)
-        end
-      end
-
-    end
-  end
-end

data/lib/twitter/action/list_member_added.rb

@@ -1,39 +0,0 @@
-require 'twitter/base'
-require 'twitter/creatable'
-
-module Twitter
-  module Action
-    class ListMemberAdded < Twitter::Base
-      include Twitter::Creatable
-      attr_reader :max_position, :min_position
-
-      # A collection of users who added a user to a list
-      #
-      # @return [Array<Twitter::User>]
-      def sources
-        @sources = Array(@attrs[:sources]).map do |user|
-          Twitter::User.fetch_or_new(user)
-        end
-      end
-
-      # A collection of lists that were added to
-      #
-      # @return [Array<Twitter::List>]
-      def target_objects
-        @target_objects = Array(@attrs[:target_objects]).map do |list|
-          Twitter::List.fetch_or_new(list)
-        end
-      end
-
-      # A collection of users who were added to a list
-      #
-      # @return [Array<Twitter::User>]
-      def targets
-        @targets = Array(@attrs[:targets]).map do |user|
-          Twitter::User.fetch_or_new(user)
-        end
-      end
-
-    end
-  end
-end

data/lib/twitter/action/mention.rb

@@ -1,46 +0,0 @@
-require 'twitter/base'
-require 'twitter/creatable'
-
-module Twitter
-  module Action
-    class Mention < Twitter::Base
-      include Twitter::Creatable
-      attr_reader :max_position, :min_position
-
-      # A collection of users who mentioned a user
-      #
-      # @return [Array<Twitter::User>]
-      def sources
-        @sources = Array(@attrs[:sources]).map do |user|
-          Twitter::User.fetch_or_new(user)
-        end
-      end
-
-      # The user who mentioned a user
-      #
-      # @return [Twitter::User]
-      def source
-        @source = sources.first
-      end
-
-      # A collection of tweets that mention a user
-      #
-      # @return [Array<Twitter::Tweet>]
-      def target_objects
-        @target_objects = Array(@attrs[:target_objects]).map do |tweet|
-          Twitter::Tweet.fetch_or_new(tweet)
-        end
-      end
-
-      # A collection containing the mentioned user
-      #
-      # @return [Array<Twitter::User>]
-      def targets
-        @targets = Array(@attrs[:targets]).map do |user|
-          Twitter::User.fetch_or_new(user)
-        end
-      end
-
-    end
-  end
-end

data/lib/twitter/action/reply.rb

@@ -1,27 +0,0 @@
-require 'twitter/action/tweet'
-
-module Twitter
-  module Action
-    class Reply < Twitter::Action::Tweet
-
-      # A collection of tweets that reply to a user
-      #
-      # @return [Array<Twitter::Tweet>]
-      def target_objects
-        @target_objects = Array(@attrs[:target_objects]).map do |tweet|
-          Twitter::Tweet.fetch_or_new(tweet)
-        end
-      end
-
-      # A collection that contains the replied-to tweets
-      #
-      # @return [Array<Twitter::Tweet>]
-      def targets
-        @targets = Array(@attrs[:targets]).map do |tweet|
-          Twitter::Tweet.fetch_or_new(tweet)
-        end
-      end
-
-    end
-  end
-end

data/lib/twitter/action/retweet.rb

@@ -1,27 +0,0 @@
-require 'twitter/action/tweet'
-
-module Twitter
-  module Action
-    class Retweet < Twitter::Action::Tweet
-
-      # A collection of retweets
-      #
-      # @return [Array<Twitter::Tweet>]
-      def target_objects
-        @target_objects = Array(@attrs[:target_objects]).map do |tweet|
-          Twitter::Tweet.fetch_or_new(tweet)
-        end
-      end
-
-      # A collection containing the retweeted user
-      #
-      # @return [Array<Twitter::User>]
-      def targets
-        @targets = Array(@attrs[:targets]).map do |user|
-          Twitter::User.fetch_or_new(user)
-        end
-      end
-
-    end
-  end
-end

data/lib/twitter/action/tweet.rb

@@ -1,20 +0,0 @@
-require 'twitter/base'
-require 'twitter/creatable'
-
-module Twitter
-  module Action
-    class Tweet < Twitter::Base
-      include Twitter::Creatable
-      attr_reader :max_position, :min_position
-
-      # @return [Array<Twitter::User>]
-      def sources
-        @sources = Array(@attrs[:sources]).map do |user|
-          Twitter::User.fetch_or_new(user)
-        end
-      end
-
-    end
-    Status = Tweet
-  end
-end

data/lib/twitter/action_factory.rb

@@ -1,22 +0,0 @@
-require 'twitter/action/favorite'
-require 'twitter/action/follow'
-require 'twitter/action/list_member_added'
-require 'twitter/action/mention'
-require 'twitter/action/reply'
-require 'twitter/action/retweet'
-require 'twitter/factory'
-
-module Twitter
-  class ActionFactory < Twitter::Factory
-
-    # Instantiates a new action object
-    #
-    # @param attrs [Hash]
-    # @raise [ArgumentError] Error raised when supplied argument is missing an :action key.
-    # @return [Twitter::Action]
-    def self.fetch_or_new(attrs={})
-      super(:action, Twitter::Action, attrs)
-    end
-
-  end
-end

data/lib/twitter/api/arguments.rb

@@ -1,13 +0,0 @@
-module Twitter
-  module API
-    class Arguments < Array
-      attr_reader :options
-
-      def initialize(args)
-        @options = args.last.is_a?(::Hash) ? args.pop : {}
-        super(args)
-      end
-
-    end
-  end
-end

data/lib/twitter/api/direct_messages.rb

@@ -1,148 +0,0 @@
-require 'twitter/api/arguments'
-require 'twitter/api/utils'
-require 'twitter/direct_message'
-require 'twitter/user'
-
-module Twitter
-  module API
-    module DirectMessages
-      include Twitter::API::Utils
-
-      # Returns the 20 most recent direct messages sent to the authenticating user
-      #
-      # @see https://dev.twitter.com/docs/api/1.1/get/direct_messages
-      # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
-      # @rate_limited Yes
-      # @authentication Requires user context
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Array<Twitter::DirectMessage>] Direct messages sent to the authenticating user.
-      # @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 Specifies the number of records to retrieve. Must be less than or equal to 200.
-      # @option options [Integer] :page Specifies the page of results to retrieve.
-      # @example Return the 20 most recent direct messages sent to the authenticating user
-      #   Twitter.direct_messages_received
-      def direct_messages_received(options={})
-        objects_from_response(Twitter::DirectMessage, :get, "/1.1/direct_messages.json", options)
-      end
-
-      # Returns the 20 most recent direct messages sent by the authenticating user
-      #
-      # @see https://dev.twitter.com/docs/api/1.1/get/direct_messages/sent
-      # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
-      # @rate_limited Yes
-      # @authentication Requires user context
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Array<Twitter::DirectMessage>] Direct messages sent by the authenticating user.
-      # @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 Specifies the number of records to retrieve. Must be less than or equal to 200.
-      # @option options [Integer] :page Specifies the page of results to retrieve.
-      # @example Return the 20 most recent direct messages sent by the authenticating user
-      #   Twitter.direct_messages_sent
-      def direct_messages_sent(options={})
-        objects_from_response(Twitter::DirectMessage, :get, "/1.1/direct_messages/sent.json", options)
-      end
-
-      # Returns a direct message
-      #
-      # @see https://dev.twitter.com/docs/api/1.1/get/direct_messages/show
-      # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
-      # @rate_limited Yes
-      # @authentication Requires user context
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Twitter::DirectMessage] The requested messages.
-      # @param id [Integer] A Tweet IDs.
-      # @param options [Hash] A customizable set of options.
-      # @example Return the direct message with the id 1825786345
-      #   Twitter.direct_message(1825786345)
-      def direct_message(id, options={})
-        options[:id] = id
-        object_from_response(Twitter::DirectMessage, :get, "/1.1/direct_messages/show.json", options)
-      end
-
-      # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
-      # @rate_limited Yes
-      # @authentication Requires user context
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Array<Twitter::DirectMessage>] The requested messages.
-      # @overload direct_messages(options={})
-      #   Returns the 20 most recent direct messages sent to the authenticating user
-      #
-      #   @see https://dev.twitter.com/docs/api/1.1/get/direct_messages
-      #   @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 Specifies the number of records to retrieve. Must be less than or equal to 200.
-      #   @option options [Integer] :page Specifies the page of results to retrieve.
-      #   @example Return the 20 most recent direct messages sent to the authenticating user
-      #     Twitter.direct_messages
-      # @overload direct_messages(*ids)
-      #   Returns direct messages
-      #
-      #   @see https://dev.twitter.com/docs/api/1.1/get/direct_messages/show
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @example Return the direct message with the id 1825786345
-      #     Twitter.direct_messages(1825786345)
-      # @overload direct_messages(*ids, options)
-      #   Returns direct messages
-      #
-      #   @see https://dev.twitter.com/docs/api/1.1/get/direct_messages/show
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @param options [Hash] A customizable set of options.
-      def direct_messages(*args)
-        arguments = Twitter::API::Arguments.new(args)
-        if arguments.empty?
-          direct_messages_received(arguments.options)
-        else
-          arguments.flatten.threaded_map do |id|
-            direct_message(id, arguments.options)
-          end
-        end
-      end
-
-      # Destroys direct messages
-      #
-      # @see https://dev.twitter.com/docs/api/1.1/post/direct_messages/destroy
-      # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
-      # @rate_limited No
-      # @authentication Requires user context
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Array<Twitter::DirectMessage>] Deleted direct message.
-      # @overload direct_message_destroy(*ids)
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @example Destroys the direct message with the ID 1825785544
-      #     Twitter.direct_message_destroy(1825785544)
-      # @overload direct_message_destroy(*ids, options)
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @param options [Hash] A customizable set of options.
-      def direct_message_destroy(*args)
-        threaded_object_from_response(Twitter::DirectMessage, :post, "/1.1/direct_messages/destroy.json", args)
-      end
-
-      # Sends a new direct message to the specified user from the authenticating user
-      #
-      # @see https://dev.twitter.com/docs/api/1.1/post/direct_messages/new
-      # @rate_limited No
-      # @authentication Requires user context
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Twitter::DirectMessage] The sent message.
-      # @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
-      # @param text [String] The text of your direct message, up to 140 characters.
-      # @param options [Hash] A customizable set of options.
-      # @example Send a direct message to @sferik from the authenticating user
-      #   Twitter.direct_message_create('sferik', "I'm sending you this message via @gem!")
-      #   Twitter.direct_message_create(7505382, "I'm sending you this message via @gem!")  # Same as above
-      def direct_message_create(user, text, options={})
-        merge_user!(options, user)
-        options[:text] = text
-        object_from_response(Twitter::DirectMessage, :post, "/1.1/direct_messages/new.json", options)
-      end
-      alias d direct_message_create
-      alias m direct_message_create
-
-    end
-  end
-end

data/lib/twitter/api/favorites.rb

@@ -1,126 +0,0 @@
-require 'twitter/api/arguments'
-require 'twitter/api/utils'
-require 'twitter/error/already_favorited'
-require 'twitter/error/forbidden'
-require 'twitter/tweet'
-require 'twitter/user'
-
-module Twitter
-  module API
-    module Favorites
-      include Twitter::API::Utils
-
-      # @see https://dev.twitter.com/docs/api/1.1/get/favorites/list
-      # @rate_limited Yes
-      # @authentication Requires user context
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Array<Twitter::Tweet>] favorite Tweets.
-      # @overload favorites(options={})
-      #   Returns the 20 most recent favorite Tweets for the authenticating user
-      #
-      #   @param options [Hash] A customizable set of options.
-      #   @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 100.
-      #   @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
-      #   @example Return the 20 most recent favorite Tweets for the authenticating user
-      #     Twitter.favorites
-      # @overload favorites(user, options={})
-      #   Returns the 20 most recent favorite Tweets for 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] :count Specifies the number of records to retrieve. Must be less than or equal to 100.
-      #   @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
-      #   @example Return the 20 most recent favorite Tweets for @sferik
-      #     Twitter.favorites('sferik')
-      def favorites(*args)
-        arguments = Twitter::API::Arguments.new(args)
-        if user = arguments.pop
-          merge_user!(arguments.options, user)
-        end
-        objects_from_response(Twitter::Tweet, :get, "/1.1/favorites/list.json", arguments.options)
-      end
-      alias favourites favorites
-
-      # Un-favorites the specified Tweets as the authenticating user
-      #
-      # @see https://dev.twitter.com/docs/api/1.1/post/favorites/destroy
-      # @rate_limited No
-      # @authentication Requires user context
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Array<Twitter::Tweet>] The un-favorited Tweets.
-      # @overload unfavorite(*ids)
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @example Un-favorite the tweet with the ID 25938088801
-      #     Twitter.unfavorite(25938088801)
-      # @overload unfavorite(*ids, options)
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @param options [Hash] A customizable set of options.
-      def unfavorite(*args)
-        threaded_object_from_response(Twitter::Tweet, :post, "/1.1/favorites/destroy.json", args)
-      end
-      alias favorite_destroy unfavorite
-      alias favourite_destroy unfavorite
-      alias unfavourite unfavorite
-
-      # Favorites the specified Tweets as the authenticating user
-      #
-      # @see https://dev.twitter.com/docs/api/1.1/post/favorites/create
-      # @rate_limited No
-      # @authentication Requires user context
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Array<Twitter::Tweet>] The favorited Tweets.
-      # @overload favorite(*ids)
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @example Favorite the Tweet with the ID 25938088801
-      #     Twitter.favorite(25938088801)
-      # @overload favorite(*ids, options)
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @param options [Hash] A customizable set of options.
-      def favorite(*args)
-        arguments = Twitter::API::Arguments.new(args)
-        arguments.flatten.threaded_map do |id|
-          begin
-            object_from_response(Twitter::Tweet, :post, "/1.1/favorites/create.json", arguments.options.merge(:id => id))
-          rescue Twitter::Error::Forbidden => error
-            raise unless error.message == Twitter::Error::AlreadyFavorited::MESSAGE
-          end
-        end.compact
-      end
-      alias fav favorite
-      alias fave favorite
-      alias favorite_create favorite
-      alias favourite_create favorite
-
-      # Favorites the specified Tweets as the authenticating user and raises an error if one has already been favorited
-      #
-      # @see https://dev.twitter.com/docs/api/1.1/post/favorites/create
-      # @rate_limited No
-      # @authentication Requires user context
-      # @raise [Twitter::Error::AlreadyFavorited] Error raised when tweet has already been favorited.
-      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Array<Twitter::Tweet>] The favorited Tweets.
-      # @overload favorite(*ids)
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @example Favorite the Tweet with the ID 25938088801
-      #     Twitter.favorite(25938088801)
-      # @overload favorite(*ids, options)
-      #   @param ids [Array<Integer>, Set<Integer>] An array of Tweet IDs.
-      #   @param options [Hash] A customizable set of options.
-      def favorite!(*args)
-        arguments = Twitter::API::Arguments.new(args)
-        arguments.flatten.threaded_map do |id|
-          begin
-            object_from_response(Twitter::Tweet, :post, "/1.1/favorites/create.json", arguments.options.merge(:id => id))
-          rescue Twitter::Error::Forbidden => error
-            handle_forbidden_error(Twitter::Error::AlreadyFavorited, error)
-          end
-        end
-      end
-      alias fav! favorite!
-      alias fave! favorite!
-      alias favorite_create! favorite!
-      alias favourite_create! favorite!
-
-    end
-  end
-end